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От автора 


Для кого и о чем эта книга 


Книга посвящена новой версии системы визуального объектно-ориентирован- 
ного программирования C++Builder. Версия C++Builder 5 — превосходный инст- 
румент, с помощью которого и начинающий пользователь, и программист-профес- 
сионал могут создавать одинаково профессионально выглядящий интерфейс поль- 
зователя к прикладным программам самых различных классов. Кроме того 
C++Builder позволяет работать с любыми базами данных, создавать прикладные 
программы для работы с Интернет и многое-многое другое. Так что недаром эта 
система пользуется широкой популярностью. 

Впрочем, пока популярность C++Builder уступает популярности его родной 
сестры Delphi — разработанной той же фирмой Borland. Но мне кажется, что это 
явление временное. Язык С++, лежащий в основе C++Builder, более мощный, чем 
Object Pascal, на котором построена Delphi. И библиотеки функций С++ намного 
обширнее библиотек Object Pascal. Поэтому то, что в C++Builder делается легко и 
естественно, в Delphi в ряде случаев требует значительно больших усилий и полу- 
чается не столь эффективно. Правда, это касается только весьма сложных прило- 
жений. Большинство же прикладных задач с равным успехом могут решаться и 
средствами Delphi, и средствами C++Builder. 

Меньшая популярность C++Builder по сравнению с Delphi объясняется, на 
мой взгляд, большей сложностью (неизбежной при большой мощности) языка 
C++. Но думаю, что это временное препятствие. Уже сейчас в ряде вузов начинают 
изучать С и C++ вместо традиционного языка Pascal. Так что для нового поколе- 
ния разработчиков C++Builder может оказаться более естественным, чем Delphi. 
Да и наиболее серьезные разработчики старшего поколения тоже на ты с С++. Все 
это вселяет надежду, что в недалеком будущем популярность C++Builder догонит, 
а может быть и обгонит популярность Delphi. 

При написании данной книги я старался сделать ее полезной для читателей 
различных категорий — от начинающих (но, все-таки, хотя бы поверхностно зна- 
комых с каким-нибудь языком программирования) до опытных профессионалов. 
Поэтому я отказался от стиля учебника с его последовательным изложением мате- 
риала от простого к сложному. Каждая глава книги является законченным изло- 
жением того или иного вопроса. Я с уважением отношусь к своим потенциальным 
читателям и считаю, что они сами смогут регулировать последовательность и темп 
своего изучения C++Builder или своей работы с этой системой. К, тому же, я уве- 
рен, что овладеть какой-то системой можно только работая с ней, решая какую-то 
свою (не учебную) конкретную задачу. И последовательность изучения тех или 
иных вопросов определяется требованиями этой конкретной задачи. Поэтому я 
считал основной задачей данной книги — дать побольше конкретной информации 
по всем затронутым в ней вопросам и расположить эту информацию в такой после- 
довательности, чтобы ее легко было отыскать. Тогда и начинающий, и опытный 
пользователь сможет в любой момент найти то, что ему нужно сейчас для работы. 
Надо отметить, что опытному пользователю тоже нужна подобная книга, посколь- 
ку никто не в состоянии держать в голове все сведение по многим десяткам компо- 
HeHTOB C++Builder, по синтаксису и параметрам тех или иных функций и проце- 
дур языка программирования. 

При написании этой книги я пытался дать читателю как можно больше кон- 
кретной информации. Насколько это удалось — судить читателю. А я пытался ре- 
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шить эту задачу следующим образом. Во-первых, изложение в книге предельно 
сжатое, без лирических отступлений. Во-вторых, наряду со связным изложением 
отдельных вопросов в книге имеется большая справочная часть, содержащая кон- 
кретную информацию по функциям и языку С++, по свойствам, методам, событи- 
ям компонентов. Это позволило не нарушать ход изложения и в то же время дать 
большой фактический материал, не отсылая читателя то и дело к справке 
C++Builder. В третьих, отдельные главы книги написаны так, как если бы это 
были специальные книги по соответствующим вопросам. Я стремился к полноцен- 
ному, законченному изложению каждой темы. А многочисленные ссылки на дру- 
гие главы книги позволили избежать дублирования материала. В четвертых, и я, и 
издательство сделали все возможное, чтобы вместить в разумные габариты макси- 
мум материала. В частности, пришлось пойти на достаточно мелкий шрифт. Мо- 
жет быть не всем читателям это по душе, но если бы не такой шрифт, книга была 
бы еще в полтора раза толще (и дороже). 


Отличие от книг серии «Все о C++Builder» 
и «Программирование в C++Builder 4» 


Для читателей, которые видели, а, может быть, и имеют какие-то другие мои 
книги, посвященные C++Builder, необходимо пояснить соотношение тех книг и 
этой. Начну с книги — «Программирование в C++Builder 4». Структура данной 
книги осталась прежней (хотя и добавилась одна глава), так как, вроде бы, со сто- 
роны читателей нареканий на этот счет не было. Материал, конечно, частично по- 
вторяется, хотя практически во всех главах добавлено новое и устранены некото- 
рые замеченные недочеты прежней книги. Но добавлено и очень много совершенно 
нового материала, в частности: 


Ш интернационализация разрабатываемых прикладных программ 
Ш развертывание, установка и настройка прикладных программ 


Ш новые альтернативные технологии доступа к базам данных — Microsoft Acti- 
veX Data Objects и InterBase Express 


Ш многомерный анализ данных — компоненты Decision Cube 

Ш компоненты — серверы СОМ 

Ш компоненты страницы ActiveX 

Ш новые компоненты C++Builder 5 — фреймы, диспетчер событий приложения 
и ряд других 

Ш новые возможности среды проектирования C++Builder 5 и новый инструмента- 


рий, встроенный в эту среду: Проектировщик Модулей Данных, автоматизация 
задания в классах новых свойств, методов, событий, сообщений и многое другое 


Так как необходимо было вписываться в тот же уже весьма большой объем 
книги, то пришлось в ряде случаев уплотнить изложение и кое-какой второстепен- 
ный материал убрать. Надеюсь, что это сделано не в ущерб качеству. 

Теперь о соотношении данной книги с книгами [1] — [8] серии «Все о 
C++Builder» (список этих книг дан в конце). Серия была задумана как способ дать 
читателю возможность выборочно приобретать литературу только по тем вопро- 
сам, которые его интересуют, причем в более углубленном, более подробном изло- 
жении и с большим числом примеров. Поэтому, хотя многое в первых восьми кни- 
гах серии является дословным повторением материала данной книги, они содер- 
жат немало дополнительной информации, примеров, справочных данных. В пер- 
вую очередь это относится к книгам [2] и [3], посвященным компонентам библио- 
теки C++Builder, и к книгам [7] [8], посвященным работе с базами данных. Так 
что я мог бы взять на себя смелость рекомендовать тем читателям, которые хотят 

получить больше информации по этим вопросам, познакомиться с указанными 
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книгами. А последующие книги серии «Все о C++Builder», которые намечено под- 
готовить, будут содержать материал, который в данной книге вообще отсутствует 
или только бегло затронут. 


Что вы найдете в этой книге 


Итак, что же вы можете найти в этой книге. 

Книга состоит из четырех частей. Первая часть — вводная. В ней излагаются 
основы объектно-ориентированного визуального программирования (глава 1), ме- 
тодика работы с интегрированной средой разработки C++Builder (глава 2) и рас- 
сматриваются наиболее часто используемые компоненты ‘из библиотеки 
C++Builder (глава 3). Первые две главы построены как начальный курс обучения 
работе с C++Builder. Третья глава дает справочный материал по большинству ком- 
понентов (остальные компоненты рассмотрены в других главах). Пользователь 
C++Builder, как и любой другой большой системы, обычно использует только часть 
ее возможностей, только свои любимые компоненты, которые он изучил. Поэтому, 
вероятно, даже тем, кто уже работал с C++Builder, будет очень полезно посмотреть 
материал главы 3, чтобы обогатить свою палитру используемых компонентов. 

Вторая и третья части книги — методические. Вторая часть, включающая 
главы с 4 по 8, посвящена различным аспектам построения прикладных программ 
для Windows. В каждой из этих глав идет последовательное изложение материала, | 
сопровождаемое многочисленными примерами. Фактически, каждую главу можно 
рассматривать как раздел учебного курса по соответствующему вопросу. Но, по- 
скольку все аспекты построения приложений в C++Builder тесно связаны друг с 
другом, пришлось выбирать один из двух возможных вариантов построения кни- 
ги: или придерживаться строгой последовательности изложения (в каждой главе 
использовать только то, о чем было сказано в предыдущих главах), что неминуемо 
ведет к потере полноты изложения, или излагать каждый вопрос полностью, но то- 
гда допускать при необходимости немало ссылок на материалы, изложенные в по- 
следующих главах. Учебники строятся по первому принципу и это является при- 
чиной того, что большинство книг по C++Builder грешат неполнотой: рассматри- 
ваются основы какой-то темы, но многие важнейшие ее аспекты опускаются, по- 
скольку для их изложения нужны сведения из еще не изученного раздела. В этой 
книге принят второй подход: каждая глава излагает соответствующую тему полно- 
стью и содержит ссылки на разделы других глав, в которых читатель может прояс- 
нить для себя какие-то непонятные ему вопросы. Таким образом, каждая глава мо- 
жет рассматриваться как законченный методический и справочный материал по 
соответствующей теме. Благодаря этому читатель может изучать главы в той по- 
следовательности, какая нужна ему для его конкретной работы, опуская главы, не 
представляющие для него в данный момент интереса. Исключение, может быть, 
представляет только глава 4, в которой рассматриваются наиболее общие вопросы 
построения прикладных программ для Windows и которую, вероятно, надо прочи- 
тать (может быть, с некоторыми купюрами), независимо от конкретных пристра- 
стий читателя к той или иной тематике. | 

Глава 5 посвящена вопросам построения приложений, использующих графи- 
ку и средства мультимедиа. В главе 6 рассматриваются различные аспекты взаи- 
модействия приложения с внешними программами. Эти вопросы нередко излага- 
ются в литературе по C++Builder очень бегло. Однако, опыт показывает, что часто 
к помощи C++Builder обращаются именно для построения пользовательского ин- 
терфейса к уже имеющимся программам, разработанным ранее для Windows или 
DOS. Поэтому взаимодействие с этими готовыми программами хотя бы просто на 
уровне вызова их выполняемых модулей для многих разработчиков является 
очень важным вопросом. Впрочем, в главе 6 рассматривается и методика более 
тонкого взаимодействия приложений: использование сообщений Windows, техно- 
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логии OLE и DDE и серверы СОМ — новый класс компонентов в C++Builder 5. Гла- 
ва 7 рассматривает различные способы повторного использования разработанных 
вами кодов: построение шаблонов и создание новых компонентов, разработку ие- 
рархии форм и фреймов, библиотек DLL, пакетов. Владение различными способа- 
ми повторного использования кодов может экономить массу времени при разра- 
ботке серии приложений и способствует тому, что с каждым новым приложением 
ваши затраты на разработку будут становиться все меньше и меньше. В главе 8 де- 
тально излагается методика построения справочных файлов Windows. Это не свя- 
зано непосредственно с C++Builder и поэтому, если этот вопрос и затрагивается в 
книгах о C++Builder, то очень поверхностно. Но в настоящее время трудно пред- 
ставить себе серьезную прикладную программу для Windows, не содержащую 
встроенной в нее контекстной справочной системы. Поэтому построению таких 
систем в этой книге уделено должное внимание. 

Часть третья книги, содержащая главы 9, 10 и 11, посвящена созданию прило- 
жений для работы с базами данных. Создание таких приложений — наиболее мощ- 
ная сторона C++Builder. Изложение в этих главах ведется последовательно и сопро- 
вождается многочисленными примерами. Эта часть книги может. рассматриваться 
как самостоятельный курс по созданию в среде C++Builder приложений, работающих 
с базами данных, и по разработке самих баз данных с помощью C++Builder. 

Четвертая часть книги, наиболее объемная и включающая главы с 12 по 16, 
содержит справочные материалы. Они вынесены в отдельную часть и в отдельные 
главы, чтобы не загромождать техническими деталями изложение в предыдущих 
частях книги. К тому же, это облегчает читателю поиск интересующих его кон- 
кретных сведений. В главах 12 и 13 даются справочные сведения по языку про- 
граммирования С++. При этом в главе 12 рассматривается синтаксис языка, объ- 
явления переменных, функций, общие вопросы построения программы. А гла- 
ва 13 посвящена справочным сведениям о типах в С++, начиная от простых, и кон- 
чая такими, как массивы, структуры и классы. В главе 14 приведены справочные 
материалы по интегрированной среде разработки C++Builder: описания команд 
меню, палитры компонентов, настроек. среды. Глава 15 содержит справочные дан- 
ные по функциям С++, C++Builder и API Windows. Здесь приводятся сведения по 
более чем 570 функциям. В главе 16 в алфавитном порядке приведены сведения о 
свойствах, методах, событиях компонентов и классов C++Builder и сведения о He- 
которых базовых классах и типах C++Builder. В последнем разделе главы дается 
алфавитный перечень компонентов C++Builder со ссылками на разделы книги, в 
которых эти компоненты подробно рассмотрены. Этот раздел полезен для быстрого 
поиска методической и справочной информации по тому или иному компоненту. 

Конечно, перечень функций, элементов C++Builder, их свойств и методов в 
главах 15 и 16 не полный, хотя и внушительный: в них рассмотрено свыше 570 
функций и около 400 методов, свойств, событий различных классов (некоторые 
подробно, некоторые бегло). Большего объема сведений эта книга просто не выдер- 
жала бы, так как попытка охватить весь справочный материал привела бы к тому, 
что объем глав 15 и 16 в два раза превысил бы объем всей этой книги. Но большин- 
ство функций, свойств, методов, событий, упоминаемых в первых частях книги и 
нуждающихся в более детальном рассмотрении, в этих главах приведены. И к это- 
му добавлено многое, о чем в предыдущих главах не говорилось. 

Прилагаемый к книге диск содержит многие из примеров и баз данных, рас- 
смотренных в книге. Они отличаются от демонстрационных примеров, распростра- 
няемых с C++Builder, большей прозрачностью кодов (в них намеренно пропущены 
некоторые усложнения, затрудняющие чтение законченных реальных приложе- 
ний) и подробным описанием в виде отдельных текстов и комментариев. 

На диске имеется также начальный вариант файла справки по C++Builder и 
C++ на русском языке. Конечно, это не полная справка по C++Builder, а только ee 
нулевая версия. Справку можно встроить в интегрированную среду разработки 
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C++Builder и использовать в своей текущей работе. Работа над справкой продол- 
жается и, если решатся некоторые чисто технические вопросы, то первая полно- 
ценная версия справки выйдет в скором времени в серии «Все о C++Builder». 


Чего вы не найдете в этой книге 


Теперь, рассмотрев то, что вы можете найти в этой книге, полезно сразу четко оп- 
ределить, чего вы в ней не найдете. Должен честно оговориться, что эта книга, как и 
любая литература mo C++Builder, не претендует на исчерпывающую полноту. При- 
вести в одной книге подробные сведения по всем функциям языка, по всем классам, 
типам и программным составляющим постоянно развивающейся системы C++Buil- 
der не представляется возможным. Поэтому, отступая от традиции, по которой авто- 
ры просто тихо умалчивают о том, что не вошло в книгу, хочу сразу честно сориенти- 
ровать читателя, чтобы он не тратил силы на поиск того, чего найти невозможно. 

В книге не рассмотрена работа приложений C++Builder с Интернет и, значит, 
не рассматриваются соответствующие страницы библиотеки компонентов. Не рас- 
сматривается также страница MIDAS библиотеки компонентов, связанная с по- 
строением приложений для распределенных баз данных. Эта страница имеется 
только в вариантах C++Builder клиент/сервер и Enterprise. Соответственно, в кни- 
ге обсуждаются приложения, работающие со структурами баз данных от локаль- 
ных до клиент/сервер, и не затрагиваются многоуровневые базы данных. В книге 
крайне конспективно рассматриваются вопросы, связанные с использованием 
ActiveX и CORBA (Common Object Request Broker Architecture — стандарт по- 
строения приложений с распределенными объектами). Из возможных видов при- 
кладных программ, которые можно строить с помощью C++Builder 5, рассмотре- 
ны практически только программы для Windows. Консольные приложения WIN32 
только упоминаются. Это, на мой взгляд, оправдано, поскольку именно в прило- 
жениях для Windows проявляется вся мощь C++Builder. А консольные приложе- 
ния можно строить с тем же успехом и с помощью других. инструментов. 

Вот, пожалуй, и все. Перечисленные вынужденные умолчания связаны с есте- 
ственными ограничениями на объем книги. Было решено лучше полностью изла- 
гать материал по существенным вопросам, чем сокращать это изложение ради бег- 
лого рассмотрения того, что осталось за кадром. На мой взгляд, того, что рассмот- 
рено в книге, более чем достаточно для построения подавляющего большинства 
приложений. Ну а если читателю потребуются сведения по неосвещенным вопро- 
сам, ему придется обратиться к специальной литературе или работать со встроен- 
ной справкой C++Builder. Я надеюсь также, что эти пробелы будут в скором време- 
ни устранены книгами серии «Все о C++Builder». Кстати, приглашаю любого спе- 
циалиста, владеющего материалом по вопросам, не освещенным в данной книге, 
стать автором соответствующей книги серии «Все о C++Builder». Присылайте свои 
предложения в адрес издательства. 


Рекомендации по работе с книгой 


Выше я уже написал, что доверяю способности читателя самому выбрать наи- 
более удобную ему последовательность изучения материала данной книги. Благо 
она построена так, что отдельные темы можно изучать независимо друг от друга и 
в любой последовательности. Но все же я возьму на себя смелость дать некоторые 
советы по изучению материала разными категориями читателей. 

Тем, кто до чтения этой книги никогда не работал с C++Builder, вероятно, бу- 
дет полезной следующая последовательность работы. Сначала надо прочитать ма- 
териал небольшой главы 1, вводящей читателя в мир объектно-ориентированного 
программирования. Затем следует научиться работать в интегрированной среде 
разработки C++Builder с помощью последовательного изучения материалов гла- 


22 Программирование в C++Builder 5 


вы 2 (ряд тонкостей, связанных с настройкой среды проектирования и с отладкой 
приложений, можно при этом пропустить, вернувшись к этому материалу позд- 
нее). Две первые главы книги построены как начальный курс обучения работе с 
C++Builder и не должны вызвать затруднений у тех, кто впервые установил эту 
систему на своем компьютере. Тем из начинающих, кто не знаком с языком про- 
граммирования С++, можно рекомендовать по началу не отвлекаться на его изуче- 
ние (некоторый минимум сведений о нем содержится в разделе 1.6 главы 1), а сме- 
ло создавать по рекомендациям главы 2 и последующих глав свои первые прило- 
жения. Мой опыт преподавания C++Builder говорит, что это вполне возможно. 
Если что-то в кодах этих приложений вам будет не понятно, обращайтесь за разъ- 
яснениями к соответствующим разделам глав 12, 1Зи 15. Более внимательное изу- 
чение этих глав целесообразно отнести к тому времени, когда вы уже хорошо ос- 
воитесь с C++Builder и вам захочется перейти к каким-то сложным приложениям, 
в которых потребуется использовать более глубокие аспекты языка С++. 

После начального обучения по материалам глав 1 и 2 желательно последова- 
тельно изучить в главе 4 материал разделов 4.1 — 4.3 и раздела 4.5 («Формы»). По 
мере изучения этих разделов полезно обращаться к соответствующим разделам 
главы 3, чтобы получить дополнительную информацию об используемых в приме- 
рах компонентах. 

Изучив все это, вы можете перестать считать себя начинающим пользователем 
и планировать дальнейшее знакомство с материалом других глав и с пропущенными 
разделами главы 4 исходя из того, что вам более всего нужно в вашей работе. 

Теперь некоторые рекомендации более или менее опытным пользователям 
C++Builder. Можно, вероятно, не читать главу 1, но ряд разделов главы 2, связан- 
ных с различными инструментами среды C++Builder 5 и с их настройкой, про- 
смотреть полезно. Жизнь показывает, что даже достаточно опытные пользователи 
используют далеко не все возможности, встроенные в C++Builder. Во всяком слу- 
чае, работая над материалом главы 2, я открыл для себя ряд возможностей, о кото- 
рых ранее не знал. А в среде разработки C++Builder 5 появилось немало нового ин- 
струментария, который очень полезно освоить. 

Полезно также просмотреть материал главы 3, посвященной компонентам 
C++Builder общего назначения. Не говоря уже о новых компонентах, появивших- 
ся в C++Builder 5, о новых способах диспетчеризации событий, вы, вероятнее все- 
го, и из прежних компонентов используете далеко не все, отдавая предпочтение 
наиболее любимым вами. Так что посмотреть сравнительный анализ различных 
компонентов будет в любом случае полезно. 

В главе 4 полезно ознакомиться с новой технологией интернационализации прило- 
жений, введенной в Delphi 5, в главах 6 и 11 — с серверами COM — новым классом 
компонентов в Delphi 5, в главе 10 — с новыми альтернативными способами доступа 
к базам данных. А в остальном — изучайте то, что вам надо, и в любой последователь- 
ности. Опыт подскажет вам наиболее эффективный способ работы с материалом. 
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°нирую и далее заниматься той же тематикой. Кроме того, обрати внимание на со- 
держащийся выше призыв к сотрудничеству в создании серии «Все о C++Builder». 
Поделись с другими своим опытом работы с C++Builder. Любые предложения бу- 
дут с благодарностью приняты и рассмотрены редакцией. 
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Принципы 
объектно-ориентированного 
визуального 
программирования 


1.1 Объектно-ориентированное 
программирование 


Объектно-ориентированный подход уже ‘давно стал естественным для любых 
прикладных программ Windows (далее на протяжении всей книги мы для кратко- 
сти будем называть прикладные программы приложениями). Когда вы начинаете 
выполнять любую программу Windows, вы видите обычно диалоговое окно с меню, 
кнопками, индикаторами, выпадающими списками и т.п. Все это объекты. Сами 
по себе они не производят никаких действий, пока не получат какое-то сообщение 
от пользователя. После получения сообщения происходят какие-то действия (про- 
водятся вычисления, выполняется какая-то программа, появляется новое диалого- 
вое окно ит.п.). После этого опять всякая активность опять затухает, пока тот или 
иной объект не получит нового сообщения от пользователя или от другого объекта. 
Таким образом, объектно-ориентированная программа не имеет жесткого алгорит- 
ма работы. Она представляет собой систему объектов, каждый из которых может 
выполнять какие-то функции в ответ на полученное сообщение, в частности, мо- 
жет сам генерировать сообщения, на которые будут реагировать другие объекты. 
Взаимодействие пользователя с компьютерной программой — это тоже взаимодей- 
ствие двух объектов — программы и человека, которые обмениваются друг с дру- 
гом определенными сообщениями. 

Попробуем разобраться с основным понятием объектно-ориентированного 
программирования — объектом. Для начала можно определить объект как некую 
совокупность данных и способов работы с ними. Данные можно рассматривать 
как поля записи. Это характеристики объекта. Пользователь и объекты програм- 
мы должны, конечно, иметь возможность читать эти данные объекта, как-то их об- 
рабатывать и записывать в объект новые значения. 

Здесь важнейшее значение имеют приниипы инкапсуляции и скрытия дан- 
ных. Принцип скрытия данных заключается в том, что внешним объектам и поль- 
зователю прямой доступ к данным, как правило, запрещен. Делается это из двух 
соображений. 

Во-первых, для надежного функционирования объекта надо поддерживать це- 
лостность и непротиворечивость его данных. Если не позаботиться 06 этом, то 
внешний объект или пользователь могут занести в объект такие неверные данные, 
что он начнет функционировать с ошибками. 

Во-вторых, необходимо изолировать внешние объекты от особенностей внут- 
ренней реализации данных. Для внешних потребителей данных должен быть дос- 
тупен только пользовательский интерфейс — описание того, какие имеются дан- 
ные и функции и как их использовать. А внутренняя реализация — это дело разра- 
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ботчика объекта. При таком подходе разработчик может в любой момент модерни- 
зировать объект, изменить структуру хранения и форму представления данных, 
но, если при этом не затронут интерфейс, внешний потребитель этого даже не за- 
метит. И, значит, во внешней программе и в поведении пользователя ничего не 
`’ придется менять. 

Чтобы выдержать принцип скрытия данных, в объекте обычно определяются 
процедуры и функции, обеспечивающие все необходимые операции с данными: их 
чтение, преобразование, запись. Эти функции и процедуры называются методами. 
и через них происходит общение с данными объекта (рис. 1.1). 


Рис. 1.1 


Данные 
Схема обращения к данным через методы объекта 


Методы чтения 


и записи данных 


Совокупность данных и методов их чтения и записи называется свойством. Со 
свойствами вы будете иметь дело на протяжении всей этой книги. Свойства можно 
устанавливать в процессе проектирования, их можно изменять программно во вре- 
мя выполнения вашей прикладной программы. Причем внешне это все выглядит 
так, как будто объект имеет какие-то данные, например, целые числа, которые 
можно прочитать, использовать в каких-то вычислениях, заложить в объект но- 
вые значения данных. В процессе проектирования вашего приложения с помощью 
C++Builder вы можете видеть значения некоторых из этих данных в окне Инспек- 
тора Объектов (см. главу 2), можете изменять эти значения. В действительности 
все обстоит иначе. Все общение с данными происходит через методы их чтения и 
записи. Это происходит и в процессе проектирования, когда среда проектирования 
C++Builder запускает в нужный момент эти методы, и в процессе выполнения при- 
ложения, поскольку компилятор C++Builder незримо для разработчика вставляет 
в нужных местах программы вызовы этих методов. Например, если в объекте име- 
ется некоторое числовое свойство А, то вы можете написать оператор вида 


А = А + 1; 


который прибавляет к значению А единицу. Но в действительности реализация 
этого операторы во многих случаях выглядит сложнее. Компилятор преобразует 
этот простой код в вызов метода чтения свойства А, к возвращенному этим мето- 
дом значению прибавляется единица, а затем вызывается метод записи свойства, 
который заносит полученный результат в данные объекта. 

Помимо методов, работающих с отдельными данными, в объекте имеются ме- 
тоды, работающие со всей их совокупностью, меняющие их структуру. Таким об- 
разом, объект является совокупностью свойств и методов. Но это пока нельзя 
считать законченным определением объекта, поскольку прежде, чем дать полное 
определение, надо еще рассмотреть взаимодействие объектов друг с другом. 

Средой взаимодействия объектов (как бы силовым полем, в котором существу- 
ют объекты) являются сообщения, генерируемые в результате различных собы- 
тий. События наступают, прежде всего, вследствие действий пользователя — пе- 
ремещения курсора мыши, нажатия кнопок мыши или клавиш клавиатуры. Но 
события могут наступать и в результате работы самих объектов. В каждом объекте 
определено множество событий, на которые он может реагировать. В конкретных 
экземплярах объекта могут быть определены обработчики каких-то из этих собы- 
THU, которые и определяют реакцию данного экземпляра объекта. В обработчиках 
анализируется сгенерированное событие и предпринимаются те или иные дейст- 
вия: изменение свойств объектов, выполнение каких-то методов, генерация новых 
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событий. К написанию этих обработчиков, часто весьма простых, и сводится, как 
будет видно далее, основное программирование при разработке графического ин- 
терфейса пользователя с помощью C++Builder. | 

Теперь можно окончательно определить объект как совокупность свойств и 
методов, а также событий, на которые он может реагировать. Условно это изо- 
бражено на рис. 1.2. Внешнее управление объектом осуществляется через обработ- 
чики событий. Эти обработчики обращаются к методам и свойствам объекта. На- 
чальные значения данных объекта могут задаваться также в процессе проектиро- 
вания установкой различных свойств. В результате выполнения методов объекта 
могут генерироваться новые события, воспринимаемые другими объектами про- 
граммы или пользователем. 


Установки при проектировании 


Свойства 


Рис. 1.2 


Схема организации объекта 


События 


Описанная ранее структура программы в виде некоторой фиксированной сово- 
купности объектов не является полной. Чаще всего сложная программа — это не 
просто какая-то предопределенная совокупность объектов. В процессе работы объ- 
екты могут создаваться и уничтожаться. Таким образом, структура программы яв- 
ляется динамическим образованием, меняющимся в процессе выполнения. Основ- 
ная цель создания и уничтожения объектов — экономия ресурсов компьютера и, 
прежде всего, памяти. Несмотря на бурное развитие вычислительной техники, па- 
мять, наверное, всегда будет лимитировать возможности сложных приложений. 
Это связано с тем, что сложность программных проектов растет теми же, если не 
более быстрыми, темпами, что и техническое обеспечение. Поэтому от объектов, 
которые не нужны на данной стадии выполнения программы, нужно освобождать- 
ся. При этом освобождаются и выделенные им области памяти, которые могут ис- 
пользоваться вновь создаваемыми объектами. Простой пример этого — окно-за- 
ставка с логотипом, появляющееся при запуске многих приложений. После нача- 
ла реального выполнения приложения эта заставка исчезает с экрана и никогда 
больше не появляется в данном сеансе работы. Было бы варварством не уничто- 
жить этот объект и не освободить занимаемую им память для более продуктивного 
использования. 

С целью организации динамического распределения памяти во все объекты за- 
ложены методы их создания — конструкторы и уничтожения — деструкторы. 
Конструкторы объектов, которые изначально должны присутствовать в приложе- 
нии (прикладной программе), срабатывают при запуске программы. Деструкторы 
всех объектов, имеющихся в данный момент в приложении, срабатывают при за- 
вершении его работы. Но нередко и в процессе выполнения различные новые объ- 
екты (например, новые окна документов) динамически создаются и уничтожаются 
с помощью их конструкторов и деструкторов. 

Включать объекты в свою программу можно двумя способами: вручную вклю- 
чать в нее соответствующие операторы (это приходится делать не очень часто) или 
путем визуального программирования, используя заготовки — компоненты. 


~ 


28 , | | Глава 1 


1.2 Основы визуального программирования 
интерфейса 


Сколько существует программирование, столько существуют в нем и тупики, 
в которые оно постоянно попадает и из которых в конце концов доблестно выхо- 
дит. Один из таких тупиков или кризисов не так давно был связан с разработкой 
графического интерфейса пользователя. Программирование вручную всяких при- 
вычных пользователю окон, кнопок, меню, обработка событий мыши и клавиату- 
ры, включение в программы изображений и звука требовало все больше и больше 
времени программиста. В ряде случаев весь этот сервис начинал занимать до 
80-90% объема программных кодов. Причем весь этот труд нередко пропадал поч- 
ти впустую, поскольку через год — другой менялся общепринятый стиль графиче- 
ского интерфейса и все приходилось начинать заново. 

Выход из этой ситуации обозначился благодаря двум подходам. Первый из 
них — стандартизация многих функций интерфейса, благодаря чему появилась 
возможность использовать библиотеки, имеющиеся, например, в Windows. В ито- 
ге при смене стиля графического интерфейса (например, при переходе от Windows 
3.x к Windows 95) приложения смогли автоматически приспосабливаться к новой 
системе без какого-либо перепрограммирования. На этом пути создались прекрас- 
ные условия для решения одной из важнейших задач совершенствования техники 
программирования — повторного использования кодов. Однажды разработанные 
вами формы, компоненты, функции могли быть впоследствии неоднократно ис- 
пользованы вами или другими программистами для решения их задач. Каждый 
программист получил доступ к наработкам других программистов и к огромным 
библиотекам, созданным различными фирмами. Причем была обеспечена совмес- 
тимость программного обеспечения, разработанного на разных алгоритмических 
языках. 

Вторым революционным шагом, кардинально облегчившим жизнь програм- 
мистов, явилось появление визуального программирования, возникшего в Visual 
Basic и нашедшего блестящее воплощение в системах Delphi и C++Builder фирмы 
Borland. Это явилось решающим шагом в развитии так называемой САЗЕ-техноло- 
гии (Computer Aided Software Engineering — автоматизированное проектирование 
программного обеспечения). | 

Визуальное программирование позволило свести проектирование пользова- 
тельского интерфейса к простым и наглядным процедурам, которые дают возмож- 
ность за минуты или часы сделать то, на что ранее уходили месяцы работы. В со- 
временном виде в C++Builder это выглядит так. 

Вы работаете в Интегрированной Среде Разработки (ИСР или Integrated 
development environment — IDE) C++Builder. Среда предоставляет вам формы (в 
приложении их может быть несколько), на которых размещаются компоненты. 
Обычно это оконная форма, хотя могут быть и невидимые формы. На форму с по- 
мощью мыши переносятся и размещаются пиктограммы компонентов, имеющих- 
ся в библиотеках C++Builder. С помощью простых манипуляций вы можете изме- 
нять размеры и расположение этих компонентов. При этом вы все время в процес- 
се проектирования видите результат — изображение формы и расположенных на 
ней компонентов. Вам не надо мучиться, многократно запуская приложение и вы- 
бирая наиболее удачные размеры окна и компонентов. Результаты проектирова- 
ния вы видите, даже не компилируя программу, немедленно после выполнения ка- 
кой-то операции с помощью мыши. 

Но достоинства визуального программирования не сводятся к этому. Самое 
главное заключается в том, что во время проектирования формы и размещения на 
ней компонентов C++Builder автоматически формирует коды программы, вклю- 
чая в нее соответствующие фрагменты, описывающие данный компонент. А затем 
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в соответствующих диалоговых окнах пользователь может изменить заданные по 
умолчанию значения каких-то свойств этих компонентов и, при необходимости, 
написать обработчики каких-то событий. То есть проектирование сводится, факти- 
чески, к размещению компонентов на форме, заданию некоторых их свойств и`на- 
писанию, при необходимости, обработчиков событий. 

Компоненты могут быть визуальные, видимые при работе приложения, и не- 
визуальные, выполняющие те или иные служебные функции. Визуальные компо- 
ненты сразу видны на экране в процессе проектирования в таком же виде, в каком 
их увидит пользователь во время выполнения приложения. Это позволяет очень 
легко выбрать место их расположения и их дизайн — форму, размер, оформление, 
текст, цвет и т.д. Невизуальные компоненты видны на форме в процессе проекти- 
рования в виде пиктограмм, но пользователю во время выполнения они не видны, 
хотя и выполняют для него за кадром весьма полезную работу. 

В библиотеки визуальных компонентов C++Builder включено множество TH- 
пов компонентов и их номенклатура очень быстро расширяется от версии к вер- 
сии. Имеющегося уже сейчас вполне достаточно, чтобы построить практически 
любое самое замысловатое приложение, не прибегая к созданию новых компонен- 
тов. При этом даже неопытный программист, делающий свои первые шаги на этом 
поприще, может создавать приложения, которые выглядят совершенно профес- 
сионально. 


1.3 Предварительные сведения о классах 
и наследовании 


Типы объектов и, в частности, компонентов библиотек C++Builder оформля- 
ются в виде классов. Классы — это типы, определяемые пользователем. В классах 
описываются свойства объекта, его методы и события, на которые он может реаги- 
ровать. Язык программирования C++ предусматривает только инструментарий 
создания классов. А сами классы создаются разработчиками программного обеспе- 
чения. Впрочем, создатели C++Builder уже разработали для вас множество очень 
полезных классов и включили их в библиотеки системы. Этими классами вы поль- 
зуетесь при работе в Интегрированной Среде Проектирования. Конечно, это нис- 
колько не мешает создавать вам свои новые классы. 

Если бы при создании нового класса вам пришлось все начинать с нуля, то эф- 
фективность этого занятия была бы под большим сомнением. Да и разработчики 
C++Builder вряд ли создали бы в этом случае такое множество классов. Действи- 
тельно, представьте себе, что при разработке нового компонента, например, ка- 
кой-нибудь новой кнопки, вам пришлась бы создавать все: рисовать ее изображе- 
ние, описывать все свойства, определяющие ее место расположения, размеры, над- 
писи и картинки на ее поверхности, цвет, шрифты, описывать методы, реализую- 
щие ее поведение — изменение размеров, видимость, реакции на сообщения, по- 
ступающие от клавиатуры и мыши. Вероятно, представив себе все это, вы отказа- 
лись бы от разработки новой кнопки. 

К счастью, в действительности все обстоит горазда проще, благодаря одному 
важному свойству классов — наследованию. Новый класс может наследовать свой- 
ства, методы, события своего родительского класса, т.е. того класса, на основе ко- 
торого он создается. Например, при создании новой кнопки можно взять за основу 
один из уже разработанных классов кнопок и только добавить к нему какие-то но- 
вые свойства или отменить какие-то свойства и методы родительского класса. 
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1.4 Системы быстрой разработки приложений 


Благодаря визуальному объектно-ориентированному программированию была 
создана технология, получившая название быстрая разработка приложений, 
по-английски RAD — Rapid Application Development. Эта технология характерна 
для нового поколения систем программирования, к которому относится и 
C++Builder. 

Первой ласточкой в этом новом мире более простого и наглядного интерфейса 
была среда Visual Basic. Она сформировала новый стиль взаимодействия разработ- 
чика программы с компьютером, позволяя наглядно конструировать пользова- 
тельский интерфейс с помощью мыши, а не обычным для прежних времен путем: 
написанием кодов, их трансляцией и выполнением программы, после чего только 
и можно было посмотреть, как же это выглядит на экране. 

Хотя Visual Basic нашел широкий спрос и помог открыть мир программирова- 
ния для людей, не слишком в нем искушенных, он не свободен от многих проблем. 
Главные из них — низкая производительность разрабатываемых приложений при 
их выполнении, недостаточная строгость и объектная ориентированность языка, 
способствующая скорее быстрой разработке поделок, а не созданию мощных эф- 
фективных приложений, а также ряд других недостатков. 

Системы Delphi и C++Builder — это следующий шаг в развитии среды быстрой 
разработки приложений. Они исправляют многие дефекты, обнаруженные в Visual 
Basic. Разработчики этих систем создали инструменты, которые на первый взгляд 
выглядят похожими на среду Visual Basic, хотя в действительности они заметно 
лучше. | 

Интегрированная среда разработки в Delphi и C++Builder выглядит одинако- 
во. Весь пользовательский интерфейс, все библиотеки, все приемы работы с этими 
системами практически одинаковы. Если быть более точным, то они различаются 
только в силу разного времени выпуска соответствующих версий. Версии 
C++Builder выпускаются на полгода позже версий Delphi с аналогичными номера- 
ми. Поэтому каждая версия C++Builder совершеннее аналогичной версии Delphi, 
но слабее последующей версии Delphi. 

Впрочем, основное различие Delphi и C++Builder не в этом, а в языках про- 
граммирования, которые лежат в их основе. Delphi базируется на языке Object 
Pascal, а C++Builder — на языке С++. Эти языки, сначала существенно различные 
по своим возможностям, со временем все более сближаются. Сейчас оба они пред- 
ставляют прекрасные инструменты объектно-ориентированного программирова- 
ния, различающиеся, в основном, синтаксисом. Но С++ все-таки богаче и опере- 
жает аналогичные версии Object Pascal. С этой точки зрения он предпочтительнее. 
Правда, эти преимущества С++ перед Object Pascal проявляются только в доста- 
точно сложных приложениях. 

Фирма Borland позаботилась о TOM, чтобы приложения, разработанные на 
C++Builder и на Delphi можно было достаточно просто конвертировать друг в дру- 
га. Таким образом, в одной из этих систем вы можете использовать свои наработ- 
ки, сделанные в другой системе. 

Отдельно надо сказать об одной из главных задач C++Builder и Delphi — раз- 
работке приложений для работы с базами данных. В этой области C++Builder и 
Delphi занимают самые передовые позиции, работая с любыми системами управле- 
ния базами данных. 

В целом C++Builder — великолепный инструмент как для начинающих про- 
граммистов, так и для ассов программирования. Так что не зря вы заинтересова- 
лись C++Builder и, надеюсь, с пользой ознакомитесь с данной книгой. 
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1.5 Язык объектно-ориентированного 
проектирования С++ 


1.5.1 Введение 


Возможности объектно-ориентированного проектирования в C++Builder бази- 
руются на свойствах языка С++. Детальное изучение C++ выходит за рамки дан- 
ной книги. Впрочем, все необходимые вам для чтения этой книги сведения о С++ 
вы можете почерпнуть в справочной части книги в главах 12, 13, 15. Кроме того, 
отдельные аспекты языка не раз будут обсуждаться в различных главах книги. В 
целом вы получите достаточно сведений для написания большинства приложений, 
с которыми вас столкнет жизнь. Ну а желающим глубоко изучить С++ и научить- 
ся профессионально использовать все его возможности придется изучить его по 
специальной литературе. 

Язык С++ — это дальнейшее развитие более раннего языка программирова- 
ния С. Если вы совсем не знакомы ни с одной версией семейства языков С, то мож- 
но рекомендовать вам прямо сейчас, прежде, чем читать эту книгу далее, посмот- 
реть в главе 12 раздел 12.1, в котором описан синтаксис этого языка, и бегло про- 
смотреть разделы, в которых описано объявление констант, переменных и функ- 
ций. Впредь обращайтесь к главам 12 и 13, когда что-то в изложении того или ино- 
го вопроса покажется вам неясным. Я надеюсь, что это будет происходить редко и 
главы 13 и 13 пригодятся вам, в основном, только для углубленного изучения ка- 
ких-то тем. 

В данной главе мы ограничим знакомство с С++ только вопросами общей орга- 
низации программы и доступа к объектам, их свойствам и методам. 


1.5.2 Общие сведения о программах на С++ 


Программа на C++ состоит из объявлений (переменных, констант, типов, 
классов, функций) и описаний функций. Среди функций всегда имеется главная — 
Main для консольных приложений (работающих с WIN32) или WinMain для при- 
ложений Windows. Именно эта главная функция выполняется после начала рабо- 
ты программы. Обычно в C++Builder эта функция очень короткая и выполняет 
только некоторые подготовительные операции, необходимые для начала работы. А 
далее при объектно-ориентированном подходе работа приложения определяется 
происходящими событиями и реакцией на них объектов. 

Как правило, программы строятся по модульному принципу и состоят из мно- 
жества модулей. Принцип модульности очень важен для создания надежных и от- 
носительно легко модифицируемых и сопровождаемых приложений. Четкое со- 
блюдение принципов модульности в сочетании с принципом скрытия информации 
позволяет внутри любого модуля проводить какие-то модификации, не затрагивая 
при этом остальных модулей и головную программу. 

Все объекты компонентов размещаются в объектах — формах. Для каждой 
формы, которую вы проектируете в своем приложении, C++Builder создает отдель- 
ный модуль. Именно в модулях и осуществляется программирование задачи. В об- 
работчиках событий объектов — форм и компонентов, вы помещаете все свои алго- 
ритмы. В основном они сводятся к обработке информации, содержащейся в свойст- 
вах одних объектов, и задании по результатам обработки свойств других объектов. 
При. этом вы постоянно обращаетесь к методам различных объектов. Вопросами 
доступа к свойствам и методам объектов мы и займемся в дальнейших разделах 
данной главы. 

Согласно принципам скрытия информации обычно текст модуля разделяют 
на заголовочный файл интерфейса, который содержит объявления классов, функ- 
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ций, переменных ит.п., и файл реализации, в котором содержится описание функ- 
ций. Стандартное расширение файлов реализации — .cpp. Стандартное расшире- 
ние заголовочных файлов — .h. 

После того, как программа написана, на ее основе должен быть создан выпол- 
няемый файл (модуль). Этот процесс осуществляется в несколько этапов. 

Сначала работает препроцессор, который преобразует исходный текст. Препро- 
цессор осуществляет преобразования в соответствии со специальными директива- 
ми препроцессора, которые размещаются в исходном тексте. Препроцессор может 
в соответствии с этими директивами включать тексты одних файлов в тексты дру- 
гих, развертывать макросы — сокращенные обозначения различных выражений и 
выполнять множество других преобразований. 

После окончания работы препроцессора начинает работать компилятор. Его 
задача — перевести тексты модулей в машинный (объектный) код. В результате 
для каждого исходного файла .cpp создается объектный файл, имеющий расшире- 
ние .obj. 

После окончания работы компилятора работает компоновщик, который объе- 
диняет объектные файлы в единый загрузочный выполняемый модуль, имеющий 
расширение .exe. Этот модуль можно запускать на выполнение. 


1.5.3 Структура головного файла проекта 


В процессе проектирования вами приложения C++Builder автоматически соз- 
дает коды головного файла проекта, коды отдельных модулей и коды их заголо- 
вочных файлов. Головной файл проекта содержит функцию WinMain (в дальней- 
шем в этой книге будут рассматриваться практически только приложения для 
Windows, использующие именно эту функцию, а не функцию main). В прочие мо- 
дули вы вводите свой код, создавая обработчики различных событий. В заголовоч- 
ные файлы этих модулей вы вводите свои объявления. Но головной модуль, как 
правило, вы не трогаете и даже не видите его текст. Только в исключительных слу- 
чаях вам надо что-то изменять в тексте головного модуля, сгенерированном 
C++Builder. Тем не менее, хотя бы ради этих исключительных случаев, надо 
все-таки представлять вид головного файла проекта и понимать, что означают его 
операторы. 

Чтобы увидеть код головного файла проекта, надо выполнить в среде разработ- 
ки C++Builder команду Project | View Source. Типичный головной файл проекта име- 
ет следующий вид (в приведенный текст добавлены русские комментарии): 

// 

// директивы препроцессора 


#include <vcl.h> 
#pragma hdrstop 


// макросы, подключающие файлы ресурсов и форм 
USERES ("Projectl.res") ; 

USEFORM("Unitl.cpp", Forml); 
USEFORM("Unit2.cpp", Form2) ; 

dpe cae 


// функция main 
WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int) 
{ 
try 
{ 
Application->Initialize(); 
Application->CreateForm( classid(TForml), &Forml); 
Application->CreateForm( classid(TForm2), &Form2) ; 
Application->Run(); 
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} 


catch (Exception &exception) 


{ 
Application->ShowException (&exception) ; 
} 


return 0; 


} 


Начинается файл головного модуля строками, первый символ которых — '#'. 
С этого символа начинаются директивы препроцессора (см. подробности в разделе 
12.2 главы 12). Среди них наиболее важны для вас директивы Hinclude, с которы- 
ми вы еще не раз будете иметь дело. Эти директивы подключают в данный файл 
тексты указанных в них файлов. В частности, подобными директивами включают- 
ся в текст заголовочные файлы. Например, директива #include <vel.h> подключа- 
ет заголовочный файл vel.h, содержащий объявления, используемые в библиотеке 
визуальных компонентов C++Builder. 

После директив препроцессора в файле размещены предложения USERES и 
USEFORM. Это макросы, используемые для подключения к проекту файлов форм, 
ресурсов и др. Препроцессор развернет эти макросы в соответствующий код. В дан- 
ном случае вы можете видеть два макроса ОЗЕЕОВМ, подключающих формы. 
C++Builder автоматически формирует соответствующее предложение с макросом 
USEFORM для каждой формы, вносимой вами в проект. Первый параметр макро- 
са содержит имя файла модуля, соответствующего форме (например, «Unitl.cpp>»), 
а второй параметр — имя формы. 

После всех этих вспомогательных предложений в файле расположена главная 
функция программы — WinMain. Ее первым параметром является дескриптор 
данного экземпляра приложения. Дескриптор — это некий уникальный указа- 
тель, позволяющий Windows разбираться в множестве одновременно открытых 
окон различных приложений. Иногда мы будем использовать дескрипторы при 0б- 
ращении к различным функциям API Windows (АРТ Windows — это пользователь- 
ский интерфейс Windows, содержащий множество полезных функций). Второй па- 
раметр WinMain — дескриптор предыдущего экземпляра вашего приложения 
(если пользователь выполняет одновременно несколько таких приложений). Тре- 
тий параметр является указателем на строку с нулевым символом в конце, содер- 
жащую параметры, передаваемые в программу через командную строку. Иногда 
такие параметры используются для переключения режимов работы программы 
или для задания различных опций при запуске приложения из диспетчера про- 
грамм или функцией WinExec. Последний параметр определяет окно приложе- 
ния. Этот параметр может в дальнейшем передаваться в функцию Show Window. 

Все эти параметры функции WinMain используются достаточно редко, так что 
пока можете не стараться разбираться в их назначении. 

После заголовка функции WinMain следует ее тело, заключенное в фигурные 
скобки. Первый выполняемый оператор тела функции — Application->Initialize 
инициализирует объекты компонентов данного приложения. Последующие опера- 
торы Application->CreateForm создают объекты соответствующих форм. Формы 
создаются в той последовательности, в которой следуют эти операторы. Первая из 
создаваемых форм является главной. 

Последний оператор — Application->Run начинает собственно выполнение 
программы. После этого оператора программа ждет соответствующих событий, ко- 
торые и управляют ее ходом. 

Перечисленные операторы тела функции WinMain заключены в блок try, по- 
сле которого следует блок catch. Это структура, связанная с обработкой так назы- 
ваемых исключений — аварийных ситуаций, возникающих при работе програм- 
мы. Если такая аварийная ситуация возникнет, то будут выполнены операторы, 
расположенные в блоке catch. По умолчанию в этом блоке расположен стандарт- 
ный обработчик исключений с помощью функции Application->ShowException. 
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Подробнее об обработке исключений вы можете посмотреть в главе 12 в разде- 
ле 12.10. | 

Последним оператором тела функции WinMain является оператор гефигп(0), 
завершающий приложение с кодом завершения 0. 

Все описанные выше операторы головного файла приложения заносятся в него 
автоматически в процессе проектирования вами приложения. Например, при до- 
бавлении в проект новой формы в файл автоматически вставляются соответствую- 
щее предложение USEFORM и оператор Application->CreateForm, создающий 
форму. Так что обычно ничего в головном файле изменять не надо и даже нет необ- 
ходимости его смотреть. 

Если вам надо ввести какой-то свой текст в головной модуль, вы можете сде- 
лать это, введя объявления необходимых констант, переменных, функций, доба- 
вить или изменить операторы в теле функции. Например, вам может потребовать- 
ся при запуске приложения на выполнение провести какие-то настройки (напри- 
мер, настроить формы на тот или иной язык — русский или английский). Или сде- 
лать какой-то запрос пользователю и в зависимости от ответа создавать или не соз- 
давать те или иные формы. Или проанализировать параметры, переданные в про- 
грамму через командную строку. 

Посмотрим, как можно вводить собственный код в головной файл. Те, кому 
изложенное ниже будет в данный момент мало понятно, могут пропустить следую- 
щие несколько абзацев и вернуться к ним позднее, когда лучше освоятся с про- 
граммированием на языке С++, а главное — когда возникнет достаточно экзотич- 
ная необходимость изменять что-то в головном файле. 

Пусть, например, вы хотите, чтобы вторая форма вашего приложения Form2 
создавалась только в случае, если при запуске приложения через командную стро- 
ку в него передана опция У. В этом случае вы можете изменить заголовок функции 
Уп Маш следующим образом: 


ИТМАРТ WinMain(HINSTANCE, HINSTANCE, LPSTR $, int) 


Этот заголовок объявляет строку S, в которой будет содержаться текст KO- 
мандной строки. Тогда приведенный выше оператор 


Application->CreateForm( classid(TForm2), &Form2) ; 


можно заменить оператором 

if (S{0]. == 'y') 

Application->CreateForm( classid(TForm2), &Form2); 

В этом случае, если ваше приложение Projectl будет запускаться командой 
Projectl У, то форма Form2 будет создаваться. В остальных случаях этой формы 
не будет. 

Аналогичный выбор можно сделать, не анализируя командную строку, а пред- 
ложив пользователю соответствующий вопрос. В этом случае приведенный выше 


‚ оператор можно заменить следующим (0 методе MessageBox см. в главе 15 в разде- 
ле 15.7.2.3): 


if (Application->MessageBox ( 
"Хотите создать вторую форму?", 
"Подтвердите создание второй формы" 
MB YESNOCANCEL + МВ ICONQUESTION) == IDYES) 
Application->CreateForm(  classid(TForm2), &Form2) ; 


Se 


Тогда в момент запуска приложения пользователю будет сделан запрос, пока- 
занный на рис. 1.3. При положительном ответе пользователя форма будет создана, 
в противном случае — нет. 

Вы можете, конечно, ввести в головной файл программы и другие операторы, 
функции и т.п. Все это можно сделать, но это будет плохой стиль программирова- 
ния, поскольку он противоречит принципу модульности. Выше уже говорилось о 
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Рис. 1.3 
Окно запроса пользователю 


важности соблюдения этого принципа. Все необходимые вам в начале выполнения 
процедуры и функции настройки помещайте в один из модулей форм, а еще луч- 
ше — в отдельный модуль без формы. Такой модуль, не связанный с какой-то фор- 
мой, можно включить в приложение, выполнив в среде разработки C++Builder ko- 
манду File | New и щелкнув на пиктограмме Unit. В этом или ином модуле вы можете 
предусмотреть функцию, которая осуществляет все необходимые настройки. Тогда 
в головной программе достаточно будет вызвать в соответствующий момент эту 
функцию, передав в нее, если необходимо, какие-то параметры, например, текст 
командной строки. 


~~ 
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He перегружайте головной файл проекта никаким дополнительным кодом. Все необходимые 
настройки, которые должны осуществляться в начале выполнения приложения, помещайте в 
отдельный модуль. В этом случае в головном модуле достаточно поместить вызов предусмот- 
ренной вами функции настройки. 


ПИ О EL AIOE LLP ИИ УЗО 


Учтите, что все определенные вами в головном файле проекта глобальные константы и пере- 

менные будут доступны в другом блоке только в случае, если они объявлены там со специфи- 

кацией extern (см. главу 12 раздел 12.4.2). Функции, определенные вами в головном файле 
проекта, будут доступны в другом блоке только в случае, если там повторен их прототип (см. 

главу 12 раздел 12.5.1). 

‚Пусть, например, вы написали некоторую функцию, назвав ее begin, в KOTO- 
рой проводится настройка программы в зависимости от опций, переданных через 
командную строку. И пусть вы поместили эту функцию в модуль Unitl.cpp, а ee 
объявление — в заголовочный файл этого модуля Unitl.h (вне описания класса — 
см. раздел 1.5.4). Тогда вы можете в головной файл приложения включить дирек- 
тиву препроцессора 

#include "Unitl.h" 


подключающую файл Unitl.h, изменить заголовок функции WinMain на 
WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR $, int) 


т.е. ввести параметр S, воспринимающий командную строку, и поставить первым 
выполняемым оператором функции WinMain оператор: 


Бед1п ($); 


вызывающий функцию begin и передающий в нее текст командной строки. 
Сама функция begin может иметь вид: ’ 
void begin(String s) 


{ 


// операторы анализа командной строки и настройки 


} 


Таким образом вы, не нарушив принципа модульности, можете осуществить 
все действия, необходимые вам в начале работы программы. 

Имя головного файла проекта по умолчанию дается стандартное: Ргодес& 1, 
Project2 и т.п. Это же имя будет и у выполняемого модуля вашей программы. Так 
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что желательно изменить имя по умолчанию. Для этого достаточно сохранить го- 
ловной файл проекта под соответствующим именем. 


Хо ро LU ий стил b al рограмми ро ва н и я о а о оный 


Всегда сохраняйте проект под каким-то осмысленным именем, изменяя тем самым имя проек- 
та, заданное C++Builder по умолчанию. Иначе очень скоро вы запутаетесь в бесконечных 
программах Project], лежащих в различных ваших каталогах. 


DRUG OO 
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1.5.4 Структура файлов модулей форм 


Рассмотрим теперь, как выглядят тексты модулей форм. Каждый такой мо- 
дуль состоит из двух файлов: заголовочного, содержащего описание класса формы, 
и файла реализации. Ниже приведены тексты этих файлов модуля формы, на ко- 
торой размещена одна метка (компонент типа TLabel) и одна кнопка (компонент 
типа TButton). Подробные комментарии в этом тексте поясняют, куда и что в этот 
код вы можете добавлять. 


Заголовочный файл: 


Ъиыи - 

#ifndef UnitlH 

#define Unitl1H 
Ё————— 
#include <Classes.hpp> 

#include <Controls.hpp> 

#include <StdCtrils.hpp> 

#include <Forms.hpp> 

// сюда могут помещаться дополнительные директивы 
// препроцессора (в частности, include), 
// не включаемые в файл автоматически 


це метит 
// объявление класса формы TForml 
class TForml : public TForm 
{ 
__ published: // IDE-managed Components 
// размещенные на форме компоненты 
TButton *Buttonl; 
TLabel *Labell; 
void ‹ fastcall ButtonlClick(TObject *Sender) ; 


private: // User declarations 

// закрытый раздел класса 

// сюда могут помещаться объявления типов, переменных, функций, 
// включаемых в класс формы, но не доступных для других модулей 


public: // User declarations 

// открытый раздел класса 

// сюда могут помещаться объявления типов, переменных, функций, 

// включаемых в класс формы и доступных для других модулей 
__fastcall TForml (TComponent* Омпег); 

}; 

р иже ри тей 

extern PACKAGE TForml *Forml1; 

фата rn negli en ae 

// сюда могут помещаться объявления типов, переменных, функций, 

// которые не включаются в класс формы; 

// доступ к ним из других блоков возможен только при соблюдении 

// некоторых дополнительных условий 

#endif 
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Файл реализации: 


ь—————ы——ы—ы—ыЩб—_—————- 
#include <vcl.h> 

#pragma hdrstop 

#include "Unitl.h" 

To em Ts” amar ит тит тот 
#pragma package(smart init) 
#pragma resource "*.dfm" 


// сюда могут помещаться дополнительные директивы 
// препроцессора (в частности, include), 
// не включаемые в файл автоматически 


// объявление объекта формы Form] 

TForml *Forml; 

ао Penne nee има 

// вызов конструктора формы Form] 

__fastcall TForml::TForml (TComponent* Owner) 
TForm (Owner) 


// сюда вы можете поместить операторы, 
// которые должны выполняться при создании формы 


т aa alae 

// сюда могут помещаться объявления типов и переменных, 

// доступ к которым из других модулей возможен только при 
// соблюдении некоторых дополнительных условий; 

// тут же должны быть реализации всех функций, объявленных в 
// заголовочном файле, а также могут быть реализации любых 
// дополнительных функций, не объявленных ранее 


void _fastcall TForml::Button1lClick(TObject *Sender) 


{ 
Close(); 


} 


Рассмотрим подробнее эти файлы. Заголовочный файл начинается с ABTOMATH- 
чески включенных в него директив препроцессора. В частности, C++Builder сам 
помещает тут директивы include, подключающие копии файлов, в которых описа- 
ны те компоненты, переменные, константы, функции, которые вы используете в 
данном модуле. Однако, для некоторых функций такое автоматическое подключе- 
ние не производится. В этих случаях разработчик должен добавить соответствую- 
щие директивы include вручную. 

После директив препроцессора следует описание класса формы. Имя класса 
вашей формы — ТЕогт1. Класс содержит три раздела: __ published — открытый 
раздел, содержащий объявления размещенных на форме компонентов 'и обработ- 
чиков событий в них, private — закрытый раздел класса, и public — открытый 
раздел класса. В данном случае в разделе __ published вы можете видеть объявле- 
ния указателей на два компонента: компонент Buttonl типа TButton и компонент 
Labell типа TLabel. Там же вы видите объявление функции ButtonlClick — вве- 
денного пользователем обработчика события щелчка на кнопке Buttonl. Все, что 
имеется в разделе published, C++Builder включает в него автоматически в про- 
цессе проектирования вами формы. Так что вам не приходится, как правило, рабо- 
тать с этим разделом. А в разделы private и public вы можете добавлять свои объ- 
явления типов, переменных, функций. То, что вы или C++Builder объявите в раз- 
деле public, будет доступно для других классов и модулей. То, что объявлено в раз- 
деле private, доступно только в пределах данного модуля. Как вы можете видеть, 
единственное, что C++Builder самостоятельно включил в раздел public, это объяв- 
ление (прототип) конструктора вашей формы TForm1. 
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После объявления класса следует предложение РАСКАСЕ, которое включает- 
ся в файл автоматически и которое мы сейчас рассматривать не будем. После этого 
вы можете разместить объявления типов, переменных, функций, к которым при 
соблюдении некоторых дополнительных условий (см. раздел 1.5.5) будет доступ из 
других модулей, но которые не включаются в класс формы. 

Теперь рассмотрим текст файла реализации модуля. После автоматически 
включенных в этот файл директив препроцессора следует тоже автоматически 
включенное объявление указателя на объект формы Form1, а затем — вызов кон- 
структора формы. Тело соответствующей функции пустое, но вы можете включить 
в него какие-то операторы. После этого размещаются описания всех функций, объ- 
явленных в заголовочном файле. Вы можете также размещать здесь объявления 
любых типов, констант, переменных, не объявленных в заголовочном файле, и 
размещать описания любых функций, не упомянутых в заголовочном файле. 

Имена файлам модулей C++Builder дает по умолчанию: для первого модуля 
имя равно Оп 1, для второго Unit2 — ит.д. 


GORE a ОИ ОО ке НИЕ: 


Хороший стиль программирования reer 


Если в вашем приложении несколько модулей, сохраняйте их файлы под какими-то осмыс- 
ленными именами, изменяя тем самым имена модулей, заданные C++Builder по умолчанию. 
Вам проще будет работать с осмысленными именами, а не с именами Unit], Unit2, Unit3, ко- 
торые ни о чем не говорят. 


БАНИ ПИКЕ КЗ ИКИ УИ ИИКИ У SUSE EL EDISGE FS ESGEPRL IESE AIESBIEEEESL IDRIS SPIELE SELES ERI DEESEES PAA IASLERES EELS НИИ ЧИЧИ МАКИ ИРИНЕ ARABS УЧ 


1.5.5 Области видимости и доступ к объектам, переменным 
и функциям модуля 


1.5.5.1 Пример модуля, содержащего объекты и процедуры 


Теперь посмотрим; как можно вводить в модуль переменные, функции и OCy- 
ществлять к ним доступ. Ниже приведен текст кода модуля, в котором на форме 
размещены два компонента: кнопка Buttonl типа TButton и метка Labell типа 
TLabel. Кроме того, в модуле введен обработчик события, связанного со щелчком 
пользователя на кнопке, и в разных местах модуля введены переменные и функ- 
ции, чтобы можно было видеть, как получить к ним доступ. / 


Заголовочный файл: 


| —_—_—_ 

#ifndef Unitl1H 

#define Unitl1H 

| i 

#include <Classes.hpp> 

#include <Controls.hpp> 

#include <StdCtrls.hpp> 

#include <Forms.hpp> 

| дд 

Class TForml : public TForm 

{ 

_ published: // IDE-managed Components 
TLabel *Labell; 
TButton *Buttonl; 
void _fastcall ButtonlClick(TObject *Sender) ; 


private: // User declarations 

//Функция Е1 и переменна Ch6 доступны только в данном модуле 
void _fastcall Fl(char Ch); 
char Ch6; 


public: // User declarations 
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__fastcall ТЕогм1 (TComponent* Owner) ; 
// Переменная Chl и функция Е2 доступны для объектов, 


// любых классов и для других модулей, но со ссылкой 
// на объект 
char Chl; 
void _ fastcall F2(char Ch); 
}; 
Им———щ—щ—— 
extern PACKAGE TForml *Forml; 


// Глобальная переменная Ch2 и функция ЕЗ доступны в пределах 
// данного модуля; переменная Ch2 доступна в других модулях, 
// если определена там со спецификацией extern; 
.// Функция ЕЗ доступна в других модулях, если там содержится 
_// ее прототип | 

char Ch2; 

void F3(char Ch); 
#endif 


Файл реализации: 


ff 
#include <vcl.h> 
#pragma hdrstop 


#include "Unitl.h" 
if 
#pragma package(smart_ init) 
#pragma resource "*.dfm" 
TForml *Forml; 
__fastcall TForml::TForml (TComponent* Owner) 
TForm (Owner) 
{ 
} ‹ 
ь„———щ———— 
// Глобальная переменная Ch3 и функция Е4 доступны в пределах 
// данного модуля; переменная СЬЗ доступна в других модулях, 
// если определена там со спецификацией extern; 
// Функция Е4 доступна в других модулях, если там содержится 
// ее прототип 
пах ©6532 


void F4(char Ch) 
{ 
Forml->Labell->Caption = Forml->Labell->Caption + Ch + 
Forml->Chl1; 
} 
EA gae BMT AIG < тихие лань OTe EN 
void ° fastcall TForml::Fl1(char Ch) 
{ 4 
Labell->Caption = Labell->Caption + Ch + Chl; 
} 
| OL TT 
void _fastcall TForml::F2(char Ch) 
{ 


_ 


Labell->Caption = Labell->Caption + Ch + Chl; 
} к 
// 

void F3(char Ch) 
{ 
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Forml->Labell->Caption = Forml->Labell->Caption + Ch + 
Forml->Ch1; 

} 

/[——_ 

void _fastcall TForml::ButtonlClick(TObject *Sender) 

{ 

// Переменная Ch4 доступна только внутри данной функции 

char Ch4; 

СИТ: = 1". 

Ch2 “A fF 

Ch3 ‘> 3 

Ch4 = 'C'; 

Labell->Caption = ""; 

BstCnl); 

E2(Ch2).; 

F3(Ch3) ; 

F4(Ch4); 

Labell->Font->Color = clRed; 

} 


Помимо функции Button1Click обработки щелчка Ha кнопке Button! в код 3a- 
несено в разные места модуля еще несколько одинаковых функций: Е1 — F4, и не- 
сколько переменных символьного типа: Chl — Ch4. Сейчас мы не будем разби- 
раться подробно в самих функциях. Нам важно понять, как из функций обращать- 
ся к различным объектам и переменным. Но краткое описание того, что делают 
эти функции, надо дать. 

У компонента — метки типа TLabel имеется свойство Caption — надпись на 
метке. Каждая из функций Fl — Е4 берет значение этой надписи, прибавляет к 
ней символ, переданный в Hee как параметр Ch, прибавляет далее символ, храня- 
щийся в переменной Chl, и возвращает надпись с этими добавлениями обратно в 
метку. 

Обработчик щелчка на кнопке — функция TForm1::Button1Click, задает сим- 
вольным переменным Chl — Ch4 значения символов «-», «А», «В» и «С», затем 
очищает свойство Caption метки Labell, занося в него пустую строку, а затем по- 
очередно обращается к функциям Е1 — F4, передавая в них в качестве параметров 
различные символы. В заключение надпись метки окрашивается в красный цвет. 
Для этого используется свойство Font — шрифт объекта Labell. Это свойство само 
является объектом, имеющим свойство Color — цвет. Значение этого свойства из- 
меняет последний оператор процедуры TForm1::Button1Click. 


1.5.5.2 Доступ к свойствам и методам объектов 


Рассмотрим теперь, как получить из программы доступ к свойствам и методам 
объектов. Доступ к интересующим нас объектам — компонентам можно получить 
через объявленные в заголовочном файле модуля указатели на эти объекты. На- 
пример, в объявлении класса формы TForm1 в заголовочном файле имеется строка 


TLabel *Labell; 


Эта строка объявляет Labell как указатель Ha метку — объект типа TLabel. 
Если вы плохо представляете, что такое указатели, посмотрите в главе 13 раз- 
дел 13.7, или просто отнеситесь к тому, о чем будет рассказано ниже, как к некото- 
рому обязательному формализму. Честно говоря, программы в C++Builder часто 
можно писать, не задумываясь о сути этого формализма. 

Доступ к элементам класса (данным — свойствам и функциям — методам) 
обеспечивается одним из следующих двух способов. Можно использовать опера- 
цию стрелка (символ '-' и символ '>', записанные без пробела, т.е. ->) или опера- 
цию точка (.). Первая из них применяется при обращении к объекту через указа- 
тель на него, вторая — при обращении по имени переменной объекта или по ссыл- 
ке на него. 
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Посмотрите, например, в приведенном выше файле реализации модуля тек- 
сты функций ЕТ и F2. Вы увидите в них выражения вида Labell->Caption. Они 03- 
начают: свойство Caption объекта Labell. То же самое свойство Caption можно 
было бы получить и с помощью выражения (*Labell).Caption. Здесь операция ра- 
зыменование указателя (*Labell) дает сам объект, к которому можно применять 
операцию точка. 

Хотя эти два способа доступа к свойствам и методам объекта эквивалентны, 
обычно в C++Builder используется операция стрелка. Поэтому в дальнейшем изло- 
жении в данной книге мы практически всегда будем пользоваться этой формой за- 
писи. И если вы не очень представляете себе, что такое указатели, и не хотите пока 
смотреть пояснения в главе 13 в разделе 13.7, то просто запомните, что ко всем 
свойствам и методам объектов надо обращаться, включая перед ними символы 
«=>», 

Иногда свойство объекта является в свою очередь объектом. Тогда в обраще- 
нии к этому свойству указывается вся цепочка предшествующих объектов. Напри- 
мер, метки имеют свойство Font — шрифт, которое в свою очередь является объек- 
том. У этого объекта имеется множество свойств, в частности, свойство Color — 
цвет шрифта. Чтобы сослаться на цвет шрифта метки Labell, надо написать 
Labell->Font->Color (см. в тексте примера функцию TForm1::Button1Click). Это 
означает: свойство Color объекта Font, принадлежащего объекту Labell. 

Аналогичная нотация используется и для доступа к методам объекта. Напри- 
мер, для метки, как и для большинства других объектов, определен метод Hide, 
который делает метку невидимой. Если вы в какой-то момент решили сделать мет- 
ку Labell невидимой, можете написать оператор 


Labell->Hide(); 


1.5.5.3 Различие переменных и функций, включенных 
и не включенных в описание класса 


Теперь посмотрим, чем различаются переменные и функции, включенные и не 
включенные в описание класса. Переменные и функции, включенные в описание 
класса, обычно называются соответственно данными-элементами и функция- 
ми-элементами. Применительно к объектно-ориентированному проектированию в 
C++Builder чаще их называют свойствами и методами. В приведенном в разделе 
1.5.5.1 примере переменная Chi и функции Е1 и F2 включены в описание класса, 
а переменные Ch2, Ch3 и функции ЕЗ и F4 объявлены вне класса. В чем будет про- 
являться различие в их использовании? 

Если в приложении создается только один объект данного класса (в нашем 
примере — только один объект формы класса TForm1), то различие в основном 
чисто внешнее. Для функций, объявленных в классе, в их описании к имени функ- 
ции должна добавляться ссылка на класс с помощью так называемой бинарной 
операции разрешения области действия (::). В нашем примере имена функций FI, 
F2 и ButtonlClick в описании этих функций заменяются Ha ТЕогт1::ЕТ, 
TForm1::F2 и TForm1::Button1Click. Тем самым указывается, что речь идет о 
функциях класса TForm1. Для функций ЕЗ и Е4, объявленных вне класса, такого 
дополнения к имени не требуется. 

Необходимость добавления в имена функций, описанных в классе, ссылок на 
класс объясняется просто. Вы можете вне класса описать другую свою функцию с 
тем же именем (например, Е1), что и у функции класса. И тогда из функций, не 
описанных в классе, вы сможете ссылаться на обе эти функции F1, только на одну 
из них непосредственно — по имени Е1, а на другую через объект класса — 
Form1::F1. Благодаря этому, при описании своих функций вне класса вы можете 
даже не знать имен всех функций, описанных в классе (может быть этот класс опи- 
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сан в другом модуле, текст которого вы не видели), Никакой путаницы при этом не 
возникнет. 

Таким образом, применение операции разрешения области действия позволя- 
ет объявить в разных классах и вне классов переменные и функции с одинаковыми 
именами. В этом случае операция разрешения области действия указывает, о ка- 
кой именно переменной или функции идет речь. В некоторых случаях при работе с 
C++Builder разрешение области действия приходится делать вручную. Это проис- 
ходит в тех случаях, когда компилятор выдает сообщение, что не может выбрать 
одну из нескольких альтернатив, например, не знает, к какому классу относится 
указанный вами метод. 

Обращение к переменным и функциям, описанным внутри и вне класса, из 
функций, описанных вне класса, различается. К, переменным и функциям, опи- 
санным вне класса, обращение происходит просто по их именам, а к переменным и 
функциям, описанным в классе, через имя объекта класса. Поэтому в нашем при- 
мере в функциях F3 и Е4 обращение к переменной Chi имеет вид Еогт1->СВ1. По 
той же причине и обращение к свойству Caption объекта Labell в этих функциях 
имеет вид Form1->Labell->Caption. Только через ссылку на объект Form! внеш- 
ние по отношению к классу функции могут получить доступ ко всему, объявленно- 
му в классе. 

Все эти ссылки на объект не требуются в функциях, объявленных в классе. 
Поэтому в функциях TForm1::F1, TForm1::F2 и TForm1::Button1Click ссылки Ha 
переменную Chi и на объект Labell не содержат дополнительных ссылок на объ- 
ект формы. 

Если в приложении создается несколько объектов одного класса, например, 
несколько форм класса TForm1 (как вы увидите впоследствии, это часто делается 
в приложениях с интерфейсом множества документов MDI), то проявляются более 
принципиальные различия между переменными, описанными внутри и вне клас- 
са. Переменные вне класса (в нашем примере Ch2 и Ch3) так и остаются в одном 
экземпляре. А переменные, описанные в классе (в нашем примере Ch1), тиражи- 
руются столько раз, сколько объектов данного класса создано. Т.е. в каждом объ- 
екте класса TForm1 будет своя переменная СВ] и все они друг с другом никак не 
будут связаны. Таким образом, в переменную, описанную внутри класса, можно 
заносить какую-то информацию, индивидуальную для каждого объекта данного 
класса. А переменная, описанная в модуле вне описания класса, может хранить 
только одно значение. 

Отметим без детальных пояснений еще одну особенность, которую вы уже, ве- 
роятно, заметили в приведенных текстах файлов. Перед именами функций-эле- 
ментов класса ставится опция компилятора __fastcall. Не вдаваясь в детали ска- 
жем, что эта опция влияет на процесс компиляции и обеспечивает передачу пара- 
метров функции в быстрые регистры, что ускоряет вызов функции. Для функ- 
ций-элементов классов эту опцию следует указывать всегда. Для других функций 
ее можно указывать, а можно и не указывать. Впрочем, эту опцию целесообразно 
указывать и для функций, не являющихся элементами класса (в приведенном 
примере это не сделано просто чтобы подчеркнуть различие между функция- 
ми-элементами и прочими функциями). 

В заключение просуммируем изложенные правила. 


Ш В описание функций-элементов должна добавляться ссылка на класс с помо- 
щью операции разрешения области действия (::). 

Ш Функции-элементы объявляются и описываются с применением опции компи- 
лятора __fastcall. 


Ш В функциях-элементах обращение к другим функциям-элементам и дан- 
ным-элементам того же класса может осуществляться без указания на объект. 
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Ш В функциях, не являющихся элементами класса данного объекта, доступ к 
функциям-элементам (методам) и данным-элементам (свойствам) осуществля- 
ется через указатель на объект с помощью операции стрелка (->) или (значите- 
льно реже) с помощью разыменования указателя на объект и операции точ- 
ка (.). 


1.5.5.4 Области видимости переменных и функций 


Теперь остановимся на вопросе об областях видимости или областях действия 
элементов программы — переменных и функций, т.е. о связи места их объявления 
в программе и места их использования. Частично этот вопрос мы уже затрагивали 
в предыдущем разделе, не упоминая о самом понятии область видимости. 

При решении вопросов видимости важнейшее значение имеет понятие блока. 
Блок — это фрагмент кода, ограниченный фигурными скобками «{ }». Перемен- 
ные, объявленные вне какого-то блока, являются глобальными и имеют областью . 
видимости файл. Если какая-то переменная объявлена внутри блока, то ее область 
видимости — блок. Т.е. это локальная переменная, которую можно использовать 
только от момента ее объявления до первой встретившейся в коде закрывающейся 
фигурной скобки «}». Если имеются вложенные блоки, то переменная видна и в 
этих вложенных блоках. Если в каком-то блоке объявлена переменная с тем же 
именем, какое имеет глобальная переменная или переменная, объявленная во 
внешнем блоке, то это внутреннее объявление делает невидимой одноименную 
внешнюю переменную. 


Например: 
5, ре 5 ee // объявление глобальных переменных 
{ 
int i= 5, 3) = 2; // объявление переменных внешнего блока 
// видны переменные 7, К 
// и переменная 1 этого блока 
{ 
tht: A. eT? // объявление переменной 1 внутреннего блока 


// видны переменные 7, К 
// и переменная 1 внутренняя 


// видны переменные 7, К 
// и переменная 1 внешнего блока 


} 


Локальная переменная не только видима в пределах блока, в котором она объ- 
явлена. Ее время жизни тоже определяется временем выполнения блока. Перемен- 
ная создается в момент входа в блок и разрушается в тот момент, когда управление 
выходит за пределы блока. Таким образом подобная переменная не может сохра- 
нять какие-то значения в промежутках между выполнением операторов блока. В 
приведенном выше примере переменная 1 во внутреннем блоке будет создаваться 
каждый раз, когда управление передается в этот блок, ей каждый раз будет при- 
сваиваться значение 7 и она каждый раз будет разрушаться при выходе из блока. 

Сказанное выше о времени жизни относится к так называемым автоматиче- 
ским (auto) переменным и не относится к статическим переменным, объявленным 
как static. Например: 


Static: лем. 
Такие статические переменные существуют все время работы программы и 
инициализируются только один раз. Таким образом, в этих переменных можно на- 


капливать какую-то информацию. Например, они могут служить счетчиками чис- 
ла обращений к блоку. 
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Выше говорилось, что если во внутреннем блоке объявлена переменная с тем 
же именем, что во внешнем блоке, или с тем же именем, что и глобальная перемен- 
ная, то соответствующая внешняя или глобальная переменная в блоке не видна. 
Однако, в С++ имеется унарная операция разрешения области действия, позво- 
ляющая все-таки во внутреннем блоке обращаться к глобальной переменной с тем 
же идентификатором. Операция обозначается двумя символами двоеточия ‹::». 
Если поставить эти символы перед идентификатором переменной, то обращение 
будет к глобальной переменной с этим именем. Так в приведенном выше примере 
во внутреннем блоке можно, например записать оператор 


о а © +e Te 


Этот оператор присвоит внутренней переменной i значение на единицу боль- 
шее значения глобальной переменной 1. 

Подчеркнем, что таким образом можно получить доступ только к одноимен- 
ной глобальной переменной, а не к локальной переменной, описанной во внешнем 
блоке. 

Теперь остановимся на проблемах видимости переменных в приложениях, 
имеющих несколько модулей. Пусть вы имеете два модуля — Unitl и Unit2 и xo- 
тите в модуле Unit2 видеть и использовать переменные и функции, объявленные в 
модуле Unitl. Вы можете в модуле Оп и 2 видеть те переменные, которые являются 
глобальными в модуле Оп Т, т.е. объявлены вне каких-нибудь функций в заголо- 
вочном файле модуля или в его файле реализации. Но для того, чтобы это было 
возможно, вы должны повторно объявить их (без инициализации) в модуле Unit2 
со спецификацией extern. Например, если в модуле Unitl имеется объявление гло- 
бальной переменной 


int al = 10; 


то в модуле Unit2 вы можете использовать эту переменную, если запишете объяв- 
ление 


extern int al; 


Причем, это He зависит OT того, включили ли вы директивой #include заголо- 
вочный файл Unitl.h в модуль Unit2, или нет. 

Отметим еще одну особенность использования переменных, описанных в дру- 
гом модуле. Если в заголовочном модуле Unitl объявлена описанная выше пере- 
менная al, а в модуле Unit2 вы включили директивой #теа4е заголовочный 
файл Unitl.h, но не записали объявление этой переменной со спецификацией 
extern (вообще не дали объявление al), то в модуле Unit2 будет создана копия пе- 
ременной al, инициализированная согласно объявлению в Unitl. Но это будет ко- 
IIMA, совершенно изолированная от переменной al в модуле Unitl. В модулях 
Unitl и Unit2 будут существовать две различные переменные с одним именем al. 
И изменение одной из них никак не скажется на значении другой. 

Все сказанное относится только к глобальным переменным. Локальные пере- 
менные, объявляемые внутри функций, невозможно видеть в другом модуле. 

Теперь рассмотрим видимость функций в приложениях, имеющих несколько 
модулей. Если в модуле Unitl в ero заголовочном файле вне описания класса вы 
объявили некоторую функцию F, то в другом модуле Unit2 вы можете использо- 
вать ее при выполнении одного из двух условий: 


Ш вы включаете директивой #include в модуль Unit2 заголовочный файл 
Uniti.h 


Ш вы повторяете в модуле Unit2 (в заголовочном файле или файле реализации) 
объявление функции Е 


В обоих случаях вы сможете вызвать функцию F из любого места модуля 
Unit2. — 
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Если же функция Е объявлена в модуле Unitl не заголовочном файле, а в фай- 


ле реализации, то единственный способ использовать ее в модуле Unit2 — повто- 
рить в нем объявление функции. 


Если вы хотите предотвратить возможность обращения к функции из другого 


модуля, ее надо объявить со спецификацией static. Например: 


Static void F(void); 


Подведем некоторые итоги проведенного рассмотрения проблем видимости пе- 


ременных и функций. 


Переменные, объявленные в заголовочном файле модуля или в файле его pea- 
лизации вне описания класса и функций, являются глобальными. Они доступ- 
ны везде внутри данного модуля. Для доступа к ним из внешних модулей в 
этих модулях должно быть повторено их объявление (без инициализации) с 
добавлением спецификации extern. В рассмотренном примере это относится к 
переменным Ch2 и Ch3. 


Функции, объявленные в заголовочном файле модуля вне описания класса, 
являются глобальными. Они доступны везде внутри данного модуля. Для до- 
ступа к ним из внешних модулей в этих модулях или надо повторить их объяв- 
ление, или включить директивой #Hinclude заголовочный файл того модуля, в 
котором функции описаны. В рассмотренном примере это относится к функ- 
ции ЕЗ. | 


Функции, объявленные в файле реализации модуля, являются глобальными. 
Они доступны везде внутри данного модуля. Для доступа к ним из внешних 
модулей в этих модулях надо повторить их объявление. В рассмотренном при- 
мере это относится к функции Е4. 


Элементы (переменные и функции), объявленные в классе в разделе private, 
видимы и доступны только внутри данного модуля. При этом из функций, 
объявленных внутри класса, к ним можно обращаться непосредственно по 
имени, а из других функций — только со ссылкой на объект данного класса. В 
рассмотренном примере это относится к процедуре Е1. Если в модуле описано 
несколько классов, то объекты этих классов взаимно видят элементы, описан- 
ные в их разделах private. 


Элементы, объявленные в классе в разделе public, видимы и доступны для 
объектов любых классов и для других модулей, в которых директивой #inclu- 
де включен заголовочный файл данного модуля. При этом из объектов того же 
класса, к ним можно обращаться непосредственно по имени, а из других объ- 
ектов и процедур — только со ссылкой на объект данного класса. В рассмот- 
ренном примере это относится к переменной Chl и процедуре F2. 


В классах, помимо обсуждавшихся ранее, могут быть еще разделы ргофес- 
ted — защищенные. Элементы, объявленные в классе в разделе protected, ви- 
димы и доступны для любых объектов внутри данного модуля, а также для 
объектов классов — наследников данного класса в других модулях. Объекты 
из других модулей, классы которых не являются наследниками данного клас- 
са, защищенных элементов не видят. 


Элементы, объявленные внутри функции или блока (в рассмотренном примере 
это переменная Ch4 объявленная внутри функции TForm1::Button1Click), яв- 
ляются локальными, т.е. они видимы и доступны только внутри данной функ- 
ции или данного блока. При этом время жизни переменных, объявленных 
внутри функции или блока, определяется временем активности данного бло- 
ка. Так переменная Ch4 в нашем примере создается в момент вызова функции 
TForm1::Button1Click и уничтожается при завершении работы этой функции. 
Сделать локальную переменную существующей постоянно можно с помощью 
спецификации static. 
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Ш Переменные и функции, объявленные в головном файле проекта, являются гло- 
бальными для этого файла. Если требуется доступ к ним из других модулей, то 
для функций в них должны быть повторены их объявления, а для переменных 
— повторено объявление (без инициализации) со спецификацией extern. 


Ш Если во внутреннем блоке объявлена переменная с тем же именем, что BO 
внешнем блоке, или с тем же именем, что и глобальная переменная, то соот- 
ветствующая внешняя или глобальная переменная в блоке не видна. В этом 
случае подучить доступ к одноименной глобальной переменной можно только 
с помощью унарной операции разрешения области действия ‹::». 


Более подробные сведения об областях видимости переменных и функций вы 
можете найти в главе 12 в разделе 12.6. 


1.5.5.5 Передача параметров в функции 


Параметры в функции могут передаваться в основном двумя способами: по 
значению и по ссылке. То, что вы могли видеть в рассмотренном ранее примере — 
это передача параметра по значению. В этом случае в заголовке функции указыва- 
ется имя параметра и его тип. Например: 


void Fl(char Ch); 


В этом случае Ch — это локальное UMA формального параметра, используемое 
только внутри данной функции. При вызове этой функции, который может иметь 
вид: 

F1(Ch2); 


в памяти создается временная переменная с именем Ch, и в нее копируется значе- 
ние аргумента Ch2. На этом связь между Ch и Ch2 разрывается. Вы можете изме- 
нять внутри функции значение Ch, но это никак не отразится на значении внеш- 
ней переменной Ch2, указанной в вызове функции в качестве аргумента. 

Такая передача параметров по значению имеет свои достоинства и недостатки. 
Достоинство заключается в том, что функция не может испортить переданный в 
нее аргумент. Это важно для надежной работы приложения и позволяет разраба- 
тывать функции, не задумываясь O TOM, не использованы ли где-то в программе те 
же имена параметров. Но у передачи параметра по значению имеется и ряд недос- 
татков. Во-первых, функция не может изменить значение аргумента, а иногда это 
очень желательно. Во-вторых, копирование значения аргумента требует дополни- 
тельных затрат времени и памяти для хранения копии. Если речь идет о какой-то 
переменной простого типа, это, конечно, не существенно. Но если, например, аргу- 
мент — это массив из тысячи элементов, то соображения затрат времени и памяти 
могут стать существенными. И в-третьих, после окончания работы функции вре- 
менная переменная, хранившая значение параметра, уничтожается. Поэтому ее 
нельзя использовать, например, для накопления какой-то информации. 

Для реализации второго способа передачи информации — по ссылке, перед 
именем параметра в заголовке функции должен быть записан символ амперсанта 
'&'’. Например: 

void Fl(char &Ch); 


В этом случае не происходит копирования значения аргумента в локальную, 
временную переменную в процедуре. Процедура реально работает не с параметром, 
а со ссылкой — указателем на место хранения аргумента в памяти. И любые изме- 
нения параметра Ch, произведенные в процедуре, в действительности относятся не 
к этому параметру, а к тому аргументу, который передан при вызове процедуры. 
Таким образом, передача параметра по ссылке позволяет возвращать информацию 
из функции в вызвавитую его внешнюю процедуру. 

Более подробную информацию о передаче параметров в функции вы найдете в 
разделе 12.5.2 главы 12. 
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1.5.6 Работа с указателями на объекты 


Основой объектно-ориентированного программирования являются объекты и 
классы. В предыдущих разделах мы уже рассмотрели тот минимум сведений о 
них, который необходим для начала продуктивной работы с C++Builder. В данном 
разделе мы рассмотрим более сложные и тонкие вопросы работы с объектами. Чи- 
татель, слабо знакомый или вовсе не знакомый с указателями, может без особых 
потерь пропустить пока этот раздел и сразу перейти к материалу главы 2. Это не 
помешает ему эффективно работать и создавать свои интересные приложения. А 
когда возникнет потребность разобраться в каких-то вопросах, связанных с объек- 
тами и указателями на них, можно, имея уже некоторый опыт, вернуться к этому 
разделу и разобраться в неясных деталях. Но автор все-таки решил вынести эти © 
вопросы в начало книги, поскольку в дальнейшем изложении придется достаточно 
часто ссылаться на рассмотренные ниже приемы распознавания объектов и работы 
с ними. Впрочем, если нет особого желания углубляться в детали, можно рассмат- 
ривать эти приемы просто как некую данность и копировать их в свое приложе- 
ния, когда потребуется решать соответствующие задачи. 


1.5.6.1 Указатели на объекты 


Указатель на объект — это переменная, в которой хранится ссылка на объект 
некоторого класса, т.е. на место в памяти, где размещен объект. Объявление (соз- 
дание) указателя на объект некоторого класса (типа) производится оператором: 


<тип> *<указатель>; 


Например, следующее объявление создает указатель на объект класса TLabel 
(метку): 


TLabel *Lab; 


Создается не сам объект, а только указатель Ha любой объект данного типа. В 
момент его создания указатель инициируется нулем. Нуль не может ассоцииро- 
ваться ни с каким объектом в памяти. Поэтому определить, занесена в указатель 
ссылка на конкретный объект, или нет, можно, например, оператором: 


ТЕ ДЬав ee Би, т 


Здесь многоточием обозначены некие действия, которые надо делать при OT- 
сутствии ссылки. 

В C++ предопределена константа NULL, которая эквивалентна нулевому ука- 
зателю. Поэтому приведенный выше оператор эквивалентен следующему: 


if (Lab == NULL) ...; 


В дальнейшем указателю можно присвоить ссылку Ha любой объект соответст- 
вующего класса простым присваиванием. Например: 


Lab = Labell; 


Тогда указатель Lab становится Kak бы псевдонимом объекта Labell. Оба ука- 
зателя: и Lab, и Labell ссылаются на один и тот же объект. Например, 
Labell->Caption и Lab->Caption ссылаются на надпись одной и той же метки. 

В качестве типа объекта, на который ссылается указатель, можно задать Void. 
Например: 

void *Lab; 


Такой указатель Ha VOid можно рассматривать как указатель на объект любого 
типа. В дальнейшем этому указателю можно задать простым присваиванием ссыл- 
ку на объект любого типа. Но разыменование такого указателя требует примене- 
ния явного приведения типов, поскольку компилятор не знает, на объект какого 
типа в действительности ссылается указатель. Поэтому для него нельзя, напри- 
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мер, после присваивания ему ссылки на метку Labell (как в приведенном ранее 
примере) написать просто Lab->Caption. Для ссылки на надпись Caption через 
этот указатель надо писать ((TLabel *)Lab)->Caption, то есть явным образом при- 
водить тип указателя Lab к типу «указатель на объект класса TLabel>. 


Можно создавать ссылку на объект с помощью указателя не на истинный 
класс объекта, а на один из классов, которым наследует класс данного объекта. 
Дело в том, что любой объект может рассматриваться не только как объект своего 
класса, но и как объект любого класса-предка. Это в общем достаточно естественно 
для обычного понимания объектов в реальном мире. Так любой автомобиль может 
рассматриваться не только как объект автомобилей данной марки, например, 
«Жигули», но и как один из объектов более общих классов — автомобили, средст- 
ва передвижения и т.д. Так же и объект в С++ может рассматриваться как объект 
любого из классов предков. 

Например, универсальным указателем на любой компонент может быть указа- 
тель на класс TControl — базовый класс всех компонентов: 


TControl *Contr; 


Такому указателю можно непосредственно присваивать ссылку Ha любой KOM- 
понент. Например, 


Contr = Labell; 


При таком присваивании компилятор сам производит необходимое приведе- 
ние типов. 

Но с этим указателем Contr уже нельзя работать непосредственно как с указа- 
телем на метку. Для него известны только свойства, объявленные в классе 
TControl. Это такие общие свойства всех компонентов, как, например, Маше — 
имя. Непосредственная ссылка на специфические свойства классов — наследников 
невозможна. Например, попытка написать код Contr->Caption вызовет сообщение 
компилятора об ошибке с текстом: « ‘Controls::TControl::Caption’ is not accessible.», 
смысл которого заключается в том, что свойство Caption в классе TControl недос- 
тупно. Поэтому для доступа к методам и свойствам, отсутствующим в классе’ 
TControl, надо осуществлять явное приведение типа указателя, например: 


((TLabel *)Contr)->Caption 


Этот код как бы говорит компилятору: «Рассматривай Contr как ссылку Ha 
класс TLabel». И тогда никаких сообщений об ошибках не возникает. 

Причина, по которой в ряде случаев для хранения ссылок на объекты исполь- 
зуются указатели на объекты базовых классов, заключается в удобстве групповой 
обработки объектов разных классов с помощью общих для них методов или для за- 
дания значений общих для них свойств. Этот вопрос будет подробнее рассмотрен в 
следующем разделе. 


Выше рассматривалось присваивание указателю ссылки на уже существую- 
щий объект. Но создание нового объекта тоже всегда связано с созданием указате- 
ля на него. Для создания объекта применяется операция пем. В ней после ключе- 
вого слова New указывается класс компонента. Если объект является компонен- 
том, то после класса компонента в скобках указывается компонент — хозяин 
(Owner). Кроме того после создания компонента обязательно надо указать его po- 
дителя (Parent) — компонент, на котором размещается новый компонент. Пока не 
задан родитель, компонент нельзя увидеть. 

Рассмотрим следующий код: 

TLabel *Labl = new TLabel (Forml); 


Labl->Parent Forml; 
Labl->Caption = "Это новая метка"; 
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Первый из этих операторов создает указатель Labl на объект-метку типа 
TLabel и создает с помощью New сам объект-метку с хозяином Form1. Последую- 
щие операторы используют указатель Labl для задания свойств метки: размеща- 
ют ее на форме Еогт1 и задают на ней надпись «Это новая метка»: 

Поскольку никакие другие свойства метки не заданы, они будут установлены 
`конструктором класса TLabel с умолчанием. Этот конструктор неявным образом 
вызывается операцией new. 


1.5.6.2 Идентификация объекта неизвестного класса 


В предыдущем разделе было рассмотрено объявление указателей на объекты и 
было показано, что тип такого указателя может определяться не обязательно клас- 
сом конкретного объекта, но и любым классом-предком. В C++Builder это исполь- 
зуется достаточно широко. Например, во все обработчики событий передается в ка- 
честве параметра Sender — указатель на объект, в котором произошло событие. 
Зачем нужен этот параметр? Конечно, если вы пишете обработчик какого-то собы- 
тия в конкретном компоненте, например, пишете для кнопки Ви Йоп1 обработчик 
события OnClick, которое наступает при щелчке на ней мыши, то параметр Sender 
вам не нужен. Вы и без этого параметра знаете, что событие произошло именно в 
кнопке Buttonl. Но часто для разных компонентов нужна идентичная реакция на 
идентичные события. В этих случаях писать отдельные одинаковые обработчики 
для разных компонентов нерационально. Можно ограничиться одним обработчи- 
ком для всех этих компонентов. Это обеспечит существенно более компактный 
код, его будет проще отлаживать, да и размер загрузочного модуля вашей про- 
граммы будет меньше. 

В этой книге вы найдете немало таких примеров. Приведем в чисто описатель- 
ном плане некоторые из них. В главе 4 в разделах 4.1.8 и 4.3.2.2 описана задача 
разработки окон редактирования таких, чтобы при нажатии пользователем клави- 
ши Enter фокус передавался бы следующему окну редактирования. Обработка на- 
жатия клавиш во всех таких окнах может быть сделана одним обработчиком, что, 
конечно, лучше, чем писать одинаковые обработчики для каждого окна. В той же 
главе в разделе 4.2.5 описана задача синхронного масштабирования всех оконных 
компонентов, содержащихся в некотором контейнере. С помощью указателя на ба- 
зовый класс TWinConrol всех оконных компонентов эта задача решается простым 
циклом, причем изменяются размеры всех оконных компонентов, независимо от 
того, к какому классу каждый из них принадлежит. Это много эффективнее, чем 
писать отдельный оператор для каждого компонента. В разделе 4.4.1 описывается 
техника Drag&Drop — перетаскивание информации об объектах. В этом примере 
также обобщенный подход позволяет обойтись одним обработчиком события для 
разных объектов и даже разных классов объектов. В главе 3 в разделе 3.8.7 описа- 
на организация поиска фрагмента текста в диалогах Найти и Заменить. Для этих 
разных классов компонентов процедура поиска одна и та же, так что ее можно осу- 
ществлять одним обработчиком. 

Подобных примеров в книге будет много. Причем во многих случаях вопрос не 
только в эффективности кода. Если вы в процессе проектирования добавляете в 
приложение какие-то новые компоненты, то в вашем коде, написанном в общем 
виде, ничего не меняется. Новые компоненты автоматически обрабатываются теми 
же обработчиками. А если бы вы не использовали такой обобщенный подход, вам 
пришлось бы для каждого нового компонента писать новый код. 

Не останавливаясь пока на деталях перечисленных примеров, рассмотрим об- 
щие подходы к подобным задачам. Параметр Sender, используемый в ряде этих 
примеров, объявлен в заголовках функций в C++Builder как TObject *Sender, т.е. 
как указатель на объект типа TObject. Класс TObject, как вы можете увидеть в 
разделе 16.4 главы 16, является базовым классом всех «омпонентов в C++Builder. 
Но в нем не объявлено никаких свойств, которые можно было бы использовать в 
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обработчике события. Поэтому при обращении к каким-то свойствам объектов вам 
надо явным образом осуществлять приведение типа параметра Sender к тому клас- 
су, в котором требуемые свойства объявлены. Пусть, например, вы пишете обра- 
ботчик, который должен в качестве надписи (свойство Caption) метки Labell вы- 
водить текст: «Произошло событие в компоненте ...». Имя компонента, которое 
вам надо включать в эту надпись, содержится в свойстве Мате. Но это свойство по- 
является только начиная с класса TComponent (см. главу 16 раздел 16.4) Значит 
именно к этому классу вам надо привести тип параметра Зеп4ег. Тогда соответст- 
вующий оператор будет иметь вид: 
Labell->Caption = "Произошло событие в компоненте " + 
((TComponent *) Sender) ->Name; 


Выражение ((TComponent *)Sender) является приведением типа параметра 
Sender к типу указателя на объект класса TComponent. Только в этом классе и в 
его потомках появляется свойство Name, которое вам нужно. Приведенный опера- 
тор будет работать для любых компонентов: окон, меток, кнопок и т.д., поскольку 
классы всех компонентов являются производными от ТСотропепф. 

Если подобное приведение типов требуется во многих операторах вашей функ- 
ции, то для сокращения записи можно один раз определить указатель на объект 
Sender как указатель на требуемый класс, а затем во всех операторах использо- 
вать его. Это сделано, например, в следующем коде: 


TComponent *Obj = (TComponent *) Sender; 


Labell->Caption="IIpou3somno событие в компоненте " + Obj->Name; 


Первый из этих операторов объявляет переменную Obj как указатель на объ- 
ект класса TComponent и с помощью явного приведения типа присваивает этому 
указателю ссылку на тот объект, на который указывает Sender. После этого пере- 
менную Obj можно везде использовать как указатель на этот объект. 

Аналогично, если вы хотите применить к параметру Sender некоторый метод, 
объявленный в классах-наследниках, вы должны привести тип указателя к тому 
классу, где этот метод имеется. Например, если вы хотите увеличить масштаб 
оконного компонента, указателем на который является Sender, вы должны при- 
вести его тип к указателю на объект класса TWinControl (или одного из производ- 
ных от него классов), так как только начиная с базового класса всех оконных ком- 
понентов TWinControl объявлен требуемый вам метод ScaleBy. Соответствующий 
оператор будет иметь вид: 


((TWinControl *) бепаег) ->5са1еВу (11,10); 
В ряде случаев требуется определить истинный класс объекта, на который 


указывает параметр Sender. Это можно сделать с помощью метода ClassName, 
объявленного в классе TObject как 


ShortString _fastcall ClassName(); 

Функция ClassName возвращает строку типа ShortString, содержащую ис- 
тинный класс объекта. Например, оператор 

Labell->Caption = Sender->ClassName (); 
может выдать текст «TButton», если Sender указывает на кнопку типа TButton. 


Функцию ClassName можно использовать для выполнения каких-то действий 
с объектами только одного конкретного класса. Например, оператор 


if (ЗЕг1па (Зепаег->С1аззМаме ()) == "TLabel") 


on of 


обеспечивает выполнение неких действий (обозначенных многоточием) только для 
объектов класса TLabel. 


es a? | 
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Для тех же целей может использоваться еще одна функция — ClassNamels, 
объявленная в классе TObject как: 


bool _fastcall С1аззМамет$ (сопзЕ AnsiString string); 


Эта функция возвращает true, если класс объекта совпадает с заданным пара- 
метром string. При использовании этой функции приведенный выше пример при- 
обретает вид: 


if (Sender->ClassNamels ("TLabel") ) 


.й 


В приведенных ранее примерах использования свойств и методов класса, к ко- 
торому приводится указатель на класс-предшественник, вас может подстерегать 
некая опасность. Выше был приведен пример масштабирования компонента с ис- 
пользованием метода ScaleBy, объявленного в классе TWinControl. Но если ис- 
тинный класс объекта, на который указывает Sender, окажется не потомком клас- 
ca TWinControl (например, меткой TLabel, которая не наследует TWinControl), то 
метод ScaleBy не сработает. Еще более неприятные и непредсказуемые результаты 
получатся, если вы обратитесь к свойству, отсутствующему у компонента. 

Поэтому, если нет уверенности, что применяемый метод или свойство имеется 
в обрабатываемом объекте, надо предварительно проверить, является ли класс 
объекта потомком того класса, в котором требуемый метод или свойство’ объявле- 
ны. Например, прежде, чем применять метод ScaleBy, надо убедиться, что класс 
объекта является потомком TWinControl. 

Для этих целей можно воспользоваться методом InheritsFrom, объявленным в 
классе TObject и, следовательно, имеющимся в любых компонентах. Объявление 
этого метода: 


bool _fastcall InheritsFrom(TClass aClass); 


Метод возвращает true, если класс данного объекта является потомком класса 
aClass, указываемого как параметр метода. Этот параметр имеет тип TClass, кото- 
рый может создаваться операцией __classid: 


__classid(classType) 


Аргументом этой операции является обычное имя класса, например, 
TWinControl. 

Таким образом, проверка, является ли класс объекта, на который указывает 
Sender, потомком TWinControl, может осуществляться оператором: 


if (Sender->InheritsFrom(  classid(TWinControl) ) ) 

С учетом этого приведенный ранее пример масштабирования методом ScaleBy 
оконных компонентов более грамотно должен осуществляться следующим опера- 
тором: 


if (Sender->InheritsFrom( classid(TWinControl) ) ) 
((TWinControl *)Sender) ->5са1еВу (11,10); 


Еще одна функция — ClassParent, объявленная в классе TObject, возвращает 
класс, являющийся непосредственным предком класса данного объекта. Функция 
объявлена как: 


TClass _fastcall С1аззРагепе () 


Если данный класс не имеет предшественников (т.е. это класс TObject), то воз- 
вращается NULL. 

Функция ClassParent, используемая в цикле, позволяет восстановить всю ие- 
рархию класса объекта. Следующий код заносит в список строки, перечисляющие 
все классы, встречающиеся на пути по дереву классов от TObject до класса, на ко- 
торый указывает параметр Sender. 
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TClass ClassRef= Sender->ClassType (); 
ListBox1l->Clear(); 


while(ClassRef != NULL) 
{ 


ListBoxl->Items->Add(ClassRef->ClassName()); 
ClassRef = ClassRef->ClassParent(); 


} 


Tak, если Sender указывает Ha объект типа TButton, то в списке ListBox1 ока- 
жется текст: 

TButton 

TButtonControl 

TWinControl 

TControl 

TComponent 

TPersistent 

TObject 


На этом мы закончим наше первое знакомство с С++. Это знакомство будет 
продолжаться на всем протяжении книги, а для более глубокого изучения вы все- 
гда можете воспользоваться главами 12 и 13 справочной части книги. Но и сейчас 
вы уже готовы начать работать непосредственно с C++Builder и создавать свои пер- 
вые приложения. Этим вы и займетесь в следующей главе. 


Глава 


Система визуального 
объектно-ориентированного 
программирования C++Builder 


2.1 Что может C++Builder 5 


C++Builder 5 — мощная система визуального объектно-ориентированного 


проектирования. Он сам и поставляемые с ним программные продукты позволяют 
решать следующий круг задач: 


Быстро создавать профессионально выглядящий оконный интерфейс для лю- 
бых приложений даже начинающим программистам. Интерфейс удовлетворя- 
ет всем требованиям Windows, настраивается на используемую систему, по- 
скольку использует многие функции, процедуры, библиотеки Windows. 


Создавать приложения любой сложности и любого назначения: офисные, бух- 
галтерские, инженерные, информационно-поисковые — никаких преград пе- 
ред C++Builder и лежащим в его основе ‘языком С++ нет. 


Создавать современный пользовательский интерфейс для любых ранее разра- 
ботанных программ DOS и Windows. Нередко в учреждении или фирме суще- 
ствуют и успешно эксплуатируются прикладные программы, разработанные в 
разное время, разными коллективами, для разных операционных систем. С 
помощью C++Builder эти приложения можно снабдить современным удобным 
оконным интерфейсом, объединить разрозненные приложения в единую сис- 
тему, обеспечить их стилистическое единство, наладить обмен информации 
между приложениями. 


Создавать свои библиотеки .DLL компонентов, форм, функций, которые затем 
можно использовать из других языков программирования. 


Создавать мощные системы работы с локальными и удаленными базами дан- 
ных любых типов. Подход, используемый в C++Builder, позволяет получить 
доступ к базам, созданным на любой платформе: InterBase, Microsoft Access, 
FoxPro, Paradox, dBase, Sybase, Microsoft SQL, Oracle и др. 


Создавать базы данных многих типов с помощью инструментария C++Builder. 


Автономно отлаживать приложения работы с базами данных на локальном 
сервере InterBase, поставляемом вместе с C++Builder, с последующим выхо- 
дом в сеть. 


Формировать и печатать из приложения сложные отчеты, включающие табли- 
цы, графики и т.п. самого различного назначения. 

Связываться из своего приложения с такими продуктами Microsoft, как 
Word, Excel и другие, используя все их богатейшие возможности. 

Создавать системы помощи (Help), как для своих приложений, так и для лю- 
бых других, с которыми, в частности, можно работать просто через Windows. 
Создавать профессиональные программы установки приложений Windows, 
учитывающие всю специфику и все требования Windows. В частности, для 
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этого можно использовать поставляемую вместе с C++Builder программу Ins- 
tallShield Express. 


Ш и многое другое. 


2.2 Интегрированная Среда Разработки (ИСР) 
C++Builder 


2.2.1 Общий вид окна UCP 


Интегрированная Среда Разработки (Integrated Development Environment — 
IDE, в дальнейшем мы будем использовать для нее аббревиатуру UCP) — это среда, 
в которой есть все необходимое для проектирования, запуска и тестирования при- 
ложений и где все нацелено на облегчение процесса создания программ. ИСР ин- 
тегрирует в себе редактор кодов, отладчик, инструментальные панели, редактор 
изображений, инструментарий баз данных — все, с чем приходится работать. Эта 
интеграция предоставляет разработчику гармоничный набор инструментов, допол- 
няющих друг друга. Более того, как вы увидите в дальнейшем, вам предоставлена 
возможность расширять меню ИСР, включая в него необходимые вам дополни- 
тельные программы, в том числе и собственные. Результатом является удобная 
для вас среда быстрой разработки сложных прикладных программ. 

Запустите C++Builder, выбрав пиктограмму C++Builder 5 в разделе меню 
Windows Пуск | Программы. Когда вы щелкнете на пиктограмме C++Builder, перед 
вами откроется основное окно Интегрированной Среды Разработки. Его вид пред- 
ставлен на рис. 2.1. 


Рис. 2.1 

Основное окно 
Интегрированной Среды 
Разработки C++Builder 5 


В верхней части окна MCP вы видите полосу главного меню. Ее состав частич- 
но зависит от варианта C++Builder, с которым вы работаете. На рис. 2.1 приведен 
вид окна для варианта Enterprise. 

Ниже полосы главного меню расположены две инструментальные панели. 
Левая панель (состоящая в свою очередь из нескольких панелей) содержит два 
ряда быстрых кнопок, дублирующих некоторые наиболее часто используемые ко- 
манды меню. Правая панель содержит палитру компонентов библиотеки визу- 
альных компонентов (Visual Component Library — VCL). В дальнейшем мы для 
краткости будем называть библиотеку визуальных компонентов просто библиоте- 
кой, благо это ближе к истине, так как в ней содержатся и визуальные, и невизу- 
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альные компоненты. Палитра компонентов содержит ряд страниц, закладки кото- 
рых видны в ее верхней части. 

Правее полосы главного меню размещена еще одна небольшая инструменталь- 
ная панель, содержащая выпадающий список и две быстрые кнопки. Это панель 
сохранения и выбора различных конфигураций окна ИСР, которые вы сами може- 
те создавать и запоминать. 

В основном поле окна вы можете видеть слева окно Инспектора Объектов 
(Object Inspector), с помощью которого вы в дальнейшем будете задавать свойства 
компонентов и обработчики событий. Правее вы можете видеть окно пустой фор- 
мы, готовой для переноса на нее компонентов. Под ним расположено окно Редак- 
тора Кодов. Обычно оно при первом взгляде на экран невидимо, так как его размер 
равен размеру формы и окно Редактора Кодов практически полностью перекрыва- 
ется окном формы. На рис. 2.1 это окно немного сдвинуто и выглядывает из под 
окна формы. 

Рассмотрим теперь основные элементы окна ИСР. 


2.2.2 Полоса главного меню и всплывающие меню 


В главе 14 в разделе 14.1 дается описание всех разделов меню. Кроме того в 
дальнейшем при обсуждении различных проектных операций мы еще будем под- 
робно рассматривать функции многих разделов меню. А пока просто дадим крат- 
кий обзор основных разделов. 

Разделы меню File (файл) позволяют создать новый проект, новую форму, от- 
крыть ранее созданный проект или форму, сохранить проекты или формы в фай- 
лах с заданными именами. 

Разделы меню Edit (правка, редактирование) позволяют выполнять обычные 
для приложений Windows операции обмена с буфером Clipboard, а также дают воз- 
можность выравнивать группы размещенных на форме компонентов по размерам 
и местоположению. 

Разделы меню Search (поиск) позволяют осуществлять поиск и контекстные 
замены в коде приложения, которые свойственны большинству известных тексто- 
вых редакторов. 

Разделы меню View (просмотр) позволяют вызывать на экран различные окна, 
необходимые для проектирования. 

Разделы меню Project (проект) позволяют добавлять и убирать из проекта фор- | 
мы, задавать опции проекта, компилировать проект без его выполнения и делать 
много других полезных операций. 

Меню Кип (выполнение) дает возможность выполнять проект в нормальном 
или отладочном режимах, продвигаясь по шагам, останавливаясь в указанных 
точках кода, просматривая значения переменных и т.д. 

Меню Сотропеп! (компонент) позволяет создавать и устанавливать новые ком- 
поненты, конфигурировать палитру компонентов, работать с пакетами. 

Разделы меню Database (база данных) позволяют использовать инструмента- 
рий для работы с базами данных. 

Меню Tools (инструментарий) включает ряд разделов, позволяющих настраи- 
вать ИСР и выполнять различные вспомогательные программы, например, вызы- 
вать Редактор Изображений (Image Editor), работать с программами, конфигури- 
рующими базы данных и т.д. Кроме того, в это меню вы можете сами включить 
любые разделы, вызывающие те или иные приложения, и таким образом расши- 
рить возможности главного меню C++Builder, приспособив ero для своих задач 
(подробнее см. в разделе 14.2.4). 

Меню Нер (справка) содержит разделы, помогающие работать со встроенной в B 
C++Builder справочной системой. 
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Мы рассмотрели основные меню, входящие в полосу главного меню. Но поми- 
мо главного меню в C++Builder имеется система контекстных всплывающих Me- 
ню, которые появляются, если пользователь поместил курсор мыши в том или 
ином окне или на том или ином компоненте и щелкнул правой кнопкой мыши. 
Большинство разделов этих контекстных меню дублируют основные разделы глав- 
ного меню. Однако, во всплывающих меню в ряде случаев имеются разделы, отсут- 
ствующие в главном меню. И до многих инструментов, используемых для работы с 
некоторыми компонентами, можно добраться только через всплывающие меню. 
Так что почаще пробуйте в процессе работы щелкать правой кнопкой мыши. Это 
ускорит выполнение многих проектных операций. 


2.2.3 Быстрые кнопки 


Инструментальные панели быстрых кнопок для C++Builder 5 представлены 
на рис. 2.2. Как будет видно позднее, фактически это не две, а пять панелей. На- 
значение размещенных на них быстрых кнопок можно узнать из ярлычков, появ- 
ляющихся, если вы поместите курсор мыши над соответствующей кнопкой и на 
некоторое время задержите его. В таблице 2.1 приведены пиктограммы этих кно- 
пок, соответствующие им команды меню и «горячие» клавиши, а также краткие 
пояснения. 


Рис. 2.2 < 
Инструментальные панели в C++Builder 5: основные (a) и 
панель выбора конфигурации окна (6) 


Таблица 2.1. Быстрые кнопки 


Пояснение команды’ 
Ее | New Открыть проект или модуль из Депозитария 


File | Open Открыть файл проекта, модуля, пакета. Кно- 
почка со стрелкой справа от основного изоб- 
ражения соответствует команде Кеореп, позво- | 
ляющей открыть файл из списка недавно ис- | 
пользовавшихся 


File | Reopen 


File | Save Сохранить файл модуля, с которым в данный 
(Ctrl — S) момент идет работа 


File | Save А! Сохранить все (все файлы модулей и файл 
проекта) 


File | Open Project Открыть файл проекта 
(Ctrl — F11) 


Project | Add to Project | Добавить файл в проект 
(Shift — F11) 


Project | Remove from Удалить файл из проекта 
Project 
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Пиктог- |Команда меню / Пояснение команды 
раммы |«горячие» клавиши 
Help | C++Builder Help |Вызов страницы Содержание встроенной 
справки 


View | Units Переключиться на просмотр текста файла MO- 
(Ctrl — F12) дуля, выбираемого из списка 


View | Forms Переключение на просмотр формы, выбирае- 
(Shift — F12) мой из списка 


View | Toggle Form/Unit |Переключение между формой и соответствую- 
(712) щим ей файлом модуля 


File | New Form Включить в проект новую форму 


Run | Run Выполнить приложение. Кнопочка со стрел- 

(29) кой справа от основного изображения позво- 
ляет выбрать выполняемый файл, если вы ра- 
ботаете с группой приложений 


Run | Program Pause Пауза выполнения приложения и просмотр 
информации СРО. Кнопка и соответствующий 
раздел меню доступны только во время вы- 
полнения приложения 


Run | Trace Into Пошаговое выполнение программы с заходом 
(77) в функции 


Run | Step Over Пошаговое выполнение программы без захода 
(F8) в функции 


View | Desktops | Сохранение текущей конфигурации окна 
Save Desktop 


View | Desktops | Установка конфигурации окна при отладке 
Set Debug Desktop 


На рис. 2.2 и в таблице 2.1 приведен стандартный состав инструментальных 
панелей быстрых кнопок. Однако, в C++Builder 5 вам предоставляются широкие 
возможности настроить панели по своему усмотрению, добавить в них какие-то 
быстрые кнопки для часто применяемых вами команд, убрать кнопки, которыми 
вы редко пользуетесь, сделать некоторые из инструментальных панелей невиди- 
мыми. Настройка инструментальных панелей быстрых кнопок рассмотрена в гла- 
ве 14 в разделе 14.2.1. 


2.2.4 Палитра компонентов 


Палитра компонентов (рис. 2.3) — это витрина библиотеки визуальных ком- 
понентов (Visual Component Library — VCL). Она позволяет сгруппировать компонен- 
ты в соответствии с их смыслом и назначением. Эти группы или страницы снаб- 
жены закладками. Вы можете изменять комплектацию страниц, вводить новые 
страницы, переставлять их, вносить на страницы разработанные вами шаблоны и 
компоненты и т.д. 


Рис. 2.3 
Палитра компонентов 
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По умолчанию в палитре C++Builder 5 имеются страницы: 


ИИ ИИ ОЕ ИАН 


ИН 


Standard а Стандартная, содержащая наиболее часто используемые компо- 
ненты 

Additional Дополнительная, являющаяся дополнением стандартной 

Win32 32-битные компоненты в стиле Windows 95/98 и NT 

System Системная, содержащая такие компоненты, как таймеры, плее- 


Data Access 
Data Controls 
ADO 


ры и ряд других 
Доступ к данным через Borland Database Engine (BDE) 
Управление данными 


Связь с базами данных через Active Data Objects (ADO) — мно- 
жество компонентов ActiveX, использующих для доступа к ин- 
формации баз данных Microsoft OLE DB 


InterBase Прямая связь с InterBase, минуя Borland Database Engine (BDE) 
u Active Data Objects (ADO) 

Midas Построение приложений баз данных с параллельными потоками 

InternetExpress Построение приложений InternetExpress — одновременно при- 
ложений сервера Web и клиента баз данных с параллельными 
потоками 

Internet Компоненты для приложений, работающих с Интернет 

FastNet Различные протоколы доступа к Интернет 


Decision Cube 


Многомерный анализ данных 


Qreport Быстрая подготовка отчетов 

Dialogs Стандартные системные диалоги Windows 

Win 3.1 Компоненты в стиле Windows 3.х (для обратной совместимости) 

Samples Образцы, различные интересные, HO не до конца документиро- 
ванные компоненты 

ActiveX Активные элементы ActiveX 

Servers Оболочки VCL для распространенных серверов COM 


Поскольку число страниц в C++Builder 5 велико и не все закладки видны на 


экране одновременно, в правой части палитры компонентов имеются две кнопки 
со стрелками, направленными влево и вправо. Эти кнопки позволяют перемещать 
отображаемую на экране часть палитры. 

Чтобы перенести компонент на форму, надо открыть соответствующую стра- 
ницу библиотеки и указать курсором мыши необходимый компонент. При этом 
кнопка-указатель (8), размещенная в левой части палитры компонентов, приобре- 
тет вид не нажатой кнопки. Это значит, что вы находитесь в состоянии, когда со- 
бираетесь поместить компонент на форму. Если вы нажмете эту кнопку, это будет 
означать, что вы отказались от размещения выбранного компонента. 

Поместить выбранный в палитре компонент на форму очень просто — надо 
сделать щелчок мышью в нужном месте формы. Есть и другой способ поместить 
компонент на форму — достаточно сделать двойной щелчок на пиктограмме ком- 
понента в палитре, и он автоматически разместится в центре вашей формы. Если 
вы выбрали компонент, а затем изменили ваше намерение размещать его, вам дос- 
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таточно нажать кнопку указателя. Это прервет процесс размещения компонента и 
программа вернется в нормальный режим, в котором вы можете выбирать другой 
компонент или выполнять какую-то команду. 

Имена компонентов, соответствующих той или иной пиктограмме, вы можете 
узнать из ярлычка, появляющегося, если вы задержите над этой пиктограммой 
курсор мыши. Если вы выберете в палитре компонент и нажмете клавишу Fl, то 
вам будет показана справка по типу данного компонента. Тут надо сразу сделать 
одно замечание. Имена на ярлычках выглядят, например, так: MainMenu, Button 
и т.д. Однако, в C++Builder все имена классов в действительности начинаются с 
символа «Т», например, TMainMenu, TButton. Под такими именами вы можете 
найти описания соответствующих компонентов во встроенной в C++Builder спра- 
вочной системе. 


2.2.5 Окно формы 


Основой почти всех приложений C++Builder является форма. Ее можно пони- 
мать как типичное окно Windows. Форма является основой, на которой размеща- 
ются другие компоненты. 

Форма имеет те же свойства, что присущи другим окнам Windows 95/98. Она 
имеет управляющее меню в верхнем левом углу, полосу заголовка, занимающую 
верхнюю часть окна, кнопки развертывания, свертывания и закрытия окна в верх- 
нем правом углу. Можно изменить вид окна, убрав в нем какие-то кнопки или всю 
полосу заголовка, сделав его окном с неизменяемыми размерами и т.п. О TOM, как 
это сделать, вы узнаете в разделе 4.1.3 главы 4. 

Во время проектирования форма покрыта сеткой из точек. В узлах этой сетки 
размещаются те компоненты, которые вы помещаете на форму. Во время выполне- 
ния приложения эта сетка, конечно, не видна. 

В некоторых случаях при разработке какого-то модуля форма может оказать- 
ся вообще ненужной. Но обычно вся работа в C++Builder проводится именно на 
форме. 

Когда вы поместили на форме какие-то компоненты, вы можете получить по 
ним контекстную справку. Для этого выделите интересующий вас компонент и на- 
жмите клавишу Fl. Если вы щелкнете на самой форме и нажмете клавишу Fl, вам 
будет показана справка по классу формы. 


2.2.6 Окно Редактора Кода 


Одной из наиболее важных частей среды C++Builder является окно Редактора 
Кода, показанное на рис. 2.4 а. В действительности, если вы откроете в первый раз 
это окно в C++Builder 5, оно может выглядеть несколько иначе (рис 2.4 6) и вклю- 
чать в себя слева еще одно встроенное окно — окно Исследователя Классов 
(ClassExplorer), подробно рассмотренное в разделе 2.5.3.2. Но 06 этом будет сказа- 
но позднее и во многих случаях вы просто можете закрыть это дополнительное 
окно, щелкнув на кнопке в его правом верхнем углу, или задать опции среды про- 
ектирования, отменяющие по умолчанию появление окна ClassExplorer (см. раз- 
дел 14.2.7 главы 14). 

Редактор Кода является полноценным программным редактором. Его можно 
настраивать на различный стиль работы, который вам более привычен. В редакто- 
ре применяется выделением цветом и шрифтом синтаксических элементов. Жир- 
ным шрифтом выделяются ключевые слова С++ (на рис. 2.4 вы видите выделен- 
ные слова Class, public, __published и другие). Зеленым цветом выделяются ди-. 
рективы препроцессора (на рис. 2.4 это директивы #include). Синим курсивом вы- 
деляются комментарии (на рис. 2.4 это тексты «// [ДЕ-тапазей Components» и «// 
User declarations»). 
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Рис. 2.4 
Окно Редактора Кода без встроенного окна 
ClassExplorer (а) и со встроенным окном. (6} 


te <Controls, hp 


: г - se hoe] . =. р ‚= * 
siude <Stdcr le. npn 


Se <Porkuas.hpp> 


__published: // IDE-managed Components 
iprivate: // User declarations 
// User declarations 
__fastcall TFormi (TComponent* Owner) ; 


ara 
Project! - Classes 
= at) TForn1 ingiude <Classeec.hpp> 
+ TFormi( Les ‚ Controls. hpp> 
:. {$1 Functions ifanciude <SudCeris. Нрр> 


YS . В у.у 
SPoOLMS . Зру> 


class TForm1 : public TForm a 


|< 
|__ published: // IDE-manac 
// User deci 
// User deci 


__fastcall TForm1 (TC 


В заголовке окна Редактора Кода отображается имя текущего файла, того, с. 
текстом которого вы работаете. В приложениях C++Builder часто приходится ра- 
ботать с несколькими файлами. В частности, обычно кроме файла реализации мо- 
дуля .cpp вам нужен еще заголовочный файл модуля .h (см. в главе 1 разделы 1.5.2 
и 1.5.4). Вы можете загрузить заголовочный файл в Редактор Кода, щелкнув в 
окне редактора правой кнопкой мыши и выбрав из всплывшего (контекстного) 
меню команду Open Source/Header File. Если в этот момент вы находились в окне 
Редактора Кода на странице с текстом файла реализации модуля, то в Редактор 
Кода загрузится заголовочный файл вашего модуля. На рис. 2.4 работа идет имен- 
но с заголовочным файлом. В верхней части окна вы можете видеть закладки или 
ярлычки, указывающие текущую страницу и помогающие переходить от одного 
файла к другому. Если какой-то из открытых файлов вам больше не нужен, вы мо- 
жете зарыть его страницу в Редакторе Кода, выбрав в контекстном меню команду 
Close Раде. Вы можете также открыть дополнительное окно Редактора Кода (ко- 
мандой View | New Edit Window или щелкнув в окне Редактора Кода правой кнопкой 
мыши и выбрав аналогичную команду из всплывшего меню) и одновременно рабо- 
тать с несколькими модулями или с разными фрагментами одного модуля. 

В нижней части окна Редактора Кода вы можете видеть типичную для тексто- 
вых редакторов строку состояния. В самой левой ее позиции находится индикатор 
строки и колонки. Правее расположен индикатор модификации, который словом 
«Modified» показывает, что код, который вы видите в окне, изменен и не совпадает 
с тем, который хранится на диске. Третий элемент строки состояния — стандарт- 
ный большинства редакторов индикатор режима вставки. 

В окно Редактора Кода, как и в другие окна C++Builder, встроена контекстная 
справка. Чтобы получить справку по какому-то слову кода (ключевому слову, на- 
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писанному имени функции ит.п.) достаточно установить курсор на это слово и на- 
жать клавишу Fl. Вам будет показана соответствующая тема справки. 


2.2.7 Инспектор Объектов 


Инспектор Объектов (Object Inspector) обеспечивает простой и удобный интер- 
фейс для изменения свойств объектов C++Builder и управления событиями, на KO- 
торые реагирует объект. 

Окно Инспектора Объектов (рис. 2.5) имеет две страницы. Выше их имеется 
выпадающий список всех компонентов, размещенных на форме. В нем вы можете 
выбрать тот компонент, свойства и события которого вас интересуют. 


Рис. 2.5 ФВ Object Inspector ——^ | рота 
Страница свойств (а) и страница событий [Рот fae ae ее i |Formt: TFormt | 


(6) Инспектора Объектов 


| clCaptionT ext 
clActiveB order 
‘ clinactiveB order 


: Dr 
о Highlight 
Е ‘J clHighlightT ext 
eee ciBinF ace 


Страница свойств (Properties) Инспектора Объектов (см. рис. 2.5 a), показывает 
свойства того объекта, который в данный момент выделен вами. Щелкните на окне 
пустой формы и на странице свойств Инспектора Объектов вы сможете увидеть 
свойства формы (они показаны на рис. 2.5 а). Вы можете изменять эти свойства. 
Например, измените свойство Caption (надпись) вашей формы, написав в нем 
«Моя форма», и вы увидите, что эта надпись появится в полосе заголовка вашей 
формы. 

Если щелкнуть на некоторых свойствах, например, на свойстве Со]ог (цвет), 
то справа от имени свойства откроется окно выпадающего списка. Нажав в нем на 
кнопочку со стрелкой вниз, вы можете увидеть список возможных значений свой- 
ства (см. рис. 2.5 а). Например, смените значение свойства Color с принятого по 
умолчанию clBtnFace (цвет поверхности кнопок) на clWindow (цвет окна). Вы 
увидите, что поверхность формы изменит свой цвет. 

Рядом с некоторыми свойствами вы можете видеть знак плюс (см., например, 
свойство Borderlcons на рис. 2.5 а). Это означает, что данное свойство является 
объектом, который в свою очередь имеет ряд свойств. 

Найдите, например, свойство Font (шрифт). Рядом с ним вы увидите знак 
плюс. Щелкните на этом плюсе или сделайте двойной щелчок на свойстве Font. 
Вы увидите, что откроется таблица таких свойств, как Color (цвет), Height (высо- 
та), Name (имя шрифта) и др. Среди них вы увидите свойство Style (стиль), около 
которого тоже имеется знак плюс. Щелчок на этом плюсе или двойной щелчок на 
этом свойстве раскроет дополнительный список подсвойств, в котором вы можете, 
например, установить в true свойство fsBold (жирный). Кстати, для смены true на 
false и обратно в подобных булевых свойствах не обязательно выбирать значение 
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из выпадающего списка. Достаточно сделать двойной щелчок на значении свойст- 
ва, и оно изменится. После того, как вы просмотрели или изменили подсвойства, 
вы можете опять сделать двойной щелчок на головном свойстве или щелчок на 
знаке минус около него, и список подсвойств свернется. 

Страница событий (Events) составляет вторую часть Инспектора Объектов (см. 
рис. 2.5 6). Ha ней указаны все события, на которые может реагировать выбран- 
ный объект. Например, если вам надо выполнить какие-то действия в момент соз- 
дания формы (обычно это различные операции настройки), то вы должны выде- 
лить событие OnCreate. Рядом с именем этого события откроется окно с выпадаю- 
щим списком. Если вы уже написали в своем приложении какие-то обработчики 
событий и хотите при событии OnCreate использовать один из них, вы можете вы- 
брать необходимый обработчик из выпадающего списка. Если же вам надо напи- 
сать новый обработчик, то сделайте двойной щелчок на пустом окне списка. 

Вы попадете в окно Редактора Кода, в котором увидите текст: 


void  fastcall TForml::FormCreate(TObject *Sender) 


{ 


} 


Курсор будет расположен в пустой строке между строками с открывающейся и 
закрывающейся фигурными скобками. Увиденный вами код — это заготовка обра- 
ботчика события, которую автоматически сделал C++Builder. Вам остается только 
в промежутке между скобками «{» и «}» написать необходимые операторы. 

Если вы сделали эти операции, то вернитесь в Инспектор Объектов, выделите 
в нем, например, событие OnActivate и нажмите в нем кнопку выпадающего спи- 
ска. Вы увидите в нем введенный вами ранее обработчик события OnCreate (этот 
момент изображен на рис. 2.5 6). Если вам надо использовать тот же самый обра- 
ботчик и в событии OnActivate, просто выберите его из списка. Таким образом вы 
можете избежать дублирования в программе одних и тех же фрагментов кода. 

Пользуясь Инспектором Объектов, вы можете получить контекстную справку 
. по свойствам или событиям. Для этого выделите в окне Инспектора Объектов инте- 
ресующее вас свойство или событие и нажмите клавишу Г]. 

В C++Builder 5 в Инспектор Объектов введены некоторые дополнительные 
возможности. Одна из них — отображение в ряде выпадающих списков пикто- 
грамм. На рис. 2.5 а вы уже видели один такой список свойства Со]ог с квадрати- 
ками цветов. Это, конечно, много удобнее, чем абстрактные идентификаторы цве- 
тов, которые были в C++Builder 4 и более ранних версиях. На рис. 2.6 показано 
еще два списка с пиктограммами. Рис. 2.6 а показывает список с изображениями 
курсоров в свойстве Cursor. Из такого списка удобно выбрать вид, который будет 
приобретать курсор мыши при перемещении над компонентом или формой. А на 
рис. 2.6 6 показан в свойстве ImageIndex список пиктограмм компонента 
ImageList, из которых можно выбрать пиктограмму для кнопки проектируемой 
инструментальной панели или для раздела меню. Этот список особенно удобен, так 
как его альтернативой в младших версиях C++Builder являлись абстрактные ин- 
дексы пиктограмм и задавать их было довольно неудобно. 

В Инспектор Объектов C++Builder 5 введена также возможность фильтрации 
свойств и событий и возможность группировать их по категориям. Для того, чтобы 
воспользоваться этими возможностями, щелкните в окне Инспектора Объектов 
правой кнопкой мыши. Во всплывшем меню вы можете выбрать раздел View. Вам 
будет показан ряд категорий свойств (см. рис. 2.7) и событий. Около каждой кате- 
гории имеется индикатор. Вы можете включить индикаторы только у некоторых 
категорий и тогда в Инспекторе Объектов вы увидите события и свойства только 
указанных категорий. Выбор раздела Toggle переключит видимость разделов: те, 
которые были видимы, станут невидимы и наоборот. Выбор раздела All сделает ви- 
димыми все свойства и события, а выбор раздела Мопе сделает все события и свой- 
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Рис. 2.6 а) [Object Inspector : 
Выпадающие списки Инспектора Рот: TForn1 
Объектов в C++Builder 5 с 

пиктограммами 


ciAppStart 


сом 


crCross 


erDefault 


c1Diag 


ctHandPoint 


сНер 


ctHourGlass 


ства невидимыми (правда, непонятно, зачем в этом режиме вообще нужен Инспек- 
тор Объектов). Внизу окна Инспектора Объектов указывается, сколько свойств 
или событий невидимо в данный момент. На рис. 2.5 вы можете видеть, что на 
странице свойств невидимы (hidden) 2 свойства, a на странице событий видны все 
события (All shown). Невидимые свойства — следствие выключенного по умолча- 
нию индикатора категории Legacy (см. рис. 2.7). 


Рис. 2.7 
Список категорий свойств 


В том же меню, всплывающем при щелчке правой кнопкой мыши в окне Ин- 
спектора Объектов, вы можете выбрать раздел Arrange и в нем установить одну из 
двух возможностей: Бу Мате — упорядочить свойства и события в алфавитной по- 
следовательности их имен, или by Category — упорядочить их по категориям. При 
упорядочивании по категориям форма представления событий и свойств карди- 
нально меняется (рис. 2.8). В окне отображаются категории с символами «+», при 
щелчке на которых раскрывается список элементов, относящихся к данной кате- 
гории. При этом некоторые свойства могут попасть одновременно в несколько ка- 
тегорий. Но это не имеет значения: вы можете менять их значения в любой катего- 
рии и они синхронно изменятся во всех остальных категориях. 


64 Глава 2 


Рис. 2.8 


Страница свойств Инспектора Объектов, упорядоченная по категориям 


Описанные возможности Инспектора Объектов по фильтрации и упорядочива- 
нию информации, введенные в C++Builder 5, существенно упрощают работу с 
трудно обозримым множеством свойств, присущих многим компонентам библиоте- 
ки. 


2.2.8 Перетаскивание и встраивание окон в UCP C++Builder 


В Интегрированной Среде Разработки, как и в оконных компонентах 
C++Builder, широко используется технология Drag&Doc — перетаскивание и 
встраивание окон. Одно из встраиваемых окон вы уже видели: окно Исследователя 
Классов — ClassExplorer. По умолчанию оно встроено в окно Редактора Кода 
(рис. 2.4 6). Есть также еще много встраиваемых окон, которые мы рассмотрим 
позднее: окно Менеджера Проектов (Project Menager), окно наблюдаемых величин 
(Watch List) и много других. 

Встраиваемое окно можно отличить от обычного по следующим признакам: 


Ш Сокращенная полоса системного меню, включающая обычно только кнопку 
закрытия окна. 


Ш Наличие в меню, всплывающем при щелчке в окне правой кнопкой мыши, пе- 
реключателя Dockable — встраиваемое. Если снять метку с этого переключате- 
ля, окно перестанет быть встраиваемым. В дальнейшем вы можете опять по- 
метить этот переключатель, и окно снова станет встраиваемым. 


Es При перетаскивании встраиваемого окна размеры его рамки изменяются, если 
окно перемещается в пределах другого окна. 


Встраивание окон позволяет вам экономить площадь экрана. Для того, чтобы 
переместить встраиваемое окно, надо потянуть курсором мыши за двойную рамку 
на одной из его границ (на рис. 2.4 6 она на верхней границе окна). При этом мож- 
но вынуть его из окна — контейнера и сделать самостоятельным — это так назы- 
ваемое плавающее окно. Для перевода окна в плавающее состояние не обязательно 
тянуть за двойную рамку — достаточно сделать на ней двойной щелчок. Можно 
встроить окно ClassExplorer в окно Редактора Кода иначе, чем это принято по 
умолчанию, например, снизу, чтобы не уменьшать видимую длину строк кода. Во 
встроенном состоянии можно курсором мыши передвинуть границы окон, практи- 
чески убрав при желании одно из окон, которое в данный момент не нужно. 

Очень удобно встраивать окна в Инспектор Объектов. Они при этом ложатся. 
на отдельные страницы, совершенно не занимая на экране дополнительного места 
(рис. 2.9). А когда требуется, вы всегда можете посмотреть требуемое окно, щелк- 
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нув на его закладке. Поскольку не все закладки могут уместиться в заголовке 
окна, в нем появляются на уровне закладок кнопки со стрелками, направленными 
влево и вправо (см. рис. 2.9). С их помощью можно перейти на страницу, закладка 
которой не видна. 


Рис. 2.9 3} | Object Inspector; Class secre x} 
Окно ClassExplorer, встроенное в } ‘object inspector Classe. ‹ > { ClassExpiorer ок и “a а] 


качестве отдельной страницы в 
окно Инспектора Объектов: 

a) — открыт Инспектор Объектов, 
6) — открыт ClassExplorer 


НЕ 4 Project! - Classes 
a & on TForrn 
: yg double А, 
~~ Су TButton * Button” 
Су TEdit * Edit 
coy TEdlit * Е 
: Sy inti 
5 TLabel * Label! 
, cp Трон (TCompor 
- an РИ 


Технология встраивания окон Drag&Doc реализована также в инструменталь- 
ных панелях. Вглядитесь (рис. 2.1), и вы увидите, что в действительности ИСР со- 
держит 6 панелей, разделенных двойными рамками. Потяните какую-нибудь из 
панелей (например, палитру компонентов) за эту рамку, и увидите, что вы можете 
ее перемещать, например, перевести ее в дополнительный третий ряд панелей, 
чтобы увеличить доступную длину, или вообще перевести в плавающее состояние. 
Таким образом, вам предоставлены огромные возможности по преобразованию ин- 
струментальных панелей. Только будьте осторожны с этими возможностями. Соз- 
датели C++Builder неплохо продумали расположение всех органов управления 
ИСР. И вряд ли стоит что-то кардинально менять в панелях. 

Следует также упомянуть, что возможности настройки панелей достаточно 
широкие. Вы может делать какие-то из панелей, которые вам сейчас не нужны, 
невидимыми. Можете настраивать состав отдельных панелей, добавляя и удаляя 
из них какие-то кнопки. Все процедуры, связанные с настройкой инструменталь- 
ных панелей, рассмотрены в разделе 14.2.1 главы 14. 


2.2.9 Управление конфигурациями окон ИСР 


В предыдущих разделах мы рассмотрели несколько окон ИСР: Инспектора 
Объектов, Редактора Кода, упоминалось окно ClassExplorer. В дальнейшем будет 
рассмотрено много других окон, облегчающих написание кода и отладку приложе- 
ния. Каждый пользователь открывает те окна, которые требуются ему для того 
или иного вида работ, и располагает их удобным для себя образом. Одни окна раз- 
вернуты, другие свернуты, какие-то окна встроены друг в друга. Так создается 
удобная для пользователя конфигурация окон. Хотелось бы запоминать эту кон- 
фигурацию, чтобы не повторять работу по оборудованию своего рабочего места ка- 
ждый раз при запуске C++Builder. Запоминание конфигурации можно осущест- 
вить несколькими способами. 

Можно сделать так, чтобы при очередном запуске C++Builder восстанавлива- 
лась конфигурация, которая была на момент завершения предыдущего сеанса ра- 
боты. Причем не только конфигурация окон, но и загруженный в них проект, с ко- 
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торым вы работали в последний раз. И даже положение курсора в окне Редактора 
Коды восстановится тем, которое было в момент окончания предыдущего сеанса. 
Так что вы сразу можете продолжать работу над тем же проектом с того самого 
места, на котором остановились. Эта прекрасная возможность реализуется выпол- 
нением команды Tools | Environment Options. В открывшемся диалоговом окне настро- 
ек среды проектирования на странице Preferences (см. рис. 14.23 раздела 14.2.10, в 
котором все это рассмотрено подробнее) в группе опций Амозауе options надо вклю- 
чить опцию Project desktop. Тогда текущая конфигурация и открытые файлы проек- 
та автоматически сохраняются при завершении сеанса работы с C++Builder и авто- 
матически восстанавливаются при начале нового сеанса. При включении этой оп- 
ции конфигурация окон запоминается также в каждом проекте. Так что если вы 
впоследствии откроете какой-то проект, с которым работали ранее, то восстановит- 
ся конфигурация всех окон, которые были открыты в момент окончания предыду- 
щего сеанса работы с данным проектом. 

Подобную операцию можно выполнить в любой версии C++Builder. В 
C++Builder 5 введены расширенные возможности сохранения конфигураций. Yc- 
тановив на экране некоторую конфигурацию окон, вы можете выполнить команду 
View | Desktops | Save Desktop или нажать соответствующую ей быструю кнопку (см. 
таблицу 2.1 в разделе 2.2.3). Появится диалоговое окно, в котором вы должны дать 
имя сохраняемой конфигурации. Имя может быть записано русским текстом. Эту 
операцию вы можете повторить несколько раз для разных конфигураций, которые 
вы используете в своей работе. В результате в выпадающем списке панели выбора 
конфигурации (см. рис. 2.1 вверху справа) появятся имена составленных вами 
конфигураций. В дальнейшем, работая с каким-то проектом, вы можете в любой 
момент выбрать в этом списке одну из конфигураций и она появится на экране. То 
же самое вы можете сделать командой View | Desktops с последующим выбором кон- 
фигурации из появившегося списка. При выборе одной из конфигураций файлы, 
открытые вами в окне Редактора Кода, останутся неизменными. Так что вы про- 
должите работу с вашим проектом, но уже в новой конфигурации окон. 

Уточним, что именно сохраняется в конфигурациях: 


в совокупность отрытых окон 


Ш размеры и расположение окон на экране (но не сохраняется их положение в 
так называемой 7-последовательности, определяющей в случае взаимного пе- 
рекрытия' окон, какие из них находятся поверх других) 


Ш состояние каждого окна (свернутое, развернутое, встроенное в другое окно) 


Ш настройки окна (например, в Инспекторе Объектов сохраняется способ отобра- 
жения информации — по алфавиту или по категориям и установки фильтра- 
ции, во встраиваемых окнах сохраняется состояние индикатора Dockable) 


Введенные вами конфигурации вы можете впоследствии реорганизовать, уда- 
лив ненужные командой View | Desktops | Delete. 

Конфигурация различных вспомогательных окон, установленная для одной 
из запомненных конфигураций, используется как конфигурация отладки. Какая 
именно — устанавливается с помощью команды View | Desktops | Set Debug Desktop 
или соответствующей ей быстрой кнопки (см. таблицу 2.1 в разделе 2.2.3). Пользо- 
вателю предлагается список сохраненных конфигураций, из которого он должен 
выбрать конфигурацию отладки. В этом случае именно эта конфигурация будет ав- 
томатически загружаться, как только вы запускаете свое приложение на выполне- 
ние в режиме отладки. 

Пусть, например, вы сделали и сохранили две конфигурации: одну без ка- 
ких-либо вспомогательных окон сохранили под именем «Умолчание», вторую с OK- 
ном наблюдения Watches, встроенным в окно Инспектора Объектов (см. раз- 
дел 2.6.4), сохранили под именем «Watches». Выполняя команду установки кон- 
фигурации отладки указали в качестве этой конфигурации «Watches». Тогда, He- 
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зависимо от того, какую из конфигураций — «Умолчание» или «Watches» вы ука- 
зали при работе с проектом, в момент, когда приложение будет запущено на вы- 
полнение, установится конфигурация «Watches». После окончания сеанса отлад- 
ки конфигурация автоматически вернется к исходной. 


2.3 Первые шаги — первые собственные 
приложения 


2.3.1 Очень простое приложение 


Теперь вы имеете некоторое представление об основных (но далеко не всех) 
элементах Интегрированной Среды Разработки (ACP) C++Builder. Самое время по- 
пробовать написать первое приложение. 

Для начал давайте решим совсем простую задачу: создать приложение, в кото- 
ром при щелчке пользователя на кнопке появлялась бы какая-нибудь надпись. 
Выполните для этого последовательно следующие шаги. 


1. Запустите C++Builder, если вы еще это не сделали, с помощью меню Windows 
Пуск | Программы. Если C++Builder уже работает и вы уже делали какие-то экс- 
перименты с формой, то откройте новое приложение. Для этого вам надо вы- 
полнить команду File | New Application. Ответьте «No» на вопрос C++Builder, xo- 
тите ли вы сохранить изменения в вашем проекте 


2. Перенесите на пустую форму, которая открылась вам, кнопку типа ТВи Йоп co 
страницы Standard палитры компонентов, Для этого выделите пиктограмму 
кнопки (она шестая слева) и затем щелкните курсором мыши в нужном вам 
месте формы. На форме появится кнопка, которой C++Builder присвоит имя 
по умолчанию — Buttonl. 


3. Аналогичным образом перенесите на форму с той же страницы Standard палит- 
ры компонентов метку Label (она на странице третья слева). В этой метке в 
процессе выполнения приложения будет появляться текст при нажатии поль- 
зователем кнопки. C++Builder присвоит метке имя Labell. 


4. Разместите компоненты на форме примерно так, как показано на рис. 2.10 a. 
При этом уменьшите до разумных размеров окно формы, так как в вашем пер- 
вом приложении никаких других компонентов не будет. 


Рис. 2.10 

Форма (а) и окно в процессе 
выполнения (6) вашего 
приложения 


5. Выделите на форме компонент Ви воп1 — кнопку. Перейдите в Инспектор 
Объектов и измените ее свойство Caption (надпись), которое по умолчанию 
равно Buttonl (имя, которое по умолчанию присвоил этому компоненту 
C++Builder) на «Пуск». 


6. Укажите метке Labell, что надписи на ней надо делать жирным шрифтом. 
Для этого выделите метку, в окне Инспектора Объектов раскройте двойным 
щелчком свойство Font (шрифт), затем также двойным щелчком раскройте 
подсвойство Style (стиль) и установите в true свойство fsBold (жирный). 
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7. Сотрите текст в свойстве Caption метки Labell, чтобы он не высвечивался, 
пока пользователь не нажмет кнопку приложения. 


Теперь вам осталось только написать оператор, который заносил бы в свойство 
Caption метки Labell нужный вам текст в нужный момент. Этот момент определя- 
ется щелчком пользователя на кнопке. При щелчке в кнопке генерируется собы- 
тие OnClick. Следовательно, обработчик этого события вы и должны написать. 


8. Выделите кнопку Buttunl на-форме, перейдите в Инспектор Объектов, от- 
кройте в нем страницу событий (Events), найдите событие кнопки OnClick (оно 
первое сверху) и сделайте двойной щелчок в окне справа от имени этого собы- 
тия. Это стандартный способ задания обработчиков любых событий. Но перей- 
ти в обработчик события OnClick (только этого события) можно и иначе: до- 
статочно сделать двойной щелчок на компоненте Buttonl на форме. В обоих 
случаях вы окажетесь в окне Редактора Кода и увидите там текст: 


void _fastcall TForml::ButtonlClick(TObject *Sender) 
{ 


} 


Заголовок этой функции складывается из имени класса вашей формы 
(TForm1), имени компонента (Button1) и имени события без префикса Оп (Click). 


9. Если хотите, можете закрыть окно Исследователя Классов, встроенное в окно 
Редактора Кода (рис. 2.4), так как оно пока вам не нужно и будет только ме- 
шать. Закрыть это дополнительное окно можно, щелкнув на кнопке в его пра- 
вом верхнем углу. 


10. Напишите в обработчике оператор задания надписи метки Labell. Этот опера- 
тор может иметь вид: 


Labell->Caption = "Это мое первое приложение!"; 


Таким образом, полностью ваш обработчик события должен иметь вид: 


void _ fastcall TForml::ButtonlClick(TObject *Sender) 
{ 


Labell->Caption = "Это мое первое приложение!"; 


} 


Оператор, который вы написали, означает следующее. Символ «=» обозначает 
операцию присваивания, в которой тому, что написано перед этим символом, при- 
сваивается значение того, что написано после символа присваивания. Слева вы на- 
писали: Labell->Caption. Это значит, что вы присваиваете значение свойству 
Caption компонента Labell. Все указания свойств и методов производятся анало- 
гичным образом (см. раздел 1.5.5.2): пишется имя компонента, затем ставятся сим- 
волы операции стрелка «->»: символ минус «-» и символ больше «>», записанные 
без пробела. После этих символов пишется имя свойства или метода. В данном слу- 
чае свойству Caption вы присваиваете строку текста «Это мое первое приложение!». 

Если вы написали первый идентификатор оператора — Labell, поставили 
символы стрелки и ненадолго задумались, то вам всплывет подсказка, содержа- 
щая список всех свойств и методов метки. Это начал работать Знаток Кода, кото- 
рый стремится подсказать вам свойства и методы компонентов, аргументы функ- 
ций и их типы, конструкции операторов. Вы можете выбрать из списка нужное 
ключевое слово, нажать клавишу Enter и выбранное слово (свойство, метод) ока- 
жется вписанным в текст. Можете поступить иначе: начать писать нужное свойст- 
во. Тогда Знаток Кода сам найдет по первым введенным символам нужное свойст- 
во. Когда вы увидели, что нужное слово найдено, можете его не дописывать, а на- 
жать Enter, и Знаток Кода допишет его за вас. Этот инструмент очень удобен BO 
многих случаях, когда вы не очень точно помните последовательность перечисле- 
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ния параметров какой-нибудь функции, или когда не уверены в имени какого-то 
свойства (особенно в том, какие буквы этого слова в каком регистре надо писать). 
Но иногда, когда вы хорошо освоитесь с C++Builder, эти подсказки, может быть, 
начнут вас раздражать. K тому же, иногда Знаток Кода безо всякого вашего жела- 
ния дописывает начатое вами слово, причем дописывает не всегда верно. Имейте в 
виду, что при настройке ИСР вы можете временно отключить Знатока Кода или 
увеличить задержку, с которой он срабатывает (см. о настройке Знатока Кода в 
разделе 14.2.6 главы 14). 

Итак, ваше приложение готово. Можете откомпилировать и выполнить его. 
Для этого выполните команду Run | Вип, или нажмите соответствующую быструю 
кнопку (см. выше в разделе 2.2.3 таблицу 2.1), или нажмите «горячую» клавишу 
Г9. Если вы ничего не напутали, то после недолгой компиляции, сопровождающей- 
ся временным появлением на экране окна компилятора, перед вами появится окно 
вашего первого приложения. Нажав в нем кнопку «Пуск» вы увидите указанную 
вами строку текста (рис. 2.10 6). Можете попробовать различные манипуляции с 
окном: перемещение его, изменение размеров его рамки курсором мыши, сверты- 
вание и развертывание. В заключение закройте приложение, щелкнув на кнопке в 
его правом верхнем углу. 


2.3.2 Немного более сложное приложение 


Вас можно поздравить с созданием в C++Builder первого приложения для 
Windows. А теперь испытайте свои силы в построении чуть-чуть более сложного 
приложения, которое хоть что-нибудь вычисляет. Создайте приложение, которое 
при нажатии кнопки перемножало бы два числа, введенных пользователем, и по- 
казывало бы результат умножения. Эти числа можете понимать как хотите: как 
длину двух сторон прямоугольника, и тогда результат — это площадь, или как те- 
кущий курс доллара и сумму в долларах — тогда результатом будет рублевый эк- 
вивалент суммы и т.п. 

При построении этого приложения мы используем новые типы компонен- 
тов — окна редактирования Edit. Кроме того, для разнообразия, будем выводить 
результат не в метку Label, а в панель Panel, просто для того, чтобы испытать но- 
вый компонент. При создании этого приложения я уже не буду так подробно опи- 
сывать каждое действие, а ограничусь только общим описанием интерфейса и не- 
обходимых кодов. 

Откройте новое приложение. Перенесите на него со страницы библиотеки 
Standard два окна редактирования типа TEdit, одну панель типа TPanel, одну кноп- 
ку типа ТВи оп и три метки типа TLabel для надписей. При размещении несколь- 
ких компонентов одного типа можно нажать клавишу Shift перед щелчком Ha па- 
литре компонентов, затем указать места на форме, куда надо разместить компо- 
ненты, а в заключение нажать кнопку указателя в левой части палитры компонен- 
тов, чтобы прервать размещение. Поместите компоненты на форме примерно так, 
как показано на рис. 2.11. 


Рис. 2.11 


Форма вашего второго приложения 
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Измените надписи в метках (свойство Caption) на что-то осмысленное. Напри- 
мер, на «Число 1», «Число 2», «Результат» или на «Ширина», «Высота», «Пло- 
щадь» в зависимости от того, что вы хотите понимать под соответствующими чис- 
лами. Полезно задать для меток жирный шрифт, как вы это делали в предыдущем 
примере. 

Замените свойство Caption вашей кнопки, например, на «Расчет». Очистите 
свойство Caption у панели. В свойстве Text (текст) окон редактирования задайте 
«1» — начальное значение текста. 

Попробуйте поварьировать такими свойствами панели, как BevelInner и 
BevelOuter, которые определяют вид (утопленный — bvLowered или выпуклый 
bvRaised) основного поля и рамки панели. Например, можете установить 
BevelInner = bvLowered и BevelOuter = bvRaised. 

В итоге ваша форма приобретет вид, показанный на рис. 2.12 a. 

Рис. 2.12 6) 
Окончательный вид формы 
(a) и окна во время 
выполнения (6) 
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Осталось написать обработчик щелчка кнопки. Единственный оператор этого 
обработчика может иметь вид: 
Panell->Caption = Editl->Text + " * "+ Edit2->Text'+ "=" 


+ FloatToStr(StrToFloat (Editl->Text) * 
StrToFloat (Edit2->Text) ); 


Попробуем проанализировать этот оператор. Начало ero вам уже знакомо: вы 
присваиваете свойству Caption компонента Рапе!1 значение выражения, указан- 
ного в правой части оператора. Это выражение должно иметь тип строки текста. 
Начинается строка с текста, введенного пользователем в окно редактирования 
Edit1 — этот текст хранится в свойстве Text. Затем вы прибавляете к этому тексту 
символы < « * ». Знак «+» в выражениях для строк означает конкатенацию — сцеп- 
ление двух строк символов. Затем аналогичным образом к строке добавляется 
текст второго окна редактирования и символы « = ». После этого мы хотим BCTA- 
вить в строку результат перемножения двух целых чисел. Этот результат будет 
числом и, чтобы вставить его в текст, надо сначала преобразовать это число в стро- 
ку. Эту операцию выполняет функция FloatToStr(...), которая преобразует задан- 
ный ей параметр типа действительного числа в строку символов. Осталось полу- 
чить само произведение двух чисел. Но числа заданы пользователем в виде тек- 
стов — строк символов в окнах редактирования. Прежде, чем перемножать, эти 
строки надо перевести в числа. Эту операцию выполняют функции StrToFloat(), 
преобразующие символьное изображение числа в его значение типа действитель- 
ного числа. Знак "*', указанный между двумя функциями StrToFloat, обозначает 
операцию умножения. 

Ваше приложение готово. Можете его сохранить — ведь оно все-таки умеет де- 
лать нечто полезное. Для этого лучше всего создать отдельный подкаталог (папку 
Windows) и выполнить команду File | Save All. Проще эти команды выполнять с по- 
мощью соответствующих быстрых кнопок (см. таблицу 2.1 в разделе 2.2.3). 


Со aed 
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Откомпилируйте свое приложение и выполните его. Убедитесь, что оно нор- 
мально работает (рис. 2.12 6) и мгновенно перемножает самые замысловатые мно- 
горазрядные числа. 

Вы создали два простеньких приложения, на которых могли почувствовать 
процесс написания в C++Builder прикладных программ. Позднее, в последующих 
разделах вы научитесь создавать действительно сложные и эффективные приложе- 
ния различного назначения. А пока в дальнейших разделах данной главы давайте 
рассмотрим методику работы в ACP C++Builder 5 и соответствующий инструмен- 
тарий. 


2.4 Проекты C++Builder 


2.4.1 Организация проекта в C++Builder, основные файлы 
проектов 


Проект C++Builder состоит из форм, модулей с их заголовочными файлами и 
файлами реализации, установок параметров проекта, ресурсов и т.д. Вся эта ин- 
формация размещается в файлах. Многие из этих файлов автоматически создают- 
ся C++Builder, когда вы строите ваше приложение. Ресурсы, такие, как битовые 
матрицы, пиктограммы и т.д., находятся в файлах, которые вы получаете из дру- 
гих источников или создаете при помощи многочисленных инструментов и редак- 
торов ресурсов, имеющихся в вашем распоряжении. Кроме того, компилятор так- 
же создает файлы. Давайте бегло познакомимся с некоторыми из этих файлов, так 
как знание того, какие файлы какую информацию содержат, не раз поможет вам в 
трудных ситуациях. | 

Когда вы проектируете ваше приложение, C++Builder создает следующие 
файлы: 


о аи ня ИИ Я а US SEDI IST eS 


Головной файл проекта C++Builder создает файл. “Cpp J ua головной й Функ- 
(.срр) ции WinMain, инициирующей приложение и за- 
пускающей его на выполнение 


Файл опций проекта (.bpr) Этот текстовый файл содержит установки опций 
проекта и указания на то, какие файлы должны 
компилироваться и компоноваться в проект. 
Файл сохраняется в формате XML 


Файл ресурсов проекта (.res) Двоичный файл, содержащий ресурсы проекта: 
пиктограммы, курсоры и т.п. По умолчанию со- 
держит только пиктограмму проекта. Может до- 
полняться с помощью Редактора Изображений 
(Image Editor) 


Файл реализации модуля Каждой создаваемой вами форме соответствует 

(.cpp) текстовый файл реализации модуля, используе- 
мый для хранения кода. Иногда вы можете сами 
создавать модули, не связанные с формами 


Заголовочный файл модуля Каждой создаваемой вами форме соответствует не 

(.h) только файл реализации модуля, HO и ero заголо- 
вочный файл с описанием класса формы. Вы мо- 
жете и сами создавать необходимые заголовочные 
файлы 
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Файл формы (.dfm) Это двоичный или текстовый файл, который 
C++Builder создает для хранения информации о 
ваших формах. Вы можете смотреть этот файл в 
текстовом виде или в виде формы. Каждому фай- 
лу формы соответствует файл модуля (.ерр). 


Заголовочный файл компо- Файл создается при создании вами нового компо- 

нента (.hpp) нента. Вам также часто приходится подключать к 
проекту эти файлы из библиотеки компонентов 
C++Builder, расположенные в каталоге Inclu- 


de\ VCL 
Файл группы проектов Текстовый файл, создаваемый в C++Builder 5 при 
(.bpg) создании вами группы проектов — 


Файлы пакетов (.bpl и .bpk) Эти двоичные файлы используется C++Builder 
при работе с пакетами: .bpl — файл самого про- 
екта, .bpk — файл, определяющий компиляцию 
и компоновку пакета 


Файл рабочего стола проек- В этом текстовом файле C++Builder хранит ин- 

та (.dsk) формацию о последнем сеансе работы с проектом: 
открытых окнах, их размерах и положении. Бла- 
годаря этому файлу в новом сеансе вы сразу ви- 
дите тот же экран, который был в предыдущем 
сеансе. Файл создается только если вы включили 
опцию Autosave options/ Project desktop оболочки 
(см. раздел 14.2.10) 


Файлы резервных копий Это соответственно файлы резервных копий для 

(.~bp, .~df, .~cp, .~h) файлов проекта, формы, реализации модуля и за- 
головочного. Если вы что-то безнадежно испорти- 
ли в своем проекте, можете соответственно изме- 
нить расширения этих файлов и таким образом 
вернуться к предыдущему не испорченному вари- 
анту 


Следующая группа файлов создается компилятором: 


Исполняемый файл (.ехе) Это исполняемый файл вашего приложения. Он 
является автономным исполняемым файлом, для 
которого больше ничего не требуется, если только 
вы не используете библиотеки, содержащиеся в 
пакетах, DLL, ОСХ и т.д. 


Объектный файл модуля Это откомпилированный файл модуля (.cpp), кото- 

(.obj) рый компонуется в окончательный исполняемый 
файл. 

Динамически присоединяе- Этот файл создается в случае, если вы проектиру- 

мая библиотека (.dll) ere свою собственную DLL. 

Файл таблицы символов Двоичный файл, используемый отладчиком в про- 

(.tds) цессе отладки приложения. 


Файлы выборочной компо- Файлы с расширением, начинающемся с il (.ilc, 

новки (.il?) ld, .ilf, 115), позволяют повторно компоновать 
только те файлы, которые были изменены после 
последнего сеанса. 
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И, наконец, другие файлы Windows, которые могут использоваться C++Buil- 


der: 

Файлы справки (.hIip) Это стандартные файлы справки Windows, кото- 
рые могут быть использованы вашим приложени- 
ем C++Builder. 

Файлы изображений или Эти файлы обычно используются в приложениях 

графические файлы (.wmf, Windows для создания привлекательного и друже- 

-bmp, .ico) ственного пользовательского интерфейса. 


Из всех перечисленных файлов (а могут использоваться еще и другие) важней- 
шими являются файлы .ерр, .h, .dfm, .bpr, .res. Это те файлы, которые вы, напри- 
мер, должны перенести на другой компьютер, если захотите продолжить на нем 
работу над своим проектом. Все остальные файлы C++Builder создаст автоматиче- 
ски в процессе компиляции проекта и его отладки. 

Главной частью вашего приложения является головной файл .cpp с функцией 
WinMain, с которой начинается выполнение вашей программы и которая обеспе- 
чивает инициализацию других модулей. Он создается и модифицируется 
C++Builder автоматически в процессе вашей разработки приложения. Имя, кото- 
poe вы даете файлу проекта, когда сохраняете его, становится именем исполняемо-. 
го файла. Сведения об этом файле вы можете найти в разделе 1.5.3. 

Все изменения файла проекта при добавлении новых форм, изменении имен 
форм и т.п. поддерживаются C++Builder автоматически. Если вам необходимо по- 
смотреть исходный файл проекта, надо выполнить команду View | Project Source. Ho 
обычно это вам не требуется. 


о оный 


Предупреждение 
Не следует без нужды изменять файл проекта. Это может привести к несогласованности ис- 
пользуемых имен ик прочим неприятностям. 
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Информация о формах C++Builder хранится в трех файлах: .dfm, .cpp и .h. В 
двоичном или текстовом файле с расширением .dfm хранится информация о внеш- 
нем виде формы, ее размерах, местоположении на экране ит.д. Щелкнув на форме 
правой кнопкой мыши, вы можете выбрать из контекстного меню раздел View as 
Text и увидеть в Редакторе Кода файл .dfm в текстовом виде. Можете что-то изме- 
нить в этом файле. Щелкнув правой кнопкой мыши в окне Редактора Кода на фай- 
ле .dfm, вы можете выбрать в контекстном меню раздел View as Form и опять уви- 
деть файл в виде формы. 

Основной файл, с которым вы работаете — файл реализации модуля .ерр, в ко- 
тором хранится код, соответствующий данной форме. В текстовом заголовочном 
файле с расширением „В хранится объявление класса вашей формы. Весь основной 
текст этого файла C++Builder формирует автоматически по мере проектирования 
вами формы. Но иногда вам требуется вручную вводить в этот файл объявления 
каких-то своих функций, типов, переменных. Вы можете загрузить этот файл в 
Редактор Кода, щелкнув в его окне с файлом реализации модуля .cpp правой кноп- 
кой мыши и выбрав из всплывшего меню команду Open Source/Header File. 

Имена всех трех файлов, описывающих модуль, одинаковы. Вы задаете это 
имя, когда в первый раз сохраняете ваш модуль. 

Вы можете создавать модули, не привязанные к конкретным формам. Напри- 
мер, в большом приложении полезно иметь модуль (заголовочный файл и файл 
реализации), содержащий константы, переменные, функции, используемые в раз- 
личных модулях. Наличие такого модуля позволяет сократить число взаимных 
ссылок различных модулей. К, тому же подобный модуль может использоваться в 
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разных ваших проектах. Чтобы создать в вашем проекте новый модуль, не связан- 
ный с какой-либо формой, надо выполнить команду File | New и в открывшемся 
окне New Items на странице New щелкнуть на пиктограмме Unit. 


ОМНИ МИ НБУ ЧАИ ОКЕАНИИ ДИАКОН 


Хорош ий стиль программирования --————--—-----еееооомоно 


Полезно создавать в приложении модуль, не связанный с формой, в который помещать опи- 

сания типов, констант, переменных, функций, используемых другими модулями. Это способст- 

вует хорошей структурированности программы, поддерживает единое понимание типов, 

констант, переменных во всех модулях и уменьшает количество взаимных ссылок модулей 

друг. на thie an самым ро НИ и ние, ho ими 

те вы поочередно работаете над многими проектами, то пространство на 
диске может неэффективно забиваться ненужными файлами. В этом случае полез- 
но удалять вспомогательные файлы тех проектов, над которыми вы временно не 
работаете. Прежде всего это относится к файлам .obj, .res, .tds, .il?, .-*. Особо об- 
ратите внимание на файлы .tds, объем которых. может быть очень большим (не- 
сколько мегабайт). 


2.4.2 Создание и сохранение нового проекта 


2.4.2.1 Организация каталогов проекта 


Разговор о создании нового проекта начнем с одного важного совета. 


А КАКА ЗАЛИВА LE REV ELIE ИИ 


Хо рош vi Hi стил b п ро грамми ро ва fat ия ПИ К Ию 


Заведите себе за правило отводить для каждого нового проекта новый каталог (папку Win- 

dee ates SPyTPG * каталогов ‚сущестиенно ее ровен над коровки 

Связан этот совет с тем, что если помещать несколько проектов в один ката- 
лог, то и вы, и, возможно, C++Builder скоро запутаетесь в том, какие файлы к Ka- 
кому проекту относятся. Размещение проектов в разных каталогах избавит вас в 
дальнейшем от многих неприятностей. 

Если у вас возникает несколько вариантов выполнения проекта, а обычно так 
и бывает, то желательно внутри каталога проекта создавать подкаталоги для каж- 
дого варианта. Удобная структура каталогов существенно облегчает работу над 
серьезными проектами. 

Новый каталог вы можете создать средствами Windows перед началом проекта 
или, если работаете с Windows 95, 98 или МТ, то создавать его можно в диалоговом 
окне сохранения файлов с помощью соответствующей быстрой кнопки. 


2.4.2.2 Создание нового проекта 


Начать новый проект можно несколькими способами. Один уже рассматри- 
вался выше: команда File | New Application. Можно сделать то же самое с помощью 
соответствующей быстрой кнопки (см. таблицу 2.1 в разделе 2.2.3). Еще один 
путь — команда File | New. При выборе этой команды открывается окно New Items 
(новые элементы), показанное на рис. 2.13.. 

Это окно является витриной Депозитария объектов (Object Repository) — xpa- 
нилища образцов компонентов, форм и проектов. Вы можете и сами создавать ка- 
кие-то свои формы, компоненты, проекты и включать их в Депозитарий. Подроб- 
нее о работе с Депозитарием см. в разделе 7.4 главы Т. 

В данном случае, мы хотим открыть новый проект. Это можно сделать, щелк- 
нув на пиктограмме Application (приложение), расположенной на странице New (но- 
вый). Пиктограмма Application создает уже привычное вам приложение с пустой 
формой. Вы можете также воспользоваться и некоторыми другими вариантами 
приложений, пиктограммы которых расположены на странице Projects (рис. 2.14). 
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Рис. 2.13 
Страница New окна Депозитария New Items 


Batch File 


Console Wizard Control Panel 


Application 


Срр File 


Puc. 2.14 ©” New Items 


Страница Projects окна Депозитария New Items New _ iv ie PMD! ie ‘Fiala at 
2 “Project -—- ‘Data Modules ae Business. 


. Application Wizard MDI = SD! Application 


Win95/98 Logo 
Application 


Чтобы получить пояснения по содержащимся в Депозитарии объектам, можно 
щелкнуть в окне правой кнопкой мыши и из всплывшего меню выбрать форму ото- 
бражения View Details (детали). Форма отображения изменится (рис. 2.15) и вы смо- 
жете увидеть в колонке Description краткие пояснения предлагаемых вам вариан- 
тов. Например, для приложения Win95/98 Logo Application вы может прочитать, что 
это приложение, удовлетворяющее минимальным требованиям. логотипа Win- 
dows 95/98. 


Рис. 2.15 
Страница Projects окна Депозитария 
New Items в режиме просмотра View : é jon Wa 
Details ication Wi аи Wizard Нога зи Wizard DLL 
Н Standard MDI application frame. 
Generic SOI style application. 
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Проекты, выбираемые на этой странице, включают в себя уже не просто пус- 
тые формы. Так, щелкнув на выделенной на рис. 2.14 и 2.15 пиктограмме 
Win95/98 Logo Application, вы создадите приложение почти готового текстового ре- 
дактора. Приняв его за основу, вы можете, конечно, как угодно его перерабаты- 
вать, добавлять новые функции, переводить надписи на русский язык ит.д. Прак- 
тически такой же редактор, но ориентированный на Windows 2000, получается 
при выборе пиктограммы Win 2000 Logo Application. 

Интересным является проект с пиктограммой MDI Appliucation. Это много- 
оконный текстовый редактор, в котором реализованы все стандартные функции 
подобных приложений MDI (приложений с множеством документов типа Word, 
Excel и т.п. — см. о них в разделе 4.5.4 главы 4). | 

Обратите внимание также на пиктограмму Application Wizard. Выбрав ее, вы 
попадете под опеку одного из Мастеров (Wizard) C++Builder, который проведет Bac 
через ряд диалоговых окон (подробное описание их вы можете найти в книге [1]), 
отвечая на вопросы которых вы сможете создать приложение с меню, инструмен- 
тальной панелью, диалогами ит.д. Пример созданной формы показан на рис. 2.16. 
В ней имеется заказанная вами в диалоге инструментальная панель, быстрые 
кнопки которой связаны с соответствующими разделами меню, внесены компонен- 
ты-диалоги открытия и сохранения файлов, печати и установки принтера, в быст- 
рых кнопках и в разделах меню внесены тексты ярлычков и развернутых подска- 
30K, которые при работе приложения и при перемещении курсора над разделами 
меню появляются в строке состояния, помещенной внизу окна. Более того, в текст 
модуля внесены заготовки кодов с соответствующими комментариями. Остается 
только перевести заголовки меню и тексты комментариев на русский язык, убрать 
какие-то не нужные вам разделы меню и добавить нужные, дописать заготовки ко- 
дов. Конечно, вам придется в эту заготовку добавлять свои коды. Но значительную 
часть работы по внешнему оформлению Мастер Приложений проделает за вас. 


Рис. 2.16 
Форма, сгенерированная Мастером 
Приложений 


Все это, конечно, прекрасно. Возможность пользоваться Мастером Приложе- 
ний или готовыми проектами из Депозитария выглядит, безусловно, привлека- 
тельной. Но я бы не советовал увлекаться этими возможностями. Пользуясь не 
пустыми эскизами приложений и форм вы всегда рискуете, что в них окажутся ка- 
кие-то не замеченные вами особенности, которые не позволят приложению рабо- 
тать так, как вам хотелось бы. К тому же приложение будет выглядеть стандарт- 
ным, лишенным индивидуальности. Когда вы освоитесь с C++Builder, лучше все 
приложение делать самому, начиная с пустой формы. А проекты из Депозитария, 
так же как и примеры, поставляемые с C++Builder, полезно посмотреть, изучить, 
опробовать, перенести какие-то приемы программирования в свои приложения, но 
не более того. 

Можно еще упомянуть о возможности создания с помощью C++Builder кон- 
сольных проектов — программ, ‘использующих \У1132 и запускаемых в 
Windows 95/98 и МТ в окне DOS. Для создания подобного приложения надо вы- 
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полнить команду File | New и в окне Депозитария на странице New (рис. 2.13) вы- 
брать пиктограмму Console Wizard. Однако, в дальнейшем приложения этого вида 
мы рассматривать не будем, поскольку они могут найти только очень ограничен- 
ное применение. 

Из новых Мастеров, появившихся в Депозитарии C++Builder 5 на странице 
New, можно отметить также Control Panel Application и Control Panel Module, позво- 
ляющие создавать приложения, включаемые в «Панель управления» Windows. 
Пиктограмма Control Panel Application соответствует приложению, размещаемому в 
«Панели управления». В этом приложении автоматически создается один модуль. 
Если требуется еще один модуль, он включается пиктограммой Control Panel 
Module. Приложение представляет собой динамически связываемую библиотеку 
DLL специального вида, которая дает доступ к конфигурации среды Windows. В 
модуль приложения автоматически вставляется директива компилятора HE, обес- 
печивающая изменение расширения результирующего файла на .cpl. 

Объект приложения имеет класс TAppletApplication. В этом классе, являю- 
щемся контейнером модулей класса TAppletModule, определен ряд свойств и пре- 
жде всего свойство AppletIcon — пиктограмма, которая появляется во время вы- 
полнения «Панели управления» в ее окне. Из числа событий прежде всего надо от- 
метить OnActivate, наступающее при двойном щелчке пользователя на пикто- 
грамме приложения в окне «Панели Управления». 

Установка приложения в «Панели управления» происходит, если вы щелкне- 
те в окне модуля приложения правой кнопкой мыши и выберете во всплывшем 
меню раздел Install Control Panel Applet. После успешной установки вы можете вы- 
звать из того же окна приложения «Панель управления», выбрав в контекстном 
меню раздел Launch Control Panel. Раздел того же меню Uninstall Control Panel позволя- 
ет удалить ваше приложение из «Панели управления». 


2.4.2.3 Сохранение проекта 


Первое действие, которое я рекомендовал бы вам выполнить после создания 
нового проекта — сохранить его. 
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После того, как вы создали приложение с пустой формой, сразу сохраните его в нужном ка- 
талоге. И в течение работы над проектом почаще выполняйте сохранение. 
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Если вы начинаете работу с того, что сохраняете проект, и в дальнейшем pery- 
лярно повторяете сохранение, вы можете не опасаться любых неожиданностей 
типа сбоя компьютера или C++Builder, вызванных техническими причинами или 
недопустимыми действиями вашего собственного еще не отлаженного приложения 
при его запуске. Но есть и еще аргумент в пользу немедленного сохранения проек- 
та и модулей. В многооконных приложениях, с которыми вы встретитесь не раз на 
страницах этой книги, это позволяет сразу задать модулям имена, которые будут 
использоваться в программе для взаимных ссылок модулей друг на друга. Если вы 
не выполнили сразу сохранение формы, то вынуждены сначала ссылаться на ее 
имя по умолчанию, а в дальнейшем изменять эти ссылки. 
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Всегда сохраняйте проект под каким-то осмысленным именем, изменяя тем самым имя проек- 
та, заданное C++Builder по умолчанию. Иначе очень скоро вы запутаетесь в бесконечных 
программах Project], лежащих в различных ваших каталогах. К тому же учтите, что имя фай- 
ла проекта будет в дальнейшем именем вашего выполняемого модуля. Наверное, не очень 
хорошо будет отдавать заказчику проект с таким странным названием, как Project]. 
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Сохранить проект можно командой File | Save All. Удобно также использовать 
соответствующую быструю кнопку. При первом сохранении C++Builder спросит у 
вас имя файла сохраняемого модуля, а затем — имя файла проекта. Тут надо 
иметь в виду, что C++Builder не допускает одинаковых имен модулей и проектов. 
Это естественно, поскольку файлы модуля и головной файл проекта имеют одина- 
ковое расширение .cpp и, значит, должны различаться именами, чтобы не затереть 


на диске друг друга. 
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Не задавайте одинаковые имена различным файлам и вообще стремитесь не использовать в 
ие НИ имена. C++Builder этого не приемлет. 
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Всегда при ‘сохранении модулей задавайте осмысленные имена ей 

Нему не стоит соглашаться при сохранении с именами, предлагаемыми 
C++Builder по умолчанию — Unitl, Unit2 ит.п.? Имя файла модуля будет и име- 
нем самого модуля, и именем его заголовочного файла. В проекте с одним модулем 
имя Unitl, возможно, He так уж и страшно. Но если у вас в проекте будет несколь- 
ко модулей, то вряд ли вам будет удобно все время помнить, что такое Unitl, а что 
такое Unit5. Кроме того представьте себе, что вы на некоторое время прекратили 
работу над своими проектами, а потом опять ее возобновили. Или сопровождение 
ваших проектов осуществляется не вами, а кем-то другим. Вы уверены, что легко 
будет разобраться в многочисленных Projectl и Unitl непонятного назначения? 
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При разработке простых прототипов проектов удобно задавать имена файлов проектов и 
модулей одинаковыми, различая их только префиксом «Р» или «Ц» соответственно. Напри- 
мер, файл проекта — РЕЯйог1, файл модуля — UEditor]. Это упрощает понимание того, ка- 
кие файлы к какому варианту проекта относятся, поскольку на начальных стадиях проекти- 
рования у вас может появиться несколько альтернативных вариантов одного и того же про- 
екта. 
Итак, рекомендации по созданию нового проекта сводятся к следующему. 

Ш Создайте новый каталог для своего нового проекта. 

Ш Создайте новый проект командой File | New Application. 

Ш Сразу сохраните проект и файл модуля командой File | Save All. 


В последующих сеансах работы вы можете открыть сохраненный проект ко- 
мандой File | Ореп Project. Но если вы работали с проектом недавно, то много удобнее 
открыть его командой File | Reopen. А еще удобнее воспользоваться стрелочкой ря- 
дом с соответствующей этой команде быстрой кнопкой (см. раздел 2.2.3). В обоих 
случаях открывается окно, в котором вы легко найдете несколько проектов, с ко- 
торыми работали в последнее время, а также ряд файлов, с которыми вы работали. 

Имеется еще более удобный способ автоматически открывать при загрузке 
C++Builder тот проект, с которым вы работали в предыдущем сеансе. Для того, 
чтобы обеспечить себе такую возможность, надо выполнить команду Tools 
Environment Options. В открывшемся многостраничном диалоговом окне надо перей- 
ти на страницу Preferences и включить индикатор Project desktop группы опций ав- 
тосохранения Autosave options (подробности см. в разделе 14.2.10). Тогда при каж- 
дом очередном запуске C++Builder будет загружаться ваше последнее приложение 
предыдущего сеанса и будут открываться все окна, которые были открыты в мо- 
мент предыдущего выхода из C++Builder. Это очень удобно, если вы намерены 
продолжать работу над тем же проектом. 
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Вы можете сохранить свой проект в Депозитарии. Впоследствии при появле- 
нии схожей задачи вы можете заимствовать его оттуда, что-то в нем изменить и та- 
ким образом сэкономить себе много времени. Методика включения своих проектов 
и форм в Депозитарий подробно рассмотрена в главе 7 в разделе 7.4. 


2.4.3 Менеджер проектов 


Менеджер Проектов (Project Manager) — это инструмент управления группа- 
ми проектов. Группа проектов — это термин обозначающий группу родственных 
проектов, с которыми удобно работать параллельно. Например, это могут быть 
проекты клиента и сервера, обменивающихся какой-то информацией, или проект, 
создающий библиотеку DLL, и проект, использующий ее. 

Открывается Менеджер Проектов командой View | Project Manager. Если в дан- 
ный момент нет открытого проекта, то в окне Менеджера Проектов будет написано 
<No Project Group>. Если же какой-то проект открыт, то вид окна Менеджера Про- 
ектов показан на рис. 2.17 а. В данном случае формируется группа с именем по 
умолчанию Рго]ес&Сгоир1, содержащая только один открытый проект. В окне ви- 
ден состав проекта. Около строк, относящихся к различным модулям, вы можете 
видеть символ плюс «+». Сделав на нем щелчок, можно раскрыть состав этого мо- 
дуля. Сделав двойной щелчок на строке, относящейся к тому или иному модулю 
или форме, вы увидите соответственно или текст модуля в окне Редактора Кода, 
или указанную форму. Таким образом, Менеджер Проектов дает удобный способ 
навигации по модулям сложного проекта. 


Рис. 2.17 a) Project Manager 2 
Окно Менеджера Проектов с одним (а) и 
двумя (6) проектами в группе 
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+) >] U2Mess1.cpp D:\Tests\MESSAGES 

:. FEY Form2 D:\Tests\MESSAGES 
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Кнопка New (новый) позволяет добавить в группу новый проект. Действие 
кнопки Кетоуе (удалить) зависит от того, какая строка в Менеджере Проектов в 
этот момент выделена. Если выделен модуль или форма, то удаляться будет имен- 
но этот объект. A если выделена строка файла .exe, то удаляться будет сам проект. 
Впрочем, в любом случае предварительно появится диалоговое окно с запросом, 
действительно ли вы хотите удалить тот или иной объект. 

Вы можете также воспользоваться в работе всплывающим меню, которое вы- 
зывается при щелчке правой кнопкой мыши. Если в этот момент у вас будет выде- 
лен в окне Менеджера Проектов интересующий вас модуль, то во всплывшем меню 
вы увидите разделы Open (открыть), Remove From Project (удалить из проекта), Save 
(сохранить), Save Аз (сохранить как) и ряд других. Если вы выделили в окне не MO- 
дуль, а проект — имя файла .ехе, то всплывет уже другое меню, в котором будут, в 
частности, разделы Add (добавить новую форму или модуль), Remove File (удалить 
файл — появится диалоговое окно, в котором вы можете выбрать удаляемый мо- 
дуль), Save (сохранить проект) и ряд других. 

Добавить в группу еще один проект можно двумя способами. 

Если вы хотите добавить новый проект, вы можете щелкнуть в окне Менедже- 
ра Проектов на кнопке New или выделить в окне имя группы проектов, щелкнуть 
правой кнопкой мыши и выбрать из всплывшего меню раздел Ада New Project (до- 
бавить новый проект). Вы попадете в уже рассмотренное нами окно Депозитария и 
можете выбрать в нем вид открываемого проекта, в частности, Application — но- 
вый проект с пустой формой. 1 

Если же вы хотите добавить в группу один из разработанных вами ранее про- 
ектов, то, выделив в окне имя группы проектов и щелкнув правой кнопкой мыши, 
надо выбрать из всплывшего меню раздел Add Existing Project (добавить существую- 
щий проект). Далее в обычном окне открытия файла вы можете указать добавляе- 
мый файл проекта. 

При добавлении в группу нового проекта в окне Менеджера Проектов будет 
отображаться уже информация о всех проектах группы (рис. 2.17 6). 

Вы можете сохранить файл вашей группы, если выполните команду File | Save 
As или если выделите в окне Менеджера Проектов имя группы, щелкнете правой 
кнопкой мыши и из всплывшего меню выберете команду Save Project Group или 
Save Project Group As. Группа проектов сохраняется в текстовом файле с расширени- 
ем .bpg. В дальнейших сеансах работы вы можете открыть этот файл той же ко- 
мандой File | Open Project или File | Reopen, которой вы открываете проект. 

Окно Менеджера Проектов — встраиваемое, так что вы можете встроить его, 
например, в окно Инспектора Объектов и оно не будет занимать на экране лишнего 
места. 

Теперь посмотрим, что дает нам объединение нескольких проектов в группу. 
Прежде всего, вы можете параллельно работать над всеми проектами группы, от- 
крыв их модули в окне Редактора Кода. Для того, чтобы открыть нужный модуль, 
достаточно сделать двойной щелчок на его имени в окне Менеджера Проектов. Вы 
можете также выполнить любой проект группы. В каждый данный момент актив- 
ным является один из проектов. Имя активного проекта выделено в окне Менед- 
жера Проектов жирным шрифтом. Оно же видно в выпадающем списке в верхней 
части окна Менеджера Проектов. Например, в окне рис. 2.17 б активным является 
проект Pmess2. Если вы выполните команду Кип | Run или нажмете F9, то именно 
этот проект будет компилироваться и выполняться. Вы можете сделать активным 
другой проект. Это можно сделать, выделив нужный проект в окне Менеджера 
Проектов и щелкнув на кнопке Activate. Второй способ — выбрать в выпадающем 
списке проектов имя соответствующего проекта и этот проект будет активизиро- 
ван. Третий способ — щелкнуть на имени проекта, который надо активизировать, 
правой кнопкой мыши и выбрать BO всплывшем меню команду Activate. Четвертый 
способ добиться того же — нажать кнопочку справа от быстрой кнопки выполне- 
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ния в панели быстрых кнопок ИСР и из выпавшего списка выбрать тот выполняе- 
мый файл, который вы хотите выполнять. 

Описанные приемы позволяют, если вы работаете в Windows МТ, одновремен- 
но выполнять и отлаживать несколько проектов одной группы. Для этого сначала 
надо выполнить компиляцию всех проектов командой Project | Build А! Projects. По- 
сле этого вы можете активизировать один файл и запустить его на выполнение. За- 
тем, не закрывая ero, вернуться в MCP C++Builder, активизировать другой проект 
группы и тоже запустить его на выполнение. При этом у вас окажется два выпол- 
няемых файла проекта, причем вы можете отлаживать их совместную работу (о 
способах отладки программ будет рассказано позднее). 

В Windows 95/98 такая параллельная отладка нескольких проектов невоз- 
можна. При необходимости выполнять одновременно несколько проектов вы мо- 
жете один из них запустить на выполнение в режиме отладки. из C++Builder, а oc- 
тальные надо запустить вне C++Builder средствами Windows, например, програм- 
мой «Проводник». 

Отметим еще одну новую особенность Менеджера Проектов, введенную в 
C++Builder 5 — возможность задания локальных опций для какого-то узла дерева 
файлов. Это позволяет компилировать проект с разными опциями для разных мо- 
дулей. Например, для уже хорошо отлаженных модулей вы можете убрать вклю- 
чение в выполняемый файл отладочной информации, убрать отображение сообще- 
ний компилятора и т.п. Это сократит размер выполняемого модуля и ускорит ком- 
пиляцию. 

Настройка компилятора подробно рассмотрена в разделе 14.2.9. А пока огра- 
ничимся изложением техники задания именно локальных опций. Читатель может 
пока пропустить этот материал и вернуться к нему после того, как ознакомится с 
опциями настройки. 

Чтобы задать локальные опции компиляции, надо выделить в окне Менедже- 
ра Проектов узел файла .cpp или .с и выбрать в контекстном меню, всплывающем 
при щелчке правой кнопкой мыши, раздел Edit Local Options. Вы попадете в окно оп- 
ций проекта (см. раздел 14.2.9), в котором будут видны только те страницы, на ко- 
торых можно задавать локальные опции. При изменении каких-то опций они бу- 
дут выделяться цветом, что позволит вам в дальнейшем легко определить, что 
именно вы изменяли. Отличие окна опций проекта при задании локальных опций 
от обычного вида этого окна (см. например, рис. 14.15) будет заключаться в том, 
что внизу будет отображаться сообщение «Right Click to Revert». Его смысл в том, 
что щелкнув правой кнопкой мыши вы можете повлиять на вводимые вами ло- 
кальные опции. При таком щелчке всплывет контекстное меню. Его раздел Revert 
All позволяет отказаться от всех введенных ранее локальных изменений. В этом 
случае для данного узла начнут применяться опции, установленные для всего про- 
екта. Раздел контекстного меню Change Override Color позволяет изменить цвет вы- 
деления локальных опций. 

Если для какого-то модуля вы ввели локальные опции, узел этого модуля в 
окне Менеджера Проектов будет отмечен галочкой. Это будет служить вам напоми- 
нанием о том, что данный модуль компилируется в необычном режиме. 


2.4.4 Управление проектами 


2.4.4.1 План работ — список To-Do List 


Список To-Do List, появившийся только в C++Builder 5, представляет собой 
запись тех текущих задач, которые надо решить при разработке проекта. Эти зада- 
чи могут заноситься в список непосредственно или передаваться в него из кода ва- 
ших модулей. Ведение списка облегчает планирование работ, позволяет ранжиро- 
вать задачи, отслеживать очередность и своевременность их решения. 
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`Список может быть создан для каждого проекта и хранится в файле с расши- 
рением .todo. Посмотреть список То-Оо List, связанный с текущим проектом, можно 
командой View | To-Do List. Если вы выполните эту команду, перед вами откроется 
окно, вид которого представлен на рис. 2.18. 


Рис. 2.18 


Окно списка To-Do List 


О =. Главная Форма Иванов — Прототип 
М] ЕЛ Формадокуыета Петров  Прожовия 


ae ...\Utichedit.cpp Сидоров Код 
Иванов Полный вариант 


Петров Полный вариант | 


и ии м ними 


а: ‘re iterns pending 


Список содержит следующие столбцы: 


о а О О нае PRE ERR SS АК 


Action №ет Задачи, подлежащие решению. Для каждой задачи отображается: 


Priority 


Module 


Owner 


Category 


Индикатор 


Пиктограмма 


Текст 


Указывает, решена ли уже эта задача. Флажок ин- 
дикатора означает, что решена. При этом, как вид- 
но из рис. 2.18 (вторая строчка) строка задачи ото- 
бражается зачеркнутой. Если список отображается 
с выключенной опцией Show Completed Items («По- 
казывать решенные задачи» — об опциях будет 
рассказано позднее), то выполненные задачи вооб- 
ще не появляются в списке 


Указывает характер задачи: пиктограмма окна со- 
ответствует задаче, внесенной непосредственно в 
список, а пиктограмма модуля (на рис. 2.18 в тре- 
тьей строчке) соответствует задаче, внесенной в 
код модуля. Если пиктограмма модуля выглядит 
серой, это означает, что данный модуль не являет- 
ся частью текущего проекта 


Описывает задачу. Если текст отображен серым, 
это означает, что задача внесена в код модуля, яв- 
ляющегося частью данного проекта, но не открыто- 
го в данный момент в Редакторе Кода. Двойной 
щелчок на такой задаче приведет к открытию соот- 
ветствующего модуля в Редакторе Кода 


В заголовке столбца указывается восклицательный знак. Указывает 
уровень приоритета задачи. Наивысшему уровню приоритета соот- 
ветствует 1, самый низкий уровень — 5. Уровень 0 указывает на 
отсутствие приоритета у данной задачи . 


Содержит имя модуля, в котором введена задача. Этот столбец спи- 
ска заполняется автоматически 


Указывает ответственного за решение данной задачи 


Указывает класс данной задачи 
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Щелчок правой кнопкой мыши на списке вызывает контекстное меню, в KOTO- 
ром вы можете выбрать ряд команд и опций: 


Sia Co ee ek ee a ae SER RENE GI IO AA о RY RET GE Ne EC RES 


Add Добавить новую задачу B список. В диалоговом окне вы можете 
указать ее текст (Text), Kmacc(Category), приоритет (Priority) и от- 
ветственного (Owner) 


Delete Удалить задачу из списка. То же самое вы можете сделать про- 
ще, выделив задачу и нажав кнопку Delete 


Edit Редактировать описание задачи. Вы попадаете в диалоговое 
окно, аналогичное окну ввода новой задачи, в котором можете 
отредактировать необходимую информацию. Можете также отме- 
тить завершение выполнения задачи, установив индикатор Done. 
Впрочем, выполнение вы можете отметить и непосредственно в 
окне списка | 


Sort Сортировка отображения списка: Action Нет — по алфавитной по- 
следовательности задач, Status — сначала отображаются решен- 
ные задачи, затем нерешенные, Туре — сначала в алфавитном по- 
рядке располагаются задачи, введенные непосредственно в спи- 
сок, затем введенные в модули, Priority — по приоритету, Module 
— в алфавитной последовательности модулей, Owner — в алфа- 
витной последовательности ответственных, Category — в алфа- 
витной последовательности классов задач. Сортировку можно 
осуществить и проще, щелкнув в окне списка на заголовке соот- 
ветствующего столбца 


Filter Фильтрация задач, отображаемых в списке. Вы можете указать 
классы задач (Categories), ответственных (Owners) и типы задач 
(Нет types), которые хотите отображать. При выборе типов задач 
вы можете установить Current project source files — задачи, добав- 
ленные в файл проекта, Open source files — задачи, добавленные в 
открытые файлы модулей, Project To-Do file — задачи, добавлен- 
ные непосредственно в список 


Show Comple- Опция, включающая отображение уже выполненных задач 
ted Items 


Show ТооПр$ Опция, включающая при перемещениях курсора мыши отобра- 
When Clipped жение во всплывающих окнах полного текста, если он не виден 
полностью в колонке 


Copy As Копирование списка в виде текста (Тех!) или в виде таблицы 
HTML (HTML Table) 


Table Properties Задание атрибутов отображения таблицы (в частности, русских 
заголовков) при использовании опции Copy As | HTML Table 


Рассмотренная выше команда контекстного меню Add позволяет добавлять 3a- 
дачи непосредственно в список. Добавление задачи в файл модуля или проекта осу- 
ществляется из окна Редактора Кода. Откройте в нем требуемый файл и в нужном 
вам месте кода щелкните правой кнопкой мыши и выберите из всплывшего меню 
команду Add To-Do Нет. Вы попадете в то же диалоговое окно, что и при выполне- 
нии команды Add и сможете в нем указать все атрибуты задачи. В результате зада- 
ча не только включится в список, но оператор, соответствующий ей, включится в 
код. Впрочем, вы можете не использовать меню, а просто записать в коде соответ- 
ствующий оператор. Синтаксис этого оператора следующий: 


/* TODO|DONE [п] [-о<ответственный>] [-с<класс>] : <текст> */ 
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Весь оператор заключается в скобки комментария (/* */). Можно вместо этих 
скобок записывать перед оператором два слеша «//». Регистр при записи операто- 
ра не учитывается. Ключевое слово TODO используется для незавершенных задач. 
Если задача выполнена, это слово заменяется на DONE. Обязательными элемента- 
ми оператора являются только ключевое слово и текст. Все остальные опции могут 
отсутствовать. 

Значение опции N указывает приоритет задачи. Опция -о указывает ответст- 
венного за решение данной задачи. Опция -е устанавливает класс задачи. 

Например, оператор 


/* TODO 2 -оСидоров -сКод : Главное меню */ 


задает задачу с именем «Главное меню», класса «Код» с приоритетом 2, за которую 
отвечает Сидоров. 

Введенные в текст операторы отображаются в окне списка и автоматически 
изменяются при работе со списком (например, при включении индикатора выпол- 
нения ключевое слово TODO автоматически заменяется на DONE). 

Исследователь Классов ClassExplorer (см. раздел 2.5.3.2), который в 
C++Builder 5 существенно облегчает ввод в класс свойств и методов, автоматиче- 
ски включает при этом в текст операторы списка То-Шо List в те места кода, в KOTO- 
рых вам требуется ввести собственный текст. Это очень поможет вам, напоминая 
об еще не завершенных фрагментах кода. 


2.4.4.2 Система управления большими проектами Borland TeamSource 


Система Borland TeamSource позволяет организовать управление большими 
проектами, разрабатываемыми рядом исполнителей или несколькими группами 
исполнителей. Впрочем, даже при индивидуальной разработке проекта после того, 
как вы создали в C++Builder несколько приложений или вариантов приложений, 
система TeamSource способна оказать большую помощь в организации ваших про- 
грамм. Вы можете захотеть заархивировать прежние версии приложения прежде, 
чем начинать работу над новой версией, чтобы потом иметь возможность вернуть- 
ся к прежней версии. Ну а если проект большой и над ним работает группа про- 
граммистов, то требуется координация их работы, необходимо обеспечить доступ 
программистов к тем или иным общим для них файлам и в то же время необходи- 
мы гарантии, что один программист случайно не уничтожит или не изменит фай- 
лов, над которыми работает другой программист. 

Система TeamSource позволяет решать указанные задачи, возникающие при 
разработке крупных проектов или большой серии мелких проектов. Система по- 
зволяет архивировать файлы, управлять доступом к файлам, блокируя их непре- 
дусмотренные изменения, позволяет избежать путаницы при работе с множеством 
версий проекта. | 

Система позволяет сохранять в архиве все удачные версии каждого файла. 
Программист может извлечь рабочие файлы из архива, что-то изменить в них, от- 
ладить и затем отправить назад в архив, отметив сделанные изменения, дату и ав- 
тора этих изменений. Возможность блокировки обмена файлами с архивом предот- 
вращает несанкционированное изменение файлов. Вы можете также для каждого 
файла отследить все произведенные в нем изменения на каждом этапе разработки: 
кто, когда и зачем делал те или иные изменения. 

Поскольку система Borland TeamSource включена не во все версии C++Buil- 
der 5, мы ограничимся только ее общим описанием. А детали работы с этой систе- 
мой вы можете найти в книге [1]. 

Основное понятие, используемое в работе с TeamSource — проект TeamSource. 
Это файл с расширением .cpj. Он содержит сведения о включенных в проект 
TeamSource файлах проекта C++Builder, о пользователях, допущенных к ним, ио 
вариантах доступа (только чтение, чтение и запись, административный доступ). В 
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проект TeamSource передаются сведения о локальных каталогах, в которых рас- 
положены управляемые файлы проекта C++Builder. 

_ Файлы проекта TeamSource размещаются обычно в подкаталогах некоторого 
каталога, который мы назовем головным. Один из подкаталогов — Archives пред- 
назначен для хранения архивированных копий версий контролируемых файлов 
проекта C++Builder. В этом же подкаталоге располагается файл проекта .cpj. Ap- 
хив может иметь структуру дерева, отображающего соотношения между управляе- 
мыми файлами. Файлы в архиве читать нельзя. Поэтому проект TeamSource может 
содержать еще один подкаталог — Source, который зеркально отображает структу- 
ру архива, но файлы которого можно читать, а при желании — и редактировать. 

Еще один подкаталог проекта TeamSource — History содержит информацию об 
истории проекта, о том, когда, кем и зачем создавались различные версии. И, на- 
конец, подкаталог Locks содержит информацию о блокировке проекта различны- 
ми пользователями. Такая блокировка, в частности, необходима, когда в структу- 
ре проекта TeamSource производятся какие-то изменения. 

Система TeamSource включает работу с двумя вариантами управления версия- 
ми: PVCS Version Manager и ZLib. Вариант ZLib (Borland.zlib включен в TeamSour- 
ce) обеспечивает более высокую степень сжатия нетекстовых архивных файлов, HO 
зато лишен удобных возможностей автоматического объединения изменений, при- 
сущих PVCS. Для использования обоих вариантов управления версиями в катало- 
ге, в котором расположен файл TeamSrc.exe, должны находиться файлы [ZLib.tsx 
и IPVCS.tsx. Если при установке системы TeamSource обнаруживается, что на 
компьютере не установлена PVCS, то второй из указанных файлов не создается. 

TeamSource является самостоятельным программным продуктом, который мо- 
жет выполняться из своего каталога (файл TeamSrc.exe, папка ...\Borland Team- 
Source, пиктограмма TeamSource). Вызов TeamSource может также осуществляется 
из MCP C++Builder 5 командой главного меню Tools | TeamSource (если такой команды 
в меню нет, значит в вашу версию C++Builder система TeamSource не включена). 

К сожалению, в рамках данной книги нет возможности рассматривать методи- 
ку работы с TeamSource. Te, кто заинтересовался этим инструментом, могут полу- 
чить сведения о работе с TeamSource в книге [1]. 


2.5 Основные проектные операции при создании 
приложения | 


2.5.1 Включение в проект новой формы 


2.5.1.1 Зачем надо включать новые формы 


Во многих случаях ваш проект будет содержать He одну, а несколько форм. 
Кроме того, вы, может быть, захотите убрать из нового проекта пустую форму и 
включить вместо нее другую, разработанную ранее вами или кем-то другим. Напри- 
мер, если вы для какого-то своего проекта разработали форму, запрашивающую па- 
роль пользователя, или форму с информацией о программе и вашим красивым лого- 
типом, то не имеет смысла в новом проекте создавать их заново. Форму с паролем 
вы могли бы взять из прошлого приложения вообще без каких-либо изменений, а в 
форме информации о программе вам достаточно сменить только имя программы. 


Хороший стиль программирования © mmr errr еее 


Для всех включаемых в проект форм, даже если в вашем проекте всего одна форма, зада- 
вайте уникальные имена (свойство Мате), изменяя установленные C++Builder по умолчанию. 
Это существенно облегчит вам повторное использование ваших форм, так как позволит из- 
ост дублирования имен при включении прежиой формы я в новый + HORE 
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2.5.1.2 Включение в проект новой формы 


Включение в проект новой формы может производиться различными способами. 
Если вы хотите включить новую пустую форму, вам достаточно выполнить ко- 
манду File | New Form или нажать соответствующую быструю кнопку. 
Вы можете также воспользоваться различными формами, хранящимися в Де- 
позитарии на страницах Forms и Dialogs. Примеры этих форм приведены на 
рис. 2.19. 


Рис. 2.19 а) 
Стандартные формы из 
Депозитария: Password 
Dialog (а), About box (6), 
Tabbed pages (в), 

Dual list box (r) 


Tabbed Notebook Dialog __ 


Некоторые из готовых форм очень просты, фактически не содержат выполняе- 
мых кодов и, на мой взгляд, много проще создать их самому. Другие включают в 
себя достаточно сложные коды и ими имеет смысл воспользоваться. Несмотря на 
это, я бы рекомендовал все-таки использовать всегда пустую форму. Применение 
шаблонов лишит ваше приложение индивидуальности и единства стиля различ- 
ных окон. А это очень важный критерий хорошего приложения. Заготовками, 
имеющимися в C++Builder, лучше воспользоваться для их изучения, для заимст- 
вования каких-то фрагментов кода или принципов организации пространства 
окна, но не использовать их целиком. Впрочем, если ваша задача заключается в 
быстром создании прототипа приложения, можно воспользоваться и готовыми 
формами, заменив их в окончательном варианте на свои собственные. 


2.5.1.3 Совместное владение формой несколькими приложениями 


Теперь рассмотрим случай, когда вам требуется включить в свой проект фор- 
му, разработанную ранее вами или кем-то еще для другого проекта. Тут возможны 
несколько вариантов действий, имеющих различные последствия. 

Можно включить готовую форму в проект командой Project | Add to Project или 
соответствующей быстрой кнопкой. При этом, если включаемая форма имеет то 
же имя, которое имеет одна из уже имеющихся в проекте форм (например, Form1, 
если вы не привыкли изменять имена форм, принимаемые C++Builder по умолча- 
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нию), то вы получите предупреждение вида: «The project already contains а form or 
module named Forml» — «Проект уже содержит форму или модуль с именем 
Гоги 1». В результате форма в проект не включится. Аналогичный вариант будет, 
если вы не следуете в своей работе уже дававшемуся совету присваивать модулям 
уникальные имена. Если в проекте уже имеется модуль Unitl и вы пытаетесь 
включить из другого каталога модуль формы, тоже имеющий имя Unitl, то вам 
будет выдано такое же предупреждение и новый модуль в проект не включится. 

Разрешить подобные конфликты можно следующим образом. Переименуйте в 
вашем проекте форму, вызвавшую конфликт (задайте для нее новое имя в свойстве 
Маше). Если конфликт вызван совпадением имен модулей, то сохраните конфлик- 
тующий модуль командой File | Save As, дав ему новое имя. После этого можете по- 
вторить попытку добавления в проект новой формы. 
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Учтите, что форма, содержащаяся в одном приложении и включенная описанным способом в 

другое приложение, становится общей для обоих приложений. Если вы сделаете в ней ка- 

кие-то изменения, а потом перекомпилируете оба приложения, то внесенные изменения от- 
разятся на обоих приложениях. 

Введенное описанными действиями совместное владение несколькими прило- 
жениями одной и той же формой имеет свои плюсы и минусы. Если эти приложе- 
ния представляют собой некую группу связанных друг с другом приложений, рас- 
считанных на применение одними и теми же пользователями, то наличие общих 
форм можно только приветствовать. Какие-то усовершенствования, введенные в 
подобной форме, согласованно отобразятся во всех использующих ее приложениях 
(после их перекомпиляции). Например, если это форма, запрашивающая пароль 
пользователя, то, конечно; хорошо, если она будет общей (и значит идентичной) в 
различных приложениях. 

Если же приложения, совместно использующие форму, совершенно разные 
или форма используется в них для разных целей, то, введя изменения в форму в 
одном приложении, вы рискуете испортить прежнее приложение, если соберетесь 
его перекомпилировать. Например, изменив имя программы в форме, описываю- 
щей новое приложение, вы невольно введете то же имя и в прежнее приложение, 
то будет, несомненно, ошибкой. 


2.5.1.4 Создание отдельной копии формы 


Чтобы избежать совместного владения формой несколькими приложениями, 
после того, как вы включили в новое приложение форму из другого приложения, 
перейдите в окне Редактора Кода в модуль этой формы и выполните команду File | 
Save As, сохранив модуль в каталоге нового приложения и, если хотите, под дру- 
гим именем (имя изменять не обязательно). В этом случае разные приложения Oy- 
дут использовать совершенно разные копии одной формы и изменения одной из 
них не затронут другие приложения. 

Можно, конечно, создать копию формы и другими способами. Во-первых, вы 
можете создать ее средствами Windows или MS DOS, просто скопировав соответст- 
вующие файлы из одного каталога в другой. Только не забудьте при этом, что фор- 
ма — это не только файл модуля .cpp, но еще его заголовочный файл .h и файл изо- 
бражения .dfm. Так что копировать надо все три файла. Файл объектного модуля 
можно не копировать, так как он будет создан C++Builder в процессе компиляции. 

Еще один способ создания автономной копии формы — использование меню 
C++Builder. Вы можете в любой момент последовательно выполнить команды File | 
Open, указав файл открываемой формы, и команду File | Save As. Первая из этих ко- 
манд откроет форму, а вторая сохранит ее в указанном вами каталоге под указан- 
ным именем. Преимущество такой операции заключается в том, что вам не нужно 
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думать о совокупности сохраняемых файлов. C++Builder автоматически скопиру- 
ет не только файл .cpp, но и файлы „В и .dfm. 

Если вы заимствуете формы из Депозитария командой File | New (см. рис. 2.19 с 
примерами этих форм), то имеется несколько вариантов такого заимствования: ко- 
пирование, наследование, использование. Вопросы заимствования форм из Депози- 
тария рассмотрены в главе 7 в разделе 7.4. Там же рассказано, как можно сохранять 
в Депозитарии спроектированные вами формы и как создавать иерархию форм. 


2.5.1.5 Просмотр форм и модулей без включения их в проект 


Нередко у вас может возникнуть потребность в процессе работы над проектом 
посмотреть формы и модули из других проектов. Это могут быть формы примеров, 
поставляемых с C++Builder. Или могут быть ранее разработанные вами формы, из 
которых вы хотите взять какие-то операторы, решающие задачу, близкую к той, 
которой вы заняты в данных момент. | 

Открыть некоторый существующий модуль, не включая его в текущий про- 
ект, очень легко. Достаточно выполнить команду File | Open, и указанный вами 
файл модуля окажется в окне Редактора Кода. Вы можете просматривать его и со- 
ответствующую ему форму, копировать через буфер обмена Clipboard какие-то опе- 
раторы или компоненты в свои модули. 

Когда необходимость в открытом модуле отпадет, щелкните на его коде пра- 
вой кнопкой мыши и из всплывшего меню выберите команду Close Раде. Страница 
Редактора Кода с текстом данного модуля и его форма будут закрыты. 


2.5.2 Размещение компонентов на форме 


2.5.2.1 Перенос компонентов со страниц библиотеки на форму 


Для того, чтобы перенести на форму компонент, надо открыть соответствую- 
щую страницу палитры компонентов и найти на ней нужный компонент. В поиске 
вам очень помогут ярлычки, появляющиеся, если вы задерживаете курсор над той 
или иной пиктограммой. Выделите курсором нужный вам компонент, а затем 
щелкните мышью в том месте формы, куда вы хотите поместить компонент. Воз- 
можен и другой вариант — двойной щелчок на компоненте. Тогда компонент пере- 
несется в центр формы, а затем вы можете его отбуксировать в нужное место. 

Если вам надо разместить на форме несколько компонентов одного типа, то на- 
жмите сначала клавишу ЭЙ и, удерживая ee, щелкните на пиктограмме компо- 
нента на соответствующей странице библиотеки. После этого, отпустив Shift, щелк- 
ните несколько раз в разных местах формы. Каждый ваш щелчок будет размещать 
новый компонент. Чтобы прервать этот процесс, нажмите кнопку указателя со 
стрелкой, направленной по диагонали вверх и налево, в левой части палитры. Эту 
же кнопку вы можете нажать, если, выбрав компонент на странице, вы раздумали 
переносить его на форму. 

Иногда вы знаете имя компонента, но не помните, на какой странице он распо- 
ложен и не можете его найти. В этом случае вам может помочь команда View | 
Component List. При ее выполнении вам откроется диалоговое окно (рис. 2.20), co- 
держащее алфавитный список всех компонентов. В нем вы можете найти нужный 
компонент по имени. В этом вам может помочь имеющееся вверху окно быстрого 
поиска по имени Search by name. По мере набора в нем первых символов имени ука- 
затель перемещается на соответствующие разделы списка. Выбрав нужный компо- 
нент, вы можете нажать кнопку Add to form внизу окна или сделать двойной щел- 
чок на выбранном компоненте, и он перенесется на форму. Если вы не уверены, тот 
ли компонент нашли, нажмите клавишу Fl, и вам будет показана справка по выде- 
ленному компоненту. 
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Рис. 2.20 Icononents | 
Окно алфавитного списка всех компонентов я. а. 
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Удалить ошибочно перенесенный на форму компонент очень просто: выделите 
его и нажмите клавишу Delete. 
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Приучите себя сразу при переносе компонента на форму изменять его имя Мате, принятое 
по умолчанию. Имя должно быть осмысленным, чтобы потом, разбираясь в коде, вы легко 
могли бы понять, что означает та или иная фикция, 1 тот или иной компонент. 


IOLA T МИСКУ НИКИ РАННИМИ УЗИНАНК УИ И SLSR AEE AS, О ка IE DION NIG DEALT EROS BOLE IO IRIE REET R MAE, 


Настоятельно рекомендую следовать этому совету. Тем самым вы сэкономите 
себе много времени. Представьте себе простенькую форму, где имеется десяток 
кнопок, десяток меток и пара десятков разделов меню. Уверяю вас, что если вы не 
даете компонентам осмысленные имена, то очень скоро вы начнете мучительно 
размышлять, что же это за кнопка Button7, щелчок которой вы обрабатываете в 
данной функции, и почему в нем задается какое-то значение надписи неизвестно 
где расположенной метки Label3. A уж на поиски таинственного раздела меню 
№18 вы точно потратите немало времени. Так что любите себя, давайте компонен- 
там понятные вам имена. 

Перенеся компонент на форму, вы можете буксировать его в нужное место, мо- 
жете изменять его размеры. Для этого выделите нужный элемент. Он станет окру- 
жен рамкой с маркерами. Потяните курсором за один из маркеров и размер компо- 
нента будет изменяться. При задержке курсора над размещенным на форме компо- 
нентом появляется ярлычок с его именем, а при нажатии кнопки мыши на компо- 
ненте, при его буксировке или изменении размеров появляется ярлычок с размера- 
ми компонента. 


2.5.2.2 Родители и владельцы компонентов — Рагет и Омтег 


Часто компоненты размещаются не непосредственно на формах, а на панелях, 
зрительно объединяющих группы компонентов по их назначению. В этом случае 
сначала на форме должны быть размещены панели, а потом на них располагаются 
компоненты. 

Оконный компонент — форма, панель и т.д., включающий в себя как контей- 
нер другие компоненты, выступает по отношению к ним как родительский компо- 
нент. У каждого компонента есть родитель. Им может быть форма или другой 
оконный компонент. В процессе выполнения приложения вы можете узнать роди- 
теля того или иного компонента по его свойству Parent. Это свойство можно чи- 
тать и изменять только во время выполнения, в Инспекторе Объектов вы его не 
найдете. 

Что дает понятие родительского компонента? Компонент может наследовать 
многие свойства своего родителя. Для всех визуальных компонентов вы можете 
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увидеть в Инспекторе Объектов такие свойства, как ParentFont и ParentShow- 
Hint, для оконных компонентов имеется еще свойство Рагеп СИЗО. Эти свойства 
указывают (если их значения установлены в true), что дочерний компонент насле- 
дует от родительского соответственно атрибуты шрифта, показа ярлычков, атрибу- 
ты своего оформления. Кроме того, значения свойств Left и Top, которые вы може- 
те видеть в Инспекторе Объектов для любого визуального компонента и которые 
определяют положение левого верхнего угла компонента, измеряются в системе 
координат родительского компонента. Таким образом, например, при перемеще- 
нии родительского компонента будут синхронно перемещаться и все его дочерние 
компоненты. Свойство Anchors определяет привязку дочерних компонентов к гра- 
ницам родительского компонента. В разделе 4.2.2 будет показано, как это свойство 
может обеспечивать изменение местоположения и размеров дочерненго компонен- 
та при изменении границ родительского компонента. 

Имеется еще два важных свойства, которые связывают дочерние компоненты 
с родительским. Это свойства Visible — видимый, и Enabled — доступный. Если в 
процессе выполнения приложения сделать в родительском компоненте Visible рав- 
ным false, то станет невидимым не только родительский, HO и все его дочерние 
компоненты. Аналогично, если в процессе выполнения приложения сделать в ро- 
дительском компоненте Enabled равным false, то станут недоступными все его до- 
черние компоненты. Т.е. пользователь не сможет нажимать кнопки и производить 
любые другие действия в пределах данного родительского компонента. 

Таким образом, понятие родительского компонента очень важное и его смысл 
выходит далеко за рамки просто эстетического оформления окна формы. 

Отметим еще одно свойство компонентов, которое часто путается со свойством 
Parent. Это свойство Owner — владелец данного компонента. Свойство Owner ус- 
танавливается в момент создания компонента в процессе выполнения приложе- 
ния. Владелец компонента — этот тот компонент, при уничтожении которого (ос- 
вобождении занимаемой им памяти) уничтожится и данный компонент. Этим и ог- 
раничивается связь между владельцем и компонентами, которыми он владеет, в 
отличие от множества указанных выше свойств, связывающих родительский и до- 
черние компоненты. 

По умолчанию родителем и владельцем всех компонентов, размещенных на 
форме, является сама форма. Но если в процессе проектирования компонент раз- 
мещается не непосредственно на форме, а на другом оконном компоненте, напри- 
мер, на панели, то родителем для него становится эта панель. 

Все дочерние компоненты в оконном элементе располагаются в так называе- 
мой 7-последовательности. Для перекрывающихся компонентов (располагающих- 
ся друг на друге) 7-последовательность определяет, какой из них будет виден. Ви- 
ден тот, который расположен в этой последовательности выше. 

Обычно последовательность компонентов соответствует той, в которой они по- 
мещались на форму. Однако неоконные компоненты типа меток всегда лежат в 
7-последовательности ниже любых оконных компонентов типа панелей и кнопок. 


2.5.2.3 «Многослойное» размещение компонентов на форме 


Рассмотрим теперь особенности размещения, связанные с обсуждавшимся 
выше понятием родительского компонента. Компоненты очень часто размещаются 
на панелях Более того, нередко панели помещаются друг на друга, так что получа- 
ется «многослойное» размещение компонентов на форме. 

Если вы перенесли компонент из библиотеки не на форму, а на панель, то эта 
панель становится для него родительской. Вы никакими передвижениями не смо- 
жете переместить его за пределы родительской панели. Если же вы передумали 
размещать компонент на данной панели и хотите переместить его на другую па- 
нель или непосредственно на форму, то это можно сделать через буфер обмена 
Clipboard. Выделите курсором переносимый компонент и вырежьте его в Clipboard 
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командой Edit | Cut или «горячими» клавишами С!-Х. Затем щелкните на форме 
или на той панели, куда хотите перенести компонент, и выполните команду Edit | 
Paste, дублируемую «горячими» клавишами Сн|-У. Компонент перенесется из 
Clipboard на новое место и обретет нового родителя — панель или форму. 

Если вы в процессе проектирования перемещаете панель, она может накрыть 
какие-то компоненты, размещенные на форме или на другой панели. Будут ли при 
этом накрытые компоненты видны или не видны, определяется их местом в опи- 
санной ранее 7-последовательности. Неоконные компоненты типа меток заведомо 
будут невидимы, поскольку они располагаются в 7-последовательности всегда 
ниже любых оконных, к которым принадлежат панели. А вот видимостью других 
оконных компонентов — панелей, кнопок, окон редактирования можно управ- 
лять. Это делается командами меню Edit | Bring To Front и Edit | Send To Back. Первая из 
них ‘перемещает выделенный оконный компонент на верх Й-последовательности и 
он начинает загораживать все другие оконные компоненты. А вторая команда пе- 
ремещает выделенный оконный компонент на самый низ 7/-последовательности и 
любые другие оконные компоненты, расположенные в 7-последовательности 
выше, начинают перекрывать его. Эти команды можно выполнить и проще: щелк- 
нув правой кнопкой мыши и выбрав их из всплывающего меню. 

Чтобы почувствовать все это, проведите эксперимент. Поместите на форму три 
панели: две из них непосредственно на форме, а третью — на одной из предыду- 
щих. Разместите на форме и на панелях различные метки, кнопки и окна редакти- 
рования. Перемещайте компоненты по панелям, а сами панели — по форме, вы- 
полняйте команды Bring То Front и Send To Back и наблюдайте при этом видимость 
различных компонентов. 


2.5.2.4 Поиск «пропавших» компонентов 


Иногда бывает, что вы не можете найти на форме компонент, который, как вы 
знаете, на ней присутствует. Это бывает по нескольким причинам. Например, если 
вы используете метку типа TLabel, установив в ней свойство AutoSize (автомати- 
ческое изменение размера по размерам надписи) в true и стерев значение надписи 
Caption, то горизонтальный размер метки уменьшается до нуля и ее не будет вид- 
но на форме, пока во время выполнения приложения значение Caption He изме- 
нится. Компонент может «пропасть» также, если он накрыт другим компонентом, 
расположенным выше в 7-последовательности. Возможны и некоторые другие 
причины, например, такой выбор цветов, что компонент сливается с фоном. 

Найти «пропавший» компонент можно, выбрав его имя в выпадающем спи- 
ске, расположенном вверху окна Инспектора Объектов. Этот список содержит все 
компоненты, размещенные на форме. Если вы выберете в нем нужный компонент, 
то на форме вокруг него появится рамка с маркерами, видимая даже в случае, если 
компонент накрыт сверху какой-нибудь панелью или другим компонентом. При 
этом в Инспекторе Объектов станут видны страницы свойств и событий найденно- 
го компонента. 

Если цель поиска заключалась в том, чтобы задать для компонента значения 
каких-то свойств или обработчики событий, то больше вам ничего и не надо. Если 
же вам все-таки надо добраться до компонента, накрытого другим компонентом 
или панелью, то придется или временно сдвигать куда-то эти помехи, или выпол- 
нить для них команду Send То Back, которая сдвинет их в низ й-последовательно- 
сти. По крайней мере, вы знаете, где расположен «беглец» и что надо сдвинуть, 
чтобы его найти. | 

Особо надо остановиться на вопросе, как, ничего не сдвигая, добраться до 
нижних панелей, если на них лежат другие панели, или как добраться до формы, 
если вся она накрыта панелями. Здесь возможен тот же подход, о котором говори- 
лось выше. Но можно поступить проще. Выделите верхнюю панель и нажмите 
клавишу Esc. В окне Инспектора Объектов откроются страницы, связанные с ни- 
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жележащей панелью. Нажмите Esc еще раз и откроются страницы следующего 
слоя и т.д. до тех пор, пока не откроются страницы формы. Конечно, если у вас 
есть только один слой панели, то страницы формы откроются при первом же нажа- 
тии Esc. 


2.5.2:5 Работа с группой компонентов, пуравмивания компонентов 
по размеру и положению 


На форме можно выделить группу компонентов, к которым применяется та 
или иная операция. Выделение группы возможно двумя способами. Если компо- 
ненты расположены непосредственно на форме и рядом друг с другом, то для выде- 
ления группы достаточно обвести курсором рамку вокруг них, и все они окажутся 
выделенными (рис. 2.21). Если компоненты группы расположены не непосредст- 
венно на форме, а, например, на панели, то выделить их рамкой невозможно. Так 
же невозможно выделить рамкой группу компонентов, расположенных в разных 
местах формы. В этих случаях выделение производится иначе. Выделяйте нужные | 
компоненты курсором, нажав и не отпуская при этом клавишу Shift. Bee компонен- 
ты, выделенные таким образом, войдут в группу. 


Рис. 2.21 ; 


Выделенная группа компонентов 


С выделенной группой компонентов можно производить следующие операции: 


Ш Перемещать их одновременно, потянув курсором за один из выделенных ком- 
понентов. Это очень удобно, когда надо переместить группу компонентов на 
форме, не изменяя их взаимного расположения. 


Ш Задавать в Инспекторе Объектов общие для всей группы свойства. При выде- 
лении группы на странице свойств в Инспекторе Объектов будут видны только 
их общие свойства. А индивидуальные свойства, такие, например, как имя 
компонента Name или надпись Caption, исчезнут. Вы можете задать особенно- 
сти шрифта, оформления, цвет ит.п., которые будут присущи всем компонен- 
там выделенной группы. 


Ш. Задать общий для всех компонентов группы обработчик какого-то события. 
Как вы увидите в процессе дальнейшего изучения приемов проектирования 
приложений, такая потребность возникает достаточно часто. 


Ш Скопировать всю группу в буфер обмена Clipboard командой Edit | Copy или «ro- 
рячими» клавишами Ctrl-C. После этого вы можете, например, открыть ка- 
кую-то другую форму и перенести на нее группу из Clipboard командой Edit | 
Paste или «горячими» клавишами Ctrl-V. Это простой способ переносить фраг- 
менты с одной формы на другую. Этот же прием удобно применять для перено- 
са группы компонентов с одной панели на другую. 


Ш Выравнивать компоненты группы по размеру и взаимному расположению. 
Как это делается мы сейчас рассмотрим. 


Когда вы размещаете компоненты на форме, трудно бывает добиться аккурат- 
ного вида окна, симметричного расположения компонентов, а иногда возникают 
проблемы и с тем, чтобы добиться одинакового размера их по горизонтали и верти- 
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кали. В C++Builder существует удобный инструмент для решения этих задач. Речь 
идет о командах Edit | Align — выравнивание размещения, Edit | Size — выравнивание 
размеров и Edit | Scale — масштабирование. Те же команды проще выбирать не из 
меню Edit, a из контекстного меню, которое всплывает, если вы щелкните правой 
кнопкой мыши на одном из компонентов группы (именно на компоненте, так как 
если вы щелкнете в стороне, то выделение группы снимется). 

При выполнении команды Size — выравнивание размеров, вам открывается 
окно, представленное на рис. 2.22. Левая часть окна — Width устанавливает шири- 
ну компонентов. Вы можете выбрать варианты: No change — не изменять, Shrink to 
smallest — уменьшить до размера минимального из компонентов группы, Grow to 
largest — увеличить до размера максимального из компонентов группы, Width — за- 
дать в окне рядом с этой радиокнопкой ширину компонента в пикселях. Аналогич- 
ные варианты предлагаются в правой части окна для Height — высоты компонентов. 


Рис. 2.22 


Окно выравнивания размеров группы компонентов 
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Например, на рис. 2.21 были изображены окна редактирования разных разме- 
ров. Если желательно все окна сделать одинаковыми, надо выделить их в группу, 
выполнить команду выравнивания размеров и для обоих измерений — ширины и 
высоты, указать, например, вариант Shrink to smallest. 

При выполнении команды Align — выравнивание размещения, вам открывает- 
ся окно, представленное на рис. 2.23. Левая часть окна — Horizontal устанавливает 
выравнивание компонентов по горизонтали. Вы можете выбрать варианты: Мо 
change — не изменять, Left sides — выровнять компоненты по их левым сторонам 
(т.е. левые стороны компонентов будут расположены друг под другом), Center — 
выровнять компоненты по их центрам, Right sides — выровнять компоненты по их 
правым сторонам, Space equally — разместить с равными интервалами между KOM- 
понентами, Center т window — расположить в центре окна. 


Рис. 2.23 
Окно выравнивания размещения группы 
компонентов 
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Правая часть окна — Vertical устанавливает выравнивание компонентов по Bep- 
тикали. Тут имеются аналогичные варианты. Вы можете выбрать: No change — не 
изменять, Гор$ — выровнять компоненты по их верхним сторонам, Center — выров- 
нять компоненты по их центрам, Bottoms — выровнять компоненты по их нижним 
сторонам, Space equally — разместить с равными интервалами по вертикали между 
компонентами, Center in window — расположить в центре окна. 
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Необходимо сделать некоторые уточнения по различным режимам выравнивания. 

При выравнивании по границам компонентов (Left sides, Right sides, Tops, 
Bottoms, Center) Ha месте остается самый левый (выравнивание по горизонтали) или 
самый нижний (выравнивание по вертикали) компонент, а местоположение ос- 
тальных подгоняется под него. 

В режиме Space’ equally крайние компоненты (левый и правый при выравнива- 
нии по горизонтали и верхний и нижний при выравнивании по вертикали) не пе- 
ремещаются. Получающиеся интервалы определяются положением этих крайних 
компонентов и числом промежуточных. Так что, пользуясь этим режимом, размес- 
тите сначала крайние компоненты так, как вам нужно, а уж затем используйте 
выравнивание. Выравниваются расстояния между верхними (при выравнивании 
по вертикали) или левыми (при выравнивании по горизонтали) границами компо- 
нентов. Поэтому, если выравниваемые компоненты имеют разные разметы, то рас- 
стояния между их примыкающими друг к другу краями будут не одинаковы. Ком- 
поненты могут даже наложиться друг на друга. Так что выравнивание по равным 
расстояниям имеет смысл только для компонентов равных размеров. 

Режим Center in window не означает, что каждый компонент расположится в го- 
ризонтальном или вертикальном направлении в центре окна. В центре окна распо- 
ложится только центр выделенной группы, а относительные сдвиги компонентов 
сохранятся неизменными. Кроме того учтите, что речь в данном случае идет не об 
окне формы, а о родительском окне компонентов группы. Если компоненты распо- 
ложены, например, на панели, то подразумевается центр этой панели. 

Посмотрим, как это все можно применить к примеру формы, показанной ра- 
нее на рис. 2.21. Пусть мы хотим, чтобы все компоненты — и окна редактирования 
и метка разместились по горизонтали в центре экрана, причем чтобы вертикаль- 
ные расстояния между окнами редактирования были одинаковыми. И пусть мы 
уже выполнили описанное ранее выравнивание размеров окон редактирования. 

Если выделить в группу все окна редактирования и задать по горизонтали вы- 
равнивание Center in window, а по вертикали — Space equally, то по вертикали окна 
действительно расположатся на равных расстояниях друг от друга, а ожидаемого 
выравнивания по горизонтали не будет. Вся группа окон сдвинется так, что ее 
центр будет совпадать с центром формы, но взаимные сдвиги окон останутся. По- 
этому правильнее выравнивание проводить в несколько приемов. Сначала по гори- 
зонтали задается Left sides, или Center, или Right sides — поскольку окна одинаковы, 
то все эти варианты эквивалентны. По вертикали при этом задается Space equally. В 
результате окна выстраиваются друг под другом с равными интервалами по верти- 
кали. После этого надо повторно выделить эту группу окон и задать выравнивание 
по горизонтали Center in window, а по вертикали — No change. В заключение можно 
выделить одну метку и задать для нее аналогичное выравнивание: Center м window 
по горизонтали и Мо change по вертикали. В результате вы получите безупречное 
размещение, показанное на рис. 2.24. 

Как видите, выравнивание компонентов часто требует многократного выпол- 
нения выравнивания в различных режимах. Даже с помощью команд всплываю- 
щего меню это делать неудобно. В C++Builder имеется гораздо более удобный инст- 


Рис. 2.24 
Окно, приведенное ранее на рис. 2.21, после выравнивания 
компонентов 
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румент выравнивания. Выполните команду View | Alignment Palette — палитра вы- 
равнивания. Появится окно палитры выравнивания, показанное на рис. 2.25. На- 
значение ее кнопок понятно из их пиктограмм. Верхний ряд кнопок относится к 
выравниванию по горизонтали и соответствует обсужденным выше вариантам вы- 
равнивания. Нижний ряд кнопок позволяет выравнивать по вертикали. Испытай- 
те этот инструмент на каком-нибудь тестовом примере, и вы убедитесь в его эффек- 
тивности. Чтобы полностью освоиться с выравниванием, добавьте на форму пане- 
ли, разместите на них различные компоненты и попробуйте выровнять и сами па- 
нели и компоненты на них. 


Рис. 2.25 


Палитра выравнивания 


Команда Edit | Scale позволяет пропорционально изменить масштаб всего распо- 
ложенного на форме. Все размеры можно увеличивать или уменьшать вплоть до 
ста раз. В появляющемся диалоговом окне вам надо задать Scaling factor — мас- 
штабирующий коэффициент в %. Задав, например, 200, вы увеличите все компо- 
ненты в 2 раза. | 


2.5.2.6 Фиксация компонентов 


После того, как вы тщательно разместили и выровняли компоненты, их место- 
положение полезно зафиксировать. Иначе в процессе последующей работы над 
проектом вы можете случайно сдвинуть тот или иной компонент, когда будете его 
выделять курсором, и всю работу по выравниванию придется начинать заново. 

Чтобы этого не произошло, выполните команду Edit | Lock Controls. Она зафикси- 
рует расположение всех компонентов на форме и не позволит их перемещать. Если 
в дальнейшем у вас все-таки возникнет потребность изменить расположение ком- 
понентов, то выполните повторно команду Edit | Lock Controls и компоненты будут 
разблокированы. 


2.5.3 Инструментальные средства поддержки разработки кода 


2.5.3.1 Применение Code Insight — Знатока Кода 


Этот инструмент встроен в окно Редактора Кода и может оказать большую по- 
мощь при написании кода и его отладке. Он во многих случаях подскажет вам 
имена свойств, методов, событий, типы аргументов, типовые синтаксические кон- 
струкции и многое другое. Code Insight может работать в двух режимах: автомати- 
ческом и не автоматическом. В разделе 14.2.6 главы 14 вы можете посмотреть, как 
настроить Code Insight на автоматическую работу. Однако, автоматически возни- 
кающие подсказки очень полезны для начинающих, но могут раздражать более 
опытных пользователей. Поэтому имеется возможность отключить автоматиче- 
ский режим (он включен по умолчанию — см. раздел 14.2.6) и вызывать Code 
Insight по мере надобности, нажимая клавиши Ctrl-Shift-npo6ben или Ctrl-npo6en в зави- 
симости от того, к каким возможностям Code Insight вы хотите обратиться. ` 

Code Insigh! может выполнять следующие функции. 


Завершение кода 

Если вы написали в своем приложении имя компонента, поставили после него 
символы стрелки (->) и немного задержались с вводом последующего текста, то 
появится окно, содержащее список всех свойств, методов и событий класса, к ко- 
торому принадлежит данный компонент. Вы можете выбрать из него требуемое 
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или начать писать первые символы свойства или метода, а затем нажать Enter, ив 
ваш код вставится соответствующее имя. Так будет при автоматической работе 
Code Insight. Если автоматический режим отключен, то вы можете вызвать ту же 
подсказку, если, поставив символы стрелки после имени компонента, нажмете 
Ctrl-npo6en. 

Если вы написали символ операции присваивания «=» и нажали Сн|-пробел, то 
вам будет показан список возможных аргументов, совместимых по типу с перемен- 
ной, которой будет присваиваться значение. Аналогичным образом можно полу- 
чить подсказку по аргументам функций или процедур. Правда, возникающие спи- 
ски подсказок в обоих этих случаях настолько длинные, что выбрать из него тре- 
буемое не так-то просто. 


Параметры функций, процедур, методов 

Если Code Insight работает в автоматическом режиме, то после того, как вы 
напишете имя функции или метода и поставите открывающуюся скобку, вы уви- 
дите список параметров и их типов. Причем, по мере того, как вы будете вводить 
значения аргументов, вам будет высвечиваться тип следующего параметра. Это, 
может быть, наиболее мощная возможность Code Insight, поскольку вряд ли кто-ни- 
будь способен помнить параметры всех функций и методов C++Builder. 

Если автоматическое высвечивание подсказок вы отключили, то можете вы- 
звать подсказку, нажав клавиши Shift-Ctrl-npo6en. 


Шаблоны кода 

В Code Insight занесено множество шаблонов стандартных структур языка 
С++. Причем вы сами можете добавлять или удалять эти шаблоны (см. раз- 
дел 14.2.6). Вызов шаблона производится нажатием клавиш Cirl-J. Из выпадающе- 
го списка вы можете выбрать нужный шаблон. Например, если вы выбрали шаб- 
лон управляющей структуры for, то в ваш код занесется текст: 

LOR, G2) 


{ 
} 


Вам остается только заполнить этот шаблон, занеся в его заголовок соответст- 
вующие выражения, и написать тело цикла. 


Оценка выражений 

Эта способность Code Insight очень полезна в процессе отладки и подробнее бу- 
дет рассмотрена позднее в разделе 2.6.3 при обсуждении способов отладки. Code 
Insight позволяет при останове или пошаговом выполнении приложения подвести 
курсор в окне Редактора Кода к имени любой переменной или к выражению и уви- 
деть текущее значение оцениваемой величины. 


Информация 06 идентификаторах — Code browser 

Если задано автоматическое выполнение этого режима Code Insight, то при пе- 
ремещении курсора мыши в тексте приложения над любой переменной автомати- 
чески высвечивается информация O ее объявлении, типе и о модуле и номере стро- 
ки, содержащей это объявление. Это помогает при разработке больших приложе- 
ний, но не очень удобно в простых задачах, так как на поиск этой информации 
Code Insight тратит заметное время. Так что можно рекомендовать обычно отклю- 
чать эту возможность и включать ее только в случае необходимости. 

Возможности Code browser существенно возрастают, если вы нажмете и не бу- 
дете отпускать клавишу СШ. Тогда при перемещении курсора мыши над любым 
идентификаторами кода идентификатор выделяется цветом и подчеркиванием, а 
курсор приобретает вид руки. Если вы щелкнете на выделенном идентификаторе, 
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перед вами в окне Редактора Кода откроется файл, содержащий объявление соот- 
ветствующего класса, свойства, метода, переменной и курсор перейдет к строке это- 
го объявления. Такая возможность увидеть объявление любого идентификатора 
очень помогает во многих случаях разработки кода. Причем эта возможность не за- 
висит от того, включено или выключено автоматическое выполнение Code browser. | 

Поиск информации об идентификаторах Code browser проводит в каталогах, 
устанавливаемых при настройке C++Builder при выполнении команд Project | 
Options (на странице Directories/Conditionals) и Tools | Environment Options (на страни- 
це Library). 

Code browser не может находить информацию 06 идентификаторах, объявлен- 
ных в новых, еще не сохраненных модулях. 


2.5.3.2 Исследователь Классов ClassExplorer 


Исследователь Классов ClassExplorer показывает дерево всех типов, классов, 
свойств, методов, глобальных переменных и глобальных функций, содержащихся 
в модуле, открытом в Редакторе Кода. 

По умолчанию окно Исследователя Классов (см. рис. 2.26) появляется автома- 
тически встроенным в окно Редактора Кода (см. рис. 2.4 6). Правда, это поведение 
по умолчанию может быть изменено отключением опции Automatically show Explorer 
на странице ClassExplorer при выполнении команды Tools | Environment Options. B 
этом случае при необходимости вы можете вызвать Исследователя Кода командой 
View | ClassExplorer. Как указывалось в разделе 2.2.8, окно очень удобно встраивать 
на отдельную страницу в окне Инспектора Объеклов. 


Рис. 2.26 |СаззЕ xplorer | 
Окно Исследователя Классов ClassExplorer = =] Project! - Classes 
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В окне Исследователя Классов вы можете видеть структуру своего проекта, 
модулей и классов. На рис. 2.26 приведен пример, в котором встречается большин- 
ство используемых при этом значков: проекта (Projectl), формы (ТЕогш\1, 
TForm2), опубликованного (published) свойства (A), опубликованных и открытых 
(public) данных (объектов — ВиЙоп1, Labell, переменных — P), открытых мето- 
дов (Е), закрытых (private) данных (FA) и методов ($е А), защищенных 
(protected) методов (FProtect), конструкторов (TForm1). В Исследователе Классов 
даны также сведения и функциях, объявленных вне класса (Displ). Правда, учти- 
те, что сведения даются только о тех функциях, для которых в заголовочном моду- 
ле или в модуле реализации имеется прототип. Функции, просто описанные в фай- 
ле реализации, в Исследователе Классов не отображаются. 

Если вы щелкнете в окне Исследователя Классов на имени переменной или 
функции, то курсор в окне Редактора Кода перейдет на строку, в которой эта пере- 
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менная или функция объявлена. То же самое можно сделать, щелкнув правой 
кнопкой мыши на соответствующем узле дерева в окне Исследователя Классов и 
выбрав из контекстного меню раздел Go to Declaration. Если этот узел относится к 
методу или функции, то в контекстном меню доступен еще один раздел — Go to 
Implementation (переход курсора на реализацию функции). 

В контекстном меню Исследователя Классов имеется также раздел Class 
Hierarchy. Выбор этого раздела открывает отдельное окно иерархии классов, содер- 
жащее практически ту же информацию, что и окно ClassExplorer (за исключением 
функций), но, пожалуй, в более удобном виде. 

До C++Builder 5 возможности Исследователя Классов ограничивались изло- 
женным выше. И, честно говоря, я практически никогда этот инструмент в своей 
работе не использовал. Ho в C++Builder 5 функции Исследователя Классов резко 
расширились и он стал прекрасным инструментом для внесения в классы новых 
методов и свойств. Пока, вероятно, рано говорить об этих тонкостях. Использова- 
ние новых возможностей Исследователя Классов подробно рассмотрено в главе 7 
при описании методики создания собственных компонентов и в главе 6 в разделе 
6.3.3. 


2.5.3.3 Поддержка разработки, встроенная в окно Редактора Кода 


Прежде всего, конечно, надо сказать о контекстной справке, позволяющей по- 
лучать из окна Редактора Кода информацию о классах, свойствах, методах и функ- 
циях. Если вы установите курсор на имени какого-то свойства, метода, функции 
(речь идет не о введенных вами в модуле, а о системных элементах) и нажмете Fl, 
то вам будет предложена справка по интересующему вас вопросу. Правда, иногда 
при этом происходят сбои и высвечивается не та справка, но в разделе 2.5.3.4 ска- 
зано, как поступать в подобных случаях. 

Теперь о других возможностях получить помощь. Выше были рассмотрены 
способы работы с различными инструментальными средствами, помогающими в 
написании кода. Многие возможности вызова тех или иных функций этих инстру- 
ментальных средств заложены в контекстном меню окна Редактора Кода, вызы- 
ваемом щелчком правой кнопки мыши (рис. 2.27). 


Контекстное меню Редактора Кода с выпадающим меню _ реп Souce/Header Ре CuleFE 
и ES 


установки закладок 


— Add To-Do Item... Pe Pes 


Если в момент щелчка курсор расположен на имени компонента, свойства, Me- 
тода, константы, переменной, функции и т.д., то в контекстном меню появляется 
раздел Find Declaration — найти объявление. Выбрав этот раздел, вы можете увидеть 
объявление данного элемента кода. Если этот объект (переменная, функция ит.п.) 
определен в вашем модуле, то курсор просто переместится в строку, содержащую 
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объявление. Если же объект определен в каком-то другом, в частности, в систем- 
ном модуле, то в окно Редактора Кода будет загружен соответствующий модуль и 
уже в нем курсор расположится на строке, содержащей объявление. После того, 
как вы получили требуемую информацию, вы можете выгрузить посторонний мо- 
дуль из окна Редактора Кода командой контекстного меню Close Page. 

Если вы поместите курсор на имени заголовочного файла, подключаемого к 
проекту директивой #ще4е, щелкнете правой кнопкой мыши и BO всплывающем 
меню выберете раздел Open File at Cursor, то в окно Редактора Кода будет загружен 
соответствующий файл и вы сможете посмотреть объявления различных содержа- 
щихся в нем функций, констант, макросов и т.п. 

Теперь рассмотрим возможности навигации в коде и использование закладок. 
Вы можете пометить закладками какие-то операторы в разных частях кода и затем 
быстро перемещаться между этими частями. Чтобы сделать закладку, надо устано- 
вить курсор в нужной строке, щелкнуть правой кнопкой мыши и выполнить ко- 
манду Toggle Bookmarks. Откроется список возможных закладок, как показано на 
рис. 5.15. В нем вы можете пометить закладку, которую хотите привязать к дан- 
ной строке, щелкнув на ней левой кнопкой мыши. Если вы хотите удалить ка- 
кую-то ранее введенную закладку, щелкните на ней правой кнопкой мыши. 

Когда вам потребуется в дальнейшем в процессе работы над приложением вер- 
нуться к введенной закладке, вы аналогичным образом можете выполнить коман- 
ду Goto Bookmarks и в аналогичном списке закладок выбрать нужную. 

Если вам нужны закладки, чтобы параллельно наблюдать два различных 
фрагмента кода, например, чтобы перенести или скопировать какие-то операторы 
из одного фрагмента в другой, то удобно открыть второе окно редактирования. Это 
можно сделать командой контекстного меню New Edit Window. Тогда вы можете в 
одном окне перейти к одной из закладок, в другом — к другой и затем одновремен- 
но работать с обоими фрагментами кода. 


2.5.3.4 Справочная система C++Builder и программа ee 
конфигурирования OpenHelp 


Справка в C++Builder может вызываться из меню Help. Это меню имеет, в ча- 
стности, разделы: 


ОВО ЕСН ЕО ОА НЕО НО Е ОЕ IG! LEER EA LEER LEE SERED ESEBECEE SEL LORE ИАА, 


C++Builder Help вызов справки по C++Builder и C++ 
C++Builder Tools вызов справок по инструментарию C++Builder 5 
Windows API/SDK Help вызов справок по Windows 


Помимо этого в меню включен ряд разделов получения информации через Ин- 
тернет. 

Справку можно получить не только из меню Нер, но и с помощью контекст- 
но-зависимого поиска практически из любого окна C++Builder. Вы можете выде- 
лить на форме какой-то компонент, нажать Г] и вам будет показана тема справки, 
связанная с этим компонентом. Если вы, находясь в окне Редактора Кода, устано- 
вите курсор на имени какой-то функции, свойства или метода какого-то компонен- 
та и нажмете Fl, то вам также будет показана справка по интересующему вас BO- 
просу. Аналогично можно получить контекстную справку о свойстве компонента 
из окна Инспектора Объектов, выделив соответствующее свойство. 

Правда, к сожалению, изредка такой контекстный поиск не дает правильный ре- 
зультат. Иногда вы в ответ получаете сообщение, что такой темы нет, и совет обратить- 
ся к разработчикам программы. A иногда просто вы попадаете совсем He на ту тему. 

В подобных случаях можно посоветовать выходить на требуемую тему через 
страницу справки Содержание. Если вам требуется информация о компоненте, 
свойстве, методе, событии, то наиболее удобно раскрыть на этой странице книжку 
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«Visual Component Library Reference» (Обзор библиотеки визуальных компонен- 
тов), затем раскрыть «Alphabetical Object and Component Listing» (Алфавитный 
список объектов и компонентов) и в этом списке отыскать по алфавиту требуемый 
компонент. А из окна справки компонента всегда можно найти все его свойства, 
методы и события. 

Если вам нужно найти справку по функциям, объявленным в библиотеке ком- 
понентов, и обычный контекстный поиск не помогает, то удобно на странице 
справки Содержание открыть книжку «Visual Component Library Reference» (Об- 
зор библиотеки визуальных компонентов), затем раскрыть «Alphabetical Routines 
Listing» (Алфавитный список функций) или «Categorical Routines Listing» (Спи- 
сок функций по категориям), а затем найти нужную функцию в соответствующем 
разделе. 

Если вам нужно найти справку по функциям С, то удобно на странице справки 
Содержание открыть книжку «С Runtime Library Reference» (Обзор библиотеки 
С), затем раскрыть «Categorical Routines and Types Listing» (Список функций и ти- 
пов по категориям) или « Alphabetical Routines and Types Listing» (Список функций 
и типов по алфавиту), а затем найти нужную функцию в соответствующем разделе. 

Для получения справки по API Windows, по сообщениям Windows и т.п. полезно 
открыть в окне справки один из файлов ...\program files\Common Files\Borland\Borland 
Shared\MShelp\95guide.hlp или ...\program files\Common Files\Borland Shared\MShelp\ma- 
pi.hlp. Можно также воспользоваться разделом Windows API/SDK Help меню Help. 

А теперь рассмотрим очень интересный инструмент, позволяющий проводить 
настройку справочной системы. Речь идет о программе Borland OpenHelp, вызы- 
ваемой командой Help | Customize. Окно этой программы показано на рис. 2.28. 
OpenHelp предоставляет вам простой путь конфигурирования файлов справки 
-hip. При этом можно добавлять и убирать файлы справки, которые будут появ- 
ляться в таблице содержания и в предметном указателе справки. В частности, 
можно встроить в систему собственные справочные файлы на русском языке. На- 
пример мы с группой соавторов создали русскую справку по C++Builder 5 и C++ 
(на рис. 2.28 изображен момент встраивания ее в C++Builder), которую я сам с‘удо- 
вольствием использую в своей работе. Ее эскизная версия содержится на диске, 
прилагаемом к данной книге. Полноценная версия справки, как я надеюсь, будет 
выпущена в серии книг «Все о C++Builder» и вы сами сможете убедиться, что 
встраивание собственных справок в C++Builder очень удобно. 

OpenHelp хранит информацию о справочной системе в проекте. Файл этого 
проекта имеет расширение .ohp и хранится в каталоге /Нер. Вы можете изменить 


Рис. 2.28 
Окно OpenHelp с открытой страницей Contents 


РААВНАЗРВАСВИЕО 


1@ What's New in Borland C++Builder 
@ Borland C++Builder Help 
|| © Programming with C++Builder 

| @ Developing Database Applications 


| @ Developing Internet Applications 
| @ Component Writer's Guide 
1@ Developing СОМ -Базед applications 


@ C++Builder Language Guide 


: < С Runtime Library Reference 
< Standard C++ Library Help 

‚| Ф C++Builder Command-line Tools 
? @ Visual Component Library Reference... 
| © CodeGuard User's Guide 

1@ Integrated Translation Environment ... 
: @ InterBase Express Reference 


d:\Program Files\Borlan. 
dt \Program Files\Borlan. 
d:\Program Files\Borlan: 
d:\Program Files\Borlan 
d:\Program Files\Borlan 
d:\Program Files\Borlan 
d:\Program Files\Borlan 
c:\Program Files\Borlani 
d:\Progtam Files\Borlan 
d:\Program Files\Borlan 
d:\Progiam Files\Borlan 
d:\Program Files\Borlan 
d:\Program Files\Borlan 
d:\Program Files\Borlan 
d:\Progiam Files\Borlan | 
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состав справочной системы: таблицы Содержание (Contents), таблицы Предметный 
Указатель и контекстной справки, доступ к которой осуществляется из ИСР 
C++Builder клавишей Fl. 

ОрепНер.позволяет также удалить ссылки системного реестра на устаревшие 
файлы справки. Дело в том, что нередко системный реестр и файл WINHELP.INI 
загромождаются ссылками на устаревшие файлы справок. Вы можете быстро очи- 
стить от них реестр, выполнив в окне OpenHelp команду File | Clean Registry. 

Ниже изложена методика модификации справочной системы. 

Таблица Содержание хранится в файле с расширением .toc, подобном файлам 
содержания Windows .cnt, только без предложений Include. Чтобы добавить фай- 
лы в таблицу Содержание, надо сделать следующее: 


. Перейти в окне OpenHelp на страницу Contents (см. рис. 2.28). 
. Выполнить команду Edit | Add Files. 


1 
2 
3. Выбрать или написать имена одного или более добавляемых файлов .toc или .cnt. 
4. ШЩелкнуть на ОК. 

5 


. Вы можете переместить файл на желательное вам место среди других файлов. 
Для этого выделите файл и переместите его, пользуясь кнопками со стрелками 
на странице Contents. 


6. Выполнить команду File | Save Project или File | Save Project As. 
Для удаления файла из таблицы Содержание надо: 

. Перейти в окне OpenHelp на страницу Contents. 

. Выделить удаляемые файлы. 

Выполнить команду Edit | Remove. 


me oO ND 


. Выполнить команду File | Save Project или File | Save Project As. 


Таблица Предметный Указатель хранит ссылки Ha файлы справок .Шр. Чтобы 
добавить файлы в таблицу Предметный Указатель или удалить файлы из нее надо 
произвести те же операции, которые были рассмотрены выше, но только работать 
на странице Index и добавлять или удалять файлы „р. 

Контекстно-зависимый поиск справки состоит из файлов .Шр, доступных с по- 
мощью так называемых макросов ALink. Эти макросы используются в C++Builder 
при нажатии клавиши Fl в Инспекторе Объектов, Редакторе Кодов, палитре ком- 
понентов. Чтобы добавить файлы в контекстно-зависимый поиск, надо произвести 
те же операции, которые описаны выше, но на странице Link. 


2.6 Отладка приложений 


2.6.1 Компиляция и компоновка проекта 


Мастерство программиста — разработчика приложения определяется вовсе не 
его умением писать безошибочные программы (написать сложную программу без 
ошибок не может никто). Мастерство определяется умением быстро, эффективно и 
надежно отлаживать и тестировать свое приложение. Вопросы тестирования очень 
важны, но они относятся к проблемам программирования и не связаны с темати- 
кой данной книги. А вот техническими возможностями отладки приложений в 
MCP C++Builder мы сейчас займемся, поскольку ими должен хорошо владеть каж- 
дый разработчик. 

Тем, кто пока слабо владеет программированием и не знает языка С++, изло- 
женный в разделе 2.6 материал сначала стоит просто просмотреть «по диагонали», 
чтобы уловить главное. А после более тесного знакомства с С++ я бы рекомендовал 
вернуться к этому материалу и познакомиться с ним более осмысленно. 
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Компиляция приложения может выполняться несколькими способами. Если 
вы работаете с группой проектов (см. раздел 2.4.3), то все, описанное далее, отно- 
сится к тому проекту, который в данный момент активен. 

Компиляция с последующим выполнением приложения осуществляется ко- 
мандой Кип | Run, или соответствующей быстрой кнопкой, или «горячей» клавишей 
Г9. В этом случае производится компиляция программы, ее компоновка, создается 
выполняемый модуль .ехе и он запускается на выполнение. Впрочем, создание мо- 
дуля .ехе и выполнение будет проводиться только в случае, если при компиляции 
и компоновки не обнаружены неисправимые ошибки. 

В процессе компиляции и компоновки на экране появляется окно, приведен- 
ное на рис. 2.29. В его верхней строке вы видите имя компилируемого проекта. В 
следующей строке отображается текущая операция: компиляция определенного 
модуля (на рис. 2.29 показан момент компиляции модуля Udebug3.cpp) или ком- 
поновка (Linking). В третьей строке окна отображается текущая строка модуля 
(Current line), обрабатываемая компилятором, и общее число строк в модуле (Total 
lines). В нижней строке отображается обнаруженное на данный момент число заме- 
чаний (Hints), предупреждений (Warnings) и ошибок (Errors). Клавиша Cancel внизу 
окна позволяет прервать процесс компиляции и компоновки. 

Если в компилируемом файле встретились неисправимые ошибки, выполняе- 
мый файл не будет создан. Если ошибок нет, файл создастся, но и в этом случае у 
компилятора могут быть предупреждения и замечания, которые вам надо внима- 
тельно изучить. Как это сделать — будет сказано позднее. 


Рис. 2.29 


Окно КОМПИЛЯЦИИ и КОМПОНОВКИ 


При компиляции проекта, состоящего из нескольких модулей, компилируют- 
ся только те модули, тексты которых были изменены с момента предыдущей ком- 
поновки проекта. Это существенно экономит время компиляции. 

При выполнении команды Кип вы можете задать командную строку, если ваше 
приложение предусматривает передачу в него каких-то параметров. Для этого 
надо сначала выполнить команду Run | Parameters и в открывшемся окне написать 
требуемую командную строку, 

Не всегда вам надо компилировать проект и тут же выполнять его. Часто вам 
важнее просто проверить, не содержат ли ваши последние изменения кода ка- 
ких-то ошибок. В этом случае вам не имеет смысла терять время на выполнение 
проекта и лучше воспользоваться другими командами меню: Project | Compile Unit, 
Project | Make Project или Project | Build Project. 

Команда Compile выполняет компиляцию только того модуля, который выде- 
лен вами в окне Редактора Кода или в Менеджере Проектов. Эта команда позволя- 
ет наиболее быстро проверить наличие ошибок или замечаний при компиляции 
модуля, так как не осуществляется компоновка программы и не компилируются 
никакие другие модули. Если компиляция прошла успешно, создается объектный 
файл .obj откомпилированного модуля. 

Команда МаКе выполняет компиляцию всех тех модулей, тексты которых 
были изменены с момента предыдущей компоновки проекта. Если компиляция 
прошла успешно, то создаются объектные файлы модулей .obj и осуществляется 
компоновка программы. Если и она прошла успешно, то создается выполняемый 
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модуль .exe. Таким образом, отличие Make от Кип только в том, что после компо- 
новки не производится выполнение приложения. 

Команда Build подобна команде Make за одним исключением — компилируют- 
ся все модули, независимо от того, когда они в последний раз изменялись. Конеч- 
но, выполнение этой команды требует наибольшего времени. Но иногда только ее 
и можно использовать. Например, если с момента последней компиляции вы ниче- 
го не изменяли в модулях, но хотите откомпилировать проект с новыми опциями 
компилятора, например, изменить уровень оптимизации. Тогда все иные коман- 
ды, кроме Build, не произведут повторной компиляции. Так что эта команда во мно- 
гих случаях необходима. 

Помимо описанных команд компиляции имеется еще две: Project | Make А! 
Projects и Project | Build All Projects. Они подобны рассмотренным командам Make и 
Build, Ho при работе с группой проектов (см. раздел 2.4.3) относятся He к одному, a 
ко всем проектам группы. 

По умолчанию все команды компиляции в C++Builder 5 выполняются в фоно- 
вом режиме. Эта новая возможность, введенная в C++Builder 5, позволяет осуще- 
ствлять во время компиляции и компоновки любые другие работы в ИСР. Это, ко- 
нечно, удобно, но не всегда. Дело в том, что фоновая компиляция осуществляется 
медленнее. Кроме того, по завершении компиляции в фоновом режиме окно ком- 
пилятора исчезает и при этом не показываются результаты компиляции: прошла 
ли она успешно, или имеются замечания. Поэтому, если у вас нет каких-то работ в 
ИСР, которые можно выполнять во время компиляции, лучше отключить фоно- 
вый режим компиляции. Это можно сделать, выполнив команду Tools | Environment 
Options и выключив на странице Preferences опцию Background Compilation (подробнее 
об опциях см. в разделе 14.2.10). 

Если фоновый режим компиляции отключен, то после окончания компиля- 
ции рассмотренными командами (кроме Run) в окне рис. 5.17 во второй строке по- 
является одно из трех итоговых сообщений: «Done: Make» — «Результат: выполне- 
HO», «Done: There are errors» — «Результат: имеются ошибки», «Done: There are 
warnings» — «Результат: имеются предупреждения». 


2.6.2 Сообщения компилятора и компоновщика 


В предыдущем разделе рассмотрены команды компиляции проекта. Теперь 
давайте посмотрим, какие сообщения об ошибках и какие предупреждения выдает 
компилятор и как на них надо реагировать. Давайте для этого сделаем простое 
приложение с ошибочными операторами. Начните новое приложение, перенесите 
на форму метку Label и кнопку Button. В обработчик щелчка кнопки введите сле- 
дующие операторы: 


void  fastcall TForml::ButtonlClick(TObject *Sender) 
{ . 


ИЕ: 2:97 

double А; 

for(i = 0; 1 < 50; i++) 

А *= 10000; // увеличение А в 10000 раз 
Labell->Caption = "A = " + В; | 


} 


Этот код содержит цикл for, который выполняется 50 раз, увеличивая в каж- 
дой итерации переменную А в 10000 раз. 

Попробуйте выполнить команду Run | Run, или нажать соответствующую быст- 
рую кнопку, или нажать клавишу Г9. Вы увидите в окне Редактора Кода картину, 
показанную на рис. 2.30. Впрочем, такую картину вы увидите, если в окне опций 
проекта, вызываемом командой Project | Options на странице Compiler в группе опций 
Warnings включена опция All. Это означает, что компилятор должен отображать все 
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свои замечания. Этот режим наиболее удобен для отладки. Поэтому если у вас со- 
общений меньше, чем показано на рис. 2.30, проверьте, включена ли у вас указан- 
ная опция. Подробнее об опциях компиляции вы можете узнать, ознакомившись с 
разделом 14.2.9. 


Рис. 2.30 
Окно Редактора Кода с 


сообщениями о замечаниях и a — fasteall T TForm1: Нее *Sender) & = 
ошибках 
int .i1,;.33 
; double д; 
for(i = О; i < 50; i++) 
А *= 10000; // увеличение А в 10000 раз 
Labeli->Caption = "2 = * + В; 


[С++ Warning] Udebug!. 24 \\/8080 ‘| is declared but never used 
sate Warning] рен ть вещи у ‘Sender’ is never инс 


а нове ее инки ан nea норе HI «уу DIE HADDIN AN ARTE 


Внизу окна видны сообщения о замечаниях и ошибках. Прежде, чем рассмат- 
ривать их, отметим, что они размещены во встраиваемом окне сообщений. Как 
всякое встраиваемое окно, вы можете вынуть его из окна Редактора Кода и сделать 
самостоятельным или встроить, например, в окно Инспектора Объектов. Впрочем, 
это окно достаточно удобно сохранить именно встроенным в Редактор Кода. Места 
оно занимает немного. Вы можете также увеличить или уменьшить его размер до 
желаемого. Если вы вынули окно сообщений из окна Редактора Кода, а при даль- 
нейших манипуляциях с окнами «потеряли» (не видите, поскольку оно загороже- 
но другими окнами), или если вы закрыли это окно его системной кнопкой с кре- 
стиком, то вы может щелкнуть в окне Редактора Кода правой кнопкой мыши и вы- 
брать в контекстном меню команду Message View. 

‚Теперь рассмотрим полученные сообщения компилятора. Первое сообщение: 
[С++ Warning] Udebugl.cpp(22): W8013 Possible use of 'А' before defini- 
tion 
([С++ Предупреждение] модуль Udebugl.cpp, строка 22: W8013 Переменная 
'А', возможно, используется до того, как ей присвоено значение) 


Это предупреждение о том, что вы не инициализировали переменную А и ее 
значение к моменту первого выполнения оператора в строке 22 не определено. Что- 
бы узнать, что это за строка, достаточно сделать мышью двойной щелчок на этом 
предупреждении. Тогда в окне Редактора Кода выделится соответствующая строка 
текста. В данном случае вы увидите, что речь идет об операторе 


А *= 10000; // увеличение А в 10000 раз 

Действительно, мы ввели локальную переменную А и нигде не задали ее на- 
чальное значение. С точки зрения компилятора это не ошибка, а Warning — заме- 
чание. Но для программы это действительно логическая ошибка, так как неизвест- 
но, чему будет равно значение этой переменной при входе в цикл. Если мы хотим, 


например, чтобы при каждом выполнении функции значение А равнялось 1, мы 
должны изменить объявление переменной: 


double А = 1; 
или добавить перед циклом оператор: 
А = 1; 
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Если же мы хотим, чтобы в переменной А накапливался результат при каж- 
дом щелчке на кнопке, мы должны убрать ее объявление из функции и сделать пе- 
ременную А глобальной, инициализировав ее в объявлении приведенным ранее 
оператором. 

Этот пример показывает, что не надо пренебрегать замечаниями компилятора. 
Всегда лучше перед запуском на выполнение сначала только откомпилировать 
проект и тщательно проанализировать каждое замечание. Только исправив все, 
что требует исправления, имеет смысл выполнять приложение. Это сэкономит вам 
время, которое в противном случае вы потратите на поиск причин, по которым 
ваша программа работает неправильно. 


Хорош ий стиль программирования ооо нони 


Просматривайте все замечания компилятора и стремитесь найти и устранить причины, вы- 
звавшие эти замечания. Игнорируя их, вы рискует снизить надежность и эффективность свое- 
го приложения. 


имя очки аще В О ааа 


К сожалению, предупреждение об отсутствии инициализации компилятор 
дает только для локальных переменных. Если вы забыли инициализировать гло- 
бальную переменную, компилятор этого не заметит и вы получите в программе ло- 
гическую ошибку, которую придется отлавливать в процессе отладки. Бойтесь та- 
ких ошибок. Поскольку значение неинициализированной переменной неопреде- 
ленно, то ваша программа при разных запусках и на разных компьютерах может 
выдавать разные результаты. 

Вернемся теперь к рис. 2.30. Второе сообщение компилятора: 

[C++ Error] Udebugl.cpp(23): E2451 Undefined symbol 'В'. 


([С++ Ошибка] модуль Udebugl.cpp, строка 23: E2451 Необъявленный 
идентификатор 'B') 


Это уже сообщение об ошибке. В данном случае в операторе 
Labell->Caption = "A =" + В; 


вместо переменной А мы указали переменную В, которая не была объявлена. Стро- 
ка кода с этой ошибкой выделена в окне Редактора Кода и курсор остановился око- 
ло необъявленного идентификатора. Ошибки такого рода будут у вас чаще всего — 
это результат описки в имени переменной, компонента, свойства, метода, функции. 
Поскольку рассмотренная выше ошибка неисправима, то в данном примере 
выполняемый модуль не формируется и приложение не выполняется. 
Третье сообщение компилятора: 


[С++ Warning] Udebugl.cpp(24): №8080 'j' is declared but never used. 
([С++ Предупреждение] модуль Udebugl.cpp, строка 24: W8080 Переменная 
']' объявлена, но нигде не используется) 


Действительно, мы объявили переменную j, но не использовали ее. Если эта 
переменная — заготовка для каких-то будущих процедур, то это замечание можно 
проигнорировать. Но если переменная j действительно не нужна, то ее объявление 
лучше удалить из текста, так как под эту переменную тратится, конечно, неболь- 
шой, но совершенно бессмысленный объем памяти. 

Последнее сообщение компилятора: 

[С++ Магп1па] Udebugl.cpp(24): №8057 Parameter 'Sender' is never used 


([С++ Предупреждение] модуль Udebugl.cpp, строка 24: W8057 Параметр 
'бепаег' нигде не используется) 


В обработчик событий действительно передается параметр Sender, как вы MO- 
жете видеть в заголовке процедуры. Этот параметр — компонент, в котором про- 
изошло событие. Нам он не нужен в данном обработчике, так что это предупрежде- 
ние можно проигнорировать. 
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Итак, наш пример не откомпилировался из-за ошибки с использованием не- 
объявленной переменной В. 

Если вы исправите в ошибочном операторе переменную В на А, то, увы, полу- 
чите новое сообщение об ошибке: 


[C++ Error] Udebugl.cpp(23): E2060 Illegal use of floating point. 
([С++ Ошибка] модуль Udebugl.cpp, строка 23: E2060 Недопустимое 
использование плавающей точки) 


Действительно, в правой части оператора 

Labell->Caption = "А = "+А; 
складывается строка «А = » и переменная с плавающей точкой А. Подобные ошиб- 
ки использования несовместимых типов тоже очень распространены и вы, вероят- 


но, не раз невольно будете их делать. 
Правильный оператор в нашем примере должен иметь вид: 


Labell->Caption = "А = " + FloatToStr (А); 
Итак, после всех исправлений ваш код может иметь вид: 


double. А. = 1; 
void _fastcall TForml::Button1Click(TObject *Sender) 
{ 


ща № 

for(i = 0; + <° 50$ i++) 

А *= 10000; // увеличение А в 10000 раз 
Labell->Caption = "А = " + FloatToStr (А); 


} 
Теперь откомпилируйте ваше приложение и выполните его. 


2.6.3 Что делать, если произошла ошибка выполнения 


Если ваше приложение откомпилировалось и стало выполняться, это, увы, 
еще не означает, что оно правильно работает. В нем может быть еще множество 
ошибок времени выполнения. Это могут быть постоянные логические ошибки, 
проявляющиеся всегда при выполнении некоторых частей вашей программы. Это 
могут быть ошибки, проявляющиеся только при каких-то сочетаниях данных: 
ошибки деления на нуль, переполнения, открытия несуществующего файла и т.п. 
Наконец, могут быть случайные перемежающиеся ошибки, когда одна и`та же за- 
дача иногда выполняется нормально, а иногда — нет. Такие ошибки, которые наи- 
более трудно вылавливать, связаны обычно с отсутствием инициализации пере- 
менных в каких-то режимах работы. В этом случае выполнение приложения зави- 
сит от случайного состояния памяти компьютера. 

Во всех подобных случаях причины ошибок выявляются в процессе отладки. 
Наше приложение тоже не свободно от ошибок времени выполнения. Запустите 
его на выполнение и щелкните на кнопке. Все вроде бы сработает нормально. Но 
попробуйте повторно щелкнуть на той же кнопке. Выполнение прервется и перед 
вами возникнет окно, приведенное на рис. 2.31. 

Перевод текста в этом окне гласит: «Проект Pdebugl.exe вызвал генерацию 
исключения класса EOverflow с сообщением 'Переполнение при операции с пла- 
вающей запятой’. Процесс остановлен. Используйте команды Step или Run для 
продолжения». 


Рис. 2.31 
Сообщение отладчика об ошибке 
переполнения 


a a a СЕЧЕНИЕ ОЧЕН 
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Это сообщение об ошибке, приведшей к генерации так называемого исключе- 
ния. Исключения (exceptions) генерируются при различных ошибках — исключи- 
тельных ситуациях. Способы работы с исключениями вы можете посмотреть в гла- 
ве 12 в разделе 12.10. А сейчас перед нами стоит вопрос: Что делать? Щелкнув на 
кнопке ОК, вы попадете в окно Редактора Кода и увидите в нем (рис. 2.32) код ва- 
шей программы с выделенной строкой, около которой стоит зеленая стрелка. Это 
тот оператор, при выполнении которого произошла ошибка. 


Рис. 2.32 
Окно Редактора Кода с выделенной 
строкой, в которой произошла ошибка 


& Udebug!.cpp 
Ue Shs 1 . 


‘double д = 1; ? 
в. ‘void __fasteall TFormi::ButtoniClick(TObject *Sender) 
“i int i; 


be) for(i = 0; i < 50; i++) 


"| Lebeli->Caption = "A = " + FloatToStr (А) ; 


Дальнейшие ваши действия сводятся к одной из следующих альтернатив. 


Ш Можно нажать клавиши Ctrl-F2 и тем самым прервать выполнение и отладку 
приложения. 


Это, конечно, возможный вариант действий, если вы уже поняли, в чем за- 
ключается ошибка, и готовы ее исправить. Если же нет, то вам придется анализи- 
ровать ситуацию, обдумывать возможные варианты ее исправления ит.д. Береги- 
те свое время и серые клеточки своего мозга! Если неясно, в чем заключалась 
ошибка, прервавшая выполнение приложения, то не тратьте силы на размышле- 
ния. Прежде, чем прерывать сеанс работы с приложением, надо получить допол- 
нительную информацию о состоянии переменных, т.е. провести отладку. А потом 
уже можно обдумывать ситуацию, имея на руках данные. 

Ш Можно выполнить команду Run | Run (или нажать соответствующую быструю 
кнопку, или клавишу FY), чтобы попытаться, несмотря на ошибку, продол- 
жить вычисления. | 
При этом перед вами возникнет окно (рис. 2.33) с сообщением о виде ошибки, 

после чего вы можете продолжать работать с приложением. Но это ни к чему не при- 
ведет, так как при очередном щелчке на кнопке ситуация с. ошибкой повторится. 


Рис. 2.33 


Окно информации об исключении 


Ш Вы можете пройти часть программы по шагам, как рассмотрено в одном из 
следующих разделов. 
Но прежде, чем это делать, вам надо получить какую-то информацию. Иначе 
такой проход ничего вам не даст. 
Итак, единственно правильный способ действий, если причина ошибки неясна: 


Ш Надо получить информацию о происходящих в приложениях процессах, при- 
ведших к ошибке. 
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Это можно сделать несколькими способами. В ACP C++Builder 5 имеется Mac- 
тер оценки выражений — Tooltip Expression Evaluation. Подведите курсор мыши к 
имени одной из переменных в коде, например, к А, и увидите текст: «А=1Е+308». 
Таким простым способом вы можете узнать значения переменных программы в 
данный момент. Правда, иногда могут возникать трудности. Некоторые перемен- 
ные не удается наблюдать, потому что оптимизирующий компилятор удалил их из‘ 
результирующего кода. 


2.6.4 Окно наблюдения Watch List 


Мастер оценки выражений, конечно, хороший инструмент, HO OH дает значе- 
ния только отдельных переменных, а в сложных приложениях вам надо бы иметь 
перед глазами значения нескольких переменных сразу, чтобы из их сравнения по- 
нять причины неправильной работы приложения. Такую возможность предостав- 
ляет вам окно наблюдения Watch List. Сделать его видимым можно командой View | 
Debug Windows | Watches. Ho этого даже можно не делать. Достаточно подвести Kyp- 
сор в коде к интересующей вас переменной и нажать Ctrl-F5. При этом окно \pard 
рат наблюдения автоматически откроется и в нем появится имя переменной и ее 
значение (значение переменной будет видно только при остановке выполнения 
приложения и переходе в MCP C++Builder). Затем вы можете подвести курсор к 
другой переменной, опять нажать Cirl-F5 и в окне наблюдения появится новая стро- 
ка. Более того, вы можете выделить курсором какое-то выражение, нажать Crrl-F5 
и в окне наблюдения увидеть значение этого выражения (рис. 2.34). 


Рис. 2.34 Watch List 
Окно наблюдения 4: 1Е+309 
А * 10000: + ЧЕ 


Form1->Labell->Caption: { "А = 1E 200" } 


На рис. 2.34 представлено окно наблюдения в момент, когда в нашем прило- 
жении произошла генерация исключения. Можно видеть, что переменная А равна 
10380, а значение выражения А * 10000 указано равным +INF. Этот идентифика- 
тор соответствует плюс бесконечности. Значит, при очередном умножении А на 
10000 возникает переполнение, так как переменная типа double не может хранить 
столь болышое число. В этом и заключается причина возникновения ошибки в на- 
шем примере. 

Окно наблюдения прекрасный инструмент, но при его использовании надо со- 
блюдать некоторые правила. Когда вы пишете код, то по умолчанию считается, 
что все компоненты принадлежат текущей форме и все свойства, для которых вы 
не указываете объект, относятся также к текущей форме. В окне наблюдений по- 
добных предположений не делается. Поэтому, если вы занесете в окно, например, 
выражение Labell->Caption, то при останове выполнения приложения получите 
вместо значения этого выражения сообщение: «Undefined symbol ‘Labell'» — не 
определен символ ‘Labell’. Если же вы добавите в это выражение ссылку на форму 
Form1, как это сделано на рис 2.34, то все будет работать нормально. 

Иногда переменные не удается наблюдать, потому что оптимизирующий ком- 
пилятор удалил их из результирующего кода и помещает соответствующие значе- 
ния в системные регистры. Это ускоряет выполнение вычислений в приложении, 
экономит память, но препятствует наблюдению переменных в процессе отладки. В 
таких случаях можно объявить соответствующую переменную с ключевым словом 
volatile. Например: 


volatile int x; 
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Спецификатор volatile говорит компилятору, что данную переменную нельзя 
хранить в регистре. 

Другой (и лучший) вариант достичь той же цели — выполнить команду Project | 
Options и в открывшемся окне на странице Advanced Compiler выключить опцию 
Register Variables (см. подробнее в разделе 14.2.9.4). 

Только имейте в виду, что после окончания отладки оба эти варианта лучше 
убрать, чтобы не снижать эффективность своего приложения. 

К сожалению, не со всеми трудностями удается справиться так легко. Некото- 
рые переменные становятся ненаблюдаемыми в момент генерации исключения. В 
частности, если в нашем примере вы выведите в окно наблюдения переменную 1, то 
ее значение можно будет наблюдать при использовании описанных далее (см. раз- 
дел 2.6.7) точек прерывания и пошаговом выполнении приложения. Однако, в MO- 
мент генерации исключения эта переменная становится недоступной и с этим ни- 
чего поделать невозможно. 

Рассмотрим теперь работу с окном наблюдения. Перейдя в него, вы можете 
щелкнуть правой кнопкой мыши и во всплывшем меню выбрать ряд команд, в ча- 
стности: Edit Watch (отредактировать наблюдаемое выражение) или Add Watch (вста- 
вить новое наблюдаемое выражение). В обоих случаях вы попадете в окно Watch 
Properties, представленное на рис. 2.35. Вы можете попасть в это окно из окна на- 
блюдения и проще, нажав клавиши Ctrl-F5. 


Рис. 2.35 
Окно задания списка наблюдения Watch 
Properties 


Рассмотрим коротко отдельные элементы окна Watch Properties. B окне редак- 
тирования Expression вы можете записать имя любой переменной или любое выра- 
жение, содержащее переменные, константы, функции. Окно редактирования 
Repeat count используется при наблюдении массивов и позволяет задать число на- 
блюдаемых элементов массива. Например, если у вас в программе имеется массив 
Х, вы можете просто указать в окне Expression имя переменной Х. Тогда в окне на- 
блюдений будут отображаться все элементы массива Х. Но вы можете указать в 
окне Expression первый элемент массива Х[О], а в окне Repeat count написать, на- 
пример, 10. Тогда в окне наблюдений будут отображаться только первые 10 эле- 
ментов массива. 

Окно редактирования Digits определяет число выводимых значащих разрядов 
чисел с плавающей запятой. Индикатор Enabled позволяет отключить вывод в окно 
наблюдения соответствующего выражения во время выполнения приложения. Это 
повышает производительность выполнения. А после того, как приложение оста- 
новлено и вам надо все-таки посмотреть данное выражение в окне наблюдения, вы- 
делите его в этом окне и сделайте на нем двойной щелчок. Откроется окно Watch 
Properties с загруженным в него выражением и вам останется только включить ин- 
дикатор Enabled и щелкнуть ОК. 

Индикатор Allow Side Effects разрешает или запрещает отображение таких выра- 
жений, которые способны вызвать побочные эффекты. Например, вы можете запи- 
сать в окне Expression выражение ++А. Если индикатор Allow Side Effects выключен 
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(он выключен по умолчанию), то в окне наблюдений вы увидите рядом с выраже- 
нием ++А текст: «Side effects are not allowed.» (побочные эффекты запрещены). 
Действительно, в данном случае, если отображать указанное выражение, то значе- 
ние переменной А в программе изменится. Если же вы включите для этого выра- 
жения индикатор Allow Side Effects, то отображение соответствующего значения, на 
1 большего A, будет производиться. Но учтите, что это будет изменять значение 
переменной А. 

Радиокнопки в нижней части окна Watch Properties задают формат вывода зна- 
чения переменной или выражения. По умолчанию включена кнопка Default. В этом 
‘случае формат определяется автоматически по типу отображаемого выражения. 
Но вы можете выбрать и другой формат. Например, вы можете воспользоваться 
‚ этим радиокнопками, чтобы отображать некоторую целую переменную один раз в 
десятичном виде, а второй раз — в шестнадцатеричном виде. 

Выпадающий ‘список в окне редактирования Expression позволяет выбрать вы- 
ражение из тех, которые использовались ранее, и при необходимости отредактиро- 
вать его. Это удобно, если надо выводить в окно наблюдений похожие выражения. 
Например, если вам надо вывести значения © Form1->Labell->Caption, 
Form1->Label2->Caption и Form1->Label3->Caption, то достаточно один раз на- 
писать это выражение, а в дальнейшем брать его из выпадающего списка и только 
менять в нем цифру. 

В заключение посмотрим, как можно редактировать список выражений в окне 
наблюдения. Удалить какое-то выражение из этого списка можно просто выделив 
требуемое выражение и нажав Delete. Отредактировать ошибочное выражение 
можно, сделав на нем двойной щелчок, после чего вы окажетесь в окне Watch 
Properties и можете заниматься редактированием. 

Вернемся к нашему примеру. Как видно из значений переменных (см. 
рис. 2.34), в момент появления ошибки выполнения значение А равно 10308, а сле- 
дующее значение должно быть равно 10312. Такого значения переменная типа 
double хранить не может. Значит, или надо задать переменной А другой тип, или 
уменьшить скорость увеличения переменной. Теперь можно нажимать Сн|-Е2, пре- 
рывать выполнение и исправлять код. Но подождите это делать. Давайте посмот- 
рим еще один инструмент отладки — окно оценки и модификации Evaluate/Modify. 


2.6.5 Окно оценки и модификации Evaluate/Modify 


Окно оценки и модификации Evaluate/Modify позволяет вам в процессе отладки 
не только наблюдать, но и изменять значения переменных. Сделать это окно види- 
мым можно командой Run | Evaluate/Modify. Соответствующую команду Debug | 
Evaluate/Modify можно также выбрать из контекстного меню, всплывающего при 
щелчке правой кнопкой в окне Редактора Кода. 

Окно имеет вид, представленный на рис. 2.36 а. В его верхнем окошке редак- 
тирования Expression вы можете ввести имя переменной или выражение. После это- 
го, щелкнув на кнопке Evaluate, вы увидите в окне Result значение этого выражения. 
Эти возможности пока ничем не отличаются от возможностей рассмотренного ра- 
нее окна наблюдений и даже слабее, поскольку дают значение только одной пере- 
менной или одного выражения. Но если вы указали в окошке Expression имя пере- 
менной, а не выражение, то вам становится доступной кнопка Modify, позволяю- 
щая изменить значение переменной. Т.е. вы можете вмешаться в процесс выполне- 
ния приложения и насильственно изменять значения переменных. 

Пусть, например, мы решили изменить значение переменной А, вызвавшей 
переполнение, и посмотреть, как будут далее протекать события в приложении. 
Тогда мы должны в окошке Expression указать имя этой переменной, в окошке New 
value написать ее новое значение в виде числа или какого-то выражения (на 
рис. 2.36 6 написано выражение «А/2е3 00») и нажать кнопку Modify. В результате 
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Evaluate Modify. Watch — Inspect Help 


Puc. 2.36 а) a |  valuate/Modify 
Окно оценки и модификации в исходном состоянии (a) 1 : Е. 
после изменения значения А (6) 


| Expression о _ 


: А | th peri: 7. 


"Ве. ве. 
1Е+308 | ар po: 


fie+303 | 


6) 


Eyaluate Modify — Watch Inspect _ Нар. 


Expression: 


_ New value: TAR ee OR Cad RR Sgt 


‚А/2ез00 И a 


значение переменной в приложении изменится, что можно видеть в окошке Result. 
Измененное значение вы увидите и в окне наблюдения, если перейдете в него. 

Поскольку вы резко уменьшили значение переменной A, можете после этого 
нажать Г9, чтобы продолжить выполнение приложения. И оно будет продолжено, 
хотя, конечно, не надолго. После двух щелчков на кнопке ошибка переполнения 
возникнет вновь. 

В данном примере исправление значения переменной, естественно, не имело 
практического смысла. Но в реальных приложениях это может оказаться очень по- 
лезным. Большое приложение может выполняться не доли секунды, как наш при- 
мер, а минуты, десятки минут и более. Тогда становится очень актуальной возмож- 
ность оперативно исправить значения переменных, вызванные ошибкой, которую 
вы уже поняли, и продолжить отладку, не запуская выполнение опять с начала. 


2.6.6 Выполнение приложения по шагам 


Выше мы рассматривали способы собрать «статическую» информацию о со- 
стоянии приложения в момент, когда произошла ошибка выполнения. Но не все- 
гда такая информация дает полную картину происходящего. Чаще для того, чтобы 
найти причину ошибки, надо выполнить какой-то фрагмент программы, наблюдая 
изменения переменных при выполнении каждой команды. 

Для прохода фрагмента программы по шагам можно использовать команды: 


«Горячие» | Пояснения 


клавиши 


} 5 
| Step Over Пошаговое выполнение строк программы, 
| (По шагам без захода в считая вызов функции за одну строку, 

ves) т.е. вход в функции не производится. 


| Trace Into Пошаговое выполнение программы с 3a- 
(Трассировка с заходом ходом в вызываемые функции. 


Пояснения 


клавиши 


| Trace to Next Source Line Shift++F7 Переход к следующей исполняемой 
| (Трассировка до следую- ° | строке. 


| Кип to Cursor F4 Команда выполняет программу до того 
| (Выполнить до курсора) выполняемого оператора, на котором 
| расположен курсор в окне редактора 


кода. 


| Run Until Return Shift+F8 Выполнение программы до выхода из 
(Выполнить до выхода текущей функции, останов на операто- 
| из функции) ре, следующем за вызовом этой функ- 


ции. 


| Show Execution Point Команда помещает курсор на операторе, 
| (Показать точку выпол- который будет выполняться следующим. 
нения) 


Испытайте эти команды на нашем примере. Выведите значения интересую- 
щих вас переменных и выражений в окно наблюдения Watches. Это окно, с KOTO- 
рым вы уже хорошо знакомы, является, как говорилось, встраиваемым. Этим 
удобно воспользоваться, встроив его, например, в Инспектор Объектов. В режиме 
проектирования окно наблюдения будет храниться на отдельной странице позади 
Инспектора Объектов (рис. 2.37 a), не занимая площадь экрана и нисколько He ме- 
шая работе. А во время выполнения приложения страницы Инспектора Объектов 
будут исчезать и при остановах вы можете наблюдать в окне Watches значения пе- 
ременных (рис. 2.37 6). Для Toro, чтобы все это работало, надо сохранить описан- 
ную или любую другую конфигурацию отладочных окон с помощью команды View | 
Desktops | Save Desktop и командой View | Desktops | Set Debug Desktop задать эту конфи- 
гурацию Kak отладочную (подробности см. в разделе 2.2.9). Еще проще осуществ- 
лять подобные операции с конфигурациями соответствующими быстрыми кнопка- 
ми вверху окна ИСР (см. таблицу 2.1 в разделе 2.2.3). 


Рис. 2.37 

Окно наблюдения, встроенное в : 
Инспектор Объектов: режим “| Form: TForm1 
проектирования (а) и режим отладки 


(6) 


1A* 10000: 16 +204 
‚| Form1->Labell->Caption: {"А = 1E 200" } | 
Vi 27 : 


Выведя интересующие вас переменные в окно наблюдения и удобно разместив 
это окно, перейдите в ваш код и установите курсор на строке с оператором 


А *= 10000; 
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Теперь нажмите F4, чтобы приложение выполнялось до тех пор, пока не дой- 
дет до строки, в которой стоит ваш курсор. Приложение начнет выполняться. На- 
жмите в нем кнопку. Вы попадете в окно Редактора Кода, состояние которого бу- 
дет таким, какое вы уже наблюдали ранее в случае ошибки (см. рис. 2.32): будет 
выделена строка, на которой стоял ваш курсор перед выполнением. Теперь вы мо- 
жете, нажимая F/ или F8 (в данном случае это безразлично), выполнять операторы 
по шагам и в окне наблюдений видеть изменения переменных и выражений. Раз- 
личие между F7 и F8 проявилось бы, если бы ваши операторы содержали вызов ка- 
ких-то других функций, определенных в вашем модуле. В этом случае при нажа- 
тии F7 программа заходила бы внутрь этих вызываемых функций, а при нажатии 
F8 — не заходила бы. | 

Если вы прошли несколько циклов и вам это надоело, можете перевести кур- 
сор на оператор, следующий после цикла и задающий значение Labell->Caption. 
Нажмите Г! 4.,Тем самым вы сказали отладчику, что ему надо без остановов выпол- 
нять приложение до строки, указанной курсором. Все оставшиеся проходы цикла 
будут выполнены без остановов и программа остановится на указанной вами стро- 
ке. 

Если после этого вы нажмете клавишу F7 или F8, то результат будет различ- 
ным. При нажатии F8 вы просто перейдете к следующему оператору — закрываю- 
щей фигурной скобке. А при нажатии F/ вы сначала попадете в заголовочный файл 
dstring.h, в котором объявлены функции работы со строками типа AnsiString, к 
которым вы неявно обращаетесь в операторе программы. И только после несколь- 
ких нажатий Г7 вы вернетесь в свою программу. 


2.6.7 Точки прерывания 


Выше мы рассмотрели останов приложения командой Run to Cursor — клави- 
шей F4. Теперь рассмотрим более мощный инструмент — введение в приложение 
точек прерывания (breakpoint). 

Чтобы ввести простую (безусловную) точку прерывания, достаточно в окне Ре- 
дактора Кода щелкнуть мышью на полоске левее кода требуемой строки. Строка 
окрасится в красный цвет и на ней появится красная точка (рис. 2.38). Если вы те- 
перь запустите приложение на выполнение и начнете с ним работать, то произой- 
дет прерывание выполнения, как только управление перейдет к строке, в которой 
указана точка прерывания. 

Такая точка прерывания дает тот же результат, что и описанное ранее выпол- 
нение до точки, указанной курсором, при нажатии клавиши F4. Но преимущество 
точек прерывание заключается в том, что их можно одновременно указать не- 
сколько в разных местах кода и в разных модулях. Приложение будет выполнять- 
ся до тех пор, пока управление не перейдет к первой встретившейся в программе 
точке прерывания. Кроме того, как мы скоро увидим, в этих точках можно уста- 
навливать условия прерывания. 


Рис. 2.38 


Окно Редактора Кода с выделенной точкой 
прерывания 


о. 


for(i = О; i < SO; i++) 
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Для того, чтобы убрать точку прерывания, достаточно munarqeideie мышью на 
красной точке левее кода соответствующей строки. ~ 

Точки прерывания можно устанавливать только на выполняемых операторах. 
Если вы, например, попробуете установить точку прерывания на строке, содержа- 
щей объявление переменной, то в момент запуска приложения в красной точке, 
выделяющей точку прерывания, появится крестик. Тем самым C++Builder преду- 
преждает, что прерывания не будет, поскольку оператор невыполняемый. Анало- 
гичный крестик может появится и в том случае, если компилятор в процессе опти- 
мизации кода убрал какой-то написанный вами оператор. Если вы все-таки хотите 
остановиться именно на этом операторе, вам надо отключить оптимизацию (см. 
раздел 14.2.9.3). 

C++Builder дает возможность установить условия прерывания. Задержите 
курсор мыши над красной точкой слева от строки, где вы установили прерывание. 
Вы увидите (рис. 2.38) всплывший ярлычок с характеристиками данной точки 
прерывания. По умолчанию никаких условий останова не задается. Поэтому до 
сих пор остановы были при каждой передаче управления на точку прерывания. 
Попробуем задать условия прерывания. Пусть, например, мы хотим остановиться 
на точке прерывания, которую мы уже ввели, но только на 26-м цикле, причем 
только при повторном проходе цикла (повторном щелчке пользователя на кнопке 
нашего приложения). Иначе говоря, мы хотим остановиться, когда переменная 1 
будет иметь значение 26, причем не в первый, а во второй раз. 

Щелкните правой кнопкой мыши на красной точке в строке, где вы ввели пре- 
рывание (рис. 2.38). Из всплывшего меню выберите раздел Breakpoint properties. Пе- 
ред вами откроется окно, представленное на рис. 2.39. Это окно в C++Builder 5 су- 
щественно богаче по своим возможностям, чем аналогичное окно в C++Builder 4. 


Рис. 2.39 

Окно (в развернутом виде) задания свойств 
прерывания в указанной строке файла 

в C++Builder 5 


Два верхних окошка редактирования — Filename (имя файла) и Line Number (Ho- 
мер его строки) в данном режиме недоступны. Они автоматически заполнились в 
момент, когда вы установили в своем коде точку прерывания. 
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Окошко Condition (условие) позволяет вам ввести некоторое условное выраже- 
ние. Прерывание будет происходить только в случае, если значение этого выраже- 
ния равно true. В нашем примере вы можете указать условие останова «1==26». 

Окошко Pass Count позволяет указать, при котором по счету выполнении запи- 
санного условия произойдет останов. В нашем примере нас интересует второй про- 
ход цикла. Поэтому задайте в окошке Pass Count значение 2. 

Окошко Сгоур (группа) позволяет задать имя группы, к которой относится 
данное прерывание. C++Builder 5 позволяет отнести прерывание к какой-то груп- 
пе. Группировка прерываний позволяет сделать целиком ту или иную группу дос- 
тупной или недоступной. Это делается с помощью показанных внизу на рис. 2.39 
окошек Enable Group (доступная группа) и Disable Group (недоступная группа). В 
этих окнах имя группы выбирается из выпадающих списков, содержащих имена 
введенных ранее групп. 

Кнопка Advanced развертывает нижнюю часть окна задания свойств прерыва- 
ния. В ней вы можете указать некоторые действия (Action), выполняемые в момент 
прерывания. Индикатор Break, установленный по умолчанию, обеспечивает стан- 
дартную реакцию — останов выполнения приложения. Группа индикаторов Ignore 
subsequent exception (игнорировать последующее исключение) и Handle subsequent 
exception (обрабатывать последующее исключение), из которых установить можно 
только один, определяют появление при генерации очередного исключения сооб- 
щения отладчика (см. раздел 2.6.3, рис. 2.31). Если установлен индикатор Ignore 
subsequent exception, то это сообщение не появляется. Если установлен индикатор 
Handle subsequent exception, то это сообщение появляется. Если не установлен ни 
один индикатор, то все определяется настройками отладчика C++Builder на стра- 
нице Language Exceptions окна настройки отладчика (см. раздел 14.2.8). 

Окошко Log Message позволяет записать некоторое сообщение, которое будет 
появляться в момент прерывания в окне протокола событий Event Log (см. раз- 
дел 2.6.9). Окошко Eval Expression позволяет записать некоторое выражение, кото- 
poe будет вычисляться при прерывании. При установленном индикаторе Log Result 
это выражение и результат его вычисления вы сможете увидеть в том же окне Event 
Log. 

С учетом возможностей задания сообщений и выражений, появляющихся в 
окне Event Log, вам, вероятно, становится более понятным наличие индикатора 
Break. Если вы выключите этот индикатор и включите индикатор Ignore subsequent 
exception, то никаких остановов выполнения приложения в точке прерывания или 
при генерации исключения не будет происходить. Но завершив выполнение при- 
ложения и посмотрев протокол Event Log, вы увидите там соответствующие сообще- 
ния, которые позволят вам отследить логику работы приложения, понять, какие 
фрагменты кода и сколько раз выполнялись. 

Внесите в окно задания свойств прерывания данные, показанные на рис. 2.39, 
щелкните на ОК и запустите выполнение приложения. После первого нажатия ва- 
ми кнопки приложения останова не произойдет, а после второго нажатия выполне- 
ние остановится. Вы сможете увидеть в окне наблюдений, что в этот момент 1 = 26. 
Затем, при желании, вы можете пройти по шагам (с помощью клавиши F/) послед- 
ний цикл перед появлением ошибки. А если в окне рис. 2.39 вы выключите инди- 
катор Break, то останова в точке прерывания не будет, а после генерации исключе- 
ния вы сможете выполнить команду View | Debug Windows | Event Log, и в окне прото- 
кола событий найдете, в частности, строки 

Breakpoint Message: останов при 1=26 во второй раз Process Pdebugl.exe 


(OxFFFAF9BQ9) 
Breakpoint Expression A: 1E+304 Process Pdebugl.exe (OXFFFAF9B9) 


Это введенное вами сообщение («останов при 1=26 Bo второй раз») и выраже- 
ние (А) с посчитанным результатом. 
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Список введенных вами точек прерывания хранится в списке, который вы мо- 
жете в любой момент (и до выполнения программы, и при останове) увидеть, если 
выполните команду View | Debug Windows | Breakpoints. Откроется окно Breakpoint List 
(рис. 2.40 а). В нем вы увидите введенную вами ранее точку прерывания (на 


рис. 2.40 видна еще одна точка, которую мы введем позднее). Окно точек прерыва-. 


ния удобно встраивать в окно наблюдения (см. рис. 2.40 6) и фиксировать такую 
конфигурацию окон как отладочную. Тогда в моменты останова вы будете видеть и 
наблюдаемые величины, и информацию о точках прерывания. 


Рис. 2.40 Breal на 

Окно точек прерывания в виде | ne/Address:| Лео | Condition Action’! i.) Pass Count’ | Group. 
5 ‘Udebug]. cpp 22 ==26 Вгеак, 1.09 Ме... 002 0 

отдельного окна (а) и встроенное в "ВА 9 A> 16299 Break, LogMe... 0 1 


окно наблюдения (6) 


= List, oe List _ 


et ik. 4 С 200 
14.* 10000; 1Е +304 
Form1->Labell->Caption: { "А = 1E 200" } 


25 


eG” Вик. ы Oo? 0 | 
A>1e299 Break. Ll... 0 1: 


Условные точки прерывания — мощный инструмент отладки приложений, со- 
держащих циклы. В нашем примере мы знаем, что ошибка происходит именно 
при втором проходе цикла, поскольку каждый проход мы сами запускаем нажати- 
ем кнопки приложения. Ho если бы в более сложной программе мы этого не знали, 
то условная точка прерывания позволила бы нам определить, на каком именно 
проходе произошла ошибка. Для этого можно в окне задания свойств точки преры- 
вания указать большое значение Pass Count, например, 50. Тогда, конечно, преры- 
вание в этой точке не произойдет, поскольку раньше будет зафиксирована ошибка. 
Но если после прерывания вследствие этой ошибки вы посмотрите окно Breakpoint 
List, то увидите, что там указано, сколько произошло проходов через точку преры- 
вания с выполнением заданного условия. 

Теперь обсудим некоторые возможности окна точек прерывания. Щелкните в 
окне правой кнопкой мыши и во всплывшем меню выберите команду Add — доба- 
вить точку прерывания. Вам будет предложено три варианта: Source Breakpoint — 
точка прерывания в фале приложения, Address Breakpoint — прерывание при пере- 
ходе управления по заданному адресу, и Data Breakpoint — прерывание при измене- 
нии данных по заданному адресу. Правда, если вы работаете в окне Breakpoint List не 
во время выполнения вашего приложения, две последние команды будут недоступ- 
ны. Это связано с тем, что пока приложение не выполняется, адреса команд и пе- 
ременных еще не известны. 

Давайте рассмотрим пример использования прерывания при изменении дан- 
ных по заданному адресу. В нашем приложении мы знаем единственный оператор, 
который изменяет значение переменной А. Но в сложном приложении подобных 
операторов может быть много. И тогда мы не можем знать, какой из них увеличи- 
вает значение А настолько, что дальнейшее выполнение приложения грозит пере- 
полнением, или какой оператор заносит в А недопустимое значение. В подобных 


случаях помогает установка прерывания при изменении данных по заданному ад- 


vor ow 


Система визуального объектно-ориентированного программирования C++Builder 117 


ресу — в нашем примере по адресу, отведенному для А. Вы не устанавливаете, на 
какой строке кода хотите прервать выполнение. Прерывание произойдет на том 
операторе, который занесет в указанную вами переменную некоторое значение, 
если будут выполнены указанные вами условия. 

Пусть мы хотим остановиться на операторе, заносящем новое значение в адрес 
А, причем при значении А _> 10299. Поскольку отладчик не знает адреса перемен- 
ных, пока приложение не загружено в память, то прежде, чем задавать точку пре- 
рывания, в данном случае надо запустить приложение на выполнение. Затем, не 
закрывая приложения и ничего с ним не делая, вернитесь в UCP C++Builder. В 
окне Breakpoint List щелкните правой кнопкой мыши и BO всплывшем меню выбери-_ 
те команду Ада. Из предложенных вам трех вариантов точек прерывания выберите 
Data Breakpoint — прерывание при изменении данных по заданному адресу. Откро- 
ется окно (рис. 2.41), подобное рассмотренному ранее (см. рис. 2.39). Только здесь 
в окошке редактирования Adress задается переменная, при изменении которой на- 
ступает прерывание. Окошко длины переменной (Length) обычно заполняется ав- 
томатически. Окна Condition u Pass Count имеют тот же смысл, что в окне рис. 2.39. 


Рис. 2.41 Add Data ve cy 


Окно (в развернутом виде) задания свойств прерывания 
при изменении данных по заданному адресу 


— Advanced «| 
Pie ee. ny eee 
р вже Е же 
ТГ Ignore ее exceptions i 
| № Handle subsequent exceptions | 


| ‚значение А > 1е293 > Be 


te go: ee 
1 Disable orouc: в я 


Заполнив окно так, как показано на рис. 2.41, щелкните на ОК. Вы вернетесь 
в окно списка точек прерывания, в котором появится введенная вами новая точка 
(рис. 2.40 а). 

Чтобы убедиться в работе новой точки прерывания, отключите прежнюю. Для 
этого выделите ее в окне списка точек прерывания, щелкните на ней правой кноп- 
кой мыши и из контекстного меню выберите команду Properties. В появившемся 
диалоговом окне (рис. 2.39) введите имя группы (например, «0») и выберите это 
же имя в окошке Disable Group. Тем самым вы сделаете недоступной прежнюю точ- 
ку прерывания. Можно поступить проще: щелкнуть правой кнопкой мыши на 
строке прежней точки прерывания и BO всплывшем меню снять установку индика- © 
тора Enabled. На всякий случай проверьте, что в новой точке прерывания индика- 
тор Enabled включен. Теперь вернитесь в ваше выполняющееся приложение и 
щелкните кнопкой. Приложение будет выполняться, но заметно медленнее, чем 
раньше. Это влияние накладных расходов на проверку условий при каждом изме- 
нении А. После второго щелчка приложение остановится на операторе 


A:=A*10000; 
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при состоянии приложения, когда A= 10300 (см. рис. 2.40 6). Т.е. прерывание, как 
и было заказано, произошло после того, как соответствующим образом изменилась 
переменная А. 

Учтите, что доступность точки прерывания по изменению переменной сохраня- 
ется только в течение данного сеанса выполнения приложения. По завершении вы- 
полнения точка становится недоступной и при следующем запуске ее надо повторно 
активизировать, устанавливая с помощью контекстного меню ее индикатор Enabled. 


Помимо описанных команд, задающих точки прерывания в C++Builder 5, 
имеется еще несколько команд, осуществляющих те же функции. Это, прежде все- 
го, команда Run | Add Breakpoint (добавить точку прерывания) с разделами Source 
Breakpoint, Address Breakpoint, Data Breakpoint и Module Load Breakpoint. Первые три раз- 
дела выполняют Te же функции, что и одноименные им разделы контекстного меню 
списка точек прерывания, рассмотренные ранее. А последний раздел позволяет за- 
дать прерывание при загрузке в память указанного модуля (обычно библиотеки .dIl 
или пакета .bpl). Имеется также возможность задать прерывание по изменению пе- 
ременной из всплывающего меню окна наблюдения (команда Break When Changed). Co- 
ответствующая точка возникает в списке точек прерывания, но доступна только в 
течение данного сеанса выполнения приложения. По завершении выполнения точка 
становится недоступной и при следующем запуске ее надо повторно активизиро- 
вать, устанавливая с помощью контекстного меню ее индикатор Enabled. 


2.6.8 Использование окна Инспектора Отладки Debug Inspector 


В C++Builder 5 имеется еще одно средство отладки — Инспектор Отладки 
Debug Inspector. Инспектор Отладки позволяет вам получить исчерпывающую ин- 
формацию о любой переменной в приложении и дает возможность, как и окно 
оценки и модификации Evaluate/Modify, изменить значение переменной и продол- 
жить выполнение приложения с этим новым значением. 

Вызов этого инструмента осуществляется командой Run | Inspect, которая дос- 
тупна только во время выполнения приложения при останове средствами отладки 
или вследствие генерации исключения. При останове вы можете поставить курсор 
в окне Редактора Кода на имя интересующей вас переменной и выполнить коман- 
ду Run | Inspect. Другой способ — вызвать ту же команду из всплывающего меню 
(Debug | Inspect). Hy, а проще всего — нажать «горячие» клавиши Alt+F5. Попробуй- 
те сделать это при генерации исключения в нашем тестовом приложении. Если по- 
сле прерывания выполнения вы поставите курсор на пустое место в коде и вызови- 
те Инспектор Отладки, перед вами откроется окно, в котором вы можете написать 
имя интересующей вас переменной, например, А и щелкнуть ОК. Вы увидите 
окно, представленное на рис. 2.42 a. 


Рис. 2.42 


Окна Инспектора Отладки: наблюдения (а) и 
изменения (6) значения переменной 
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В окне содержатся сведения об указанной вами переменной. Нажав кнопку с 
многоточием, вы можете увидеть следующее окно Инспектора Отладки — окно из- 
менения Change, представленное на рис. 2.42 6. В этом окне вы можете изменить 
значение переменной и оно изменится в выполняемой программе, так что при про- 
должении выполнения приложения оно будет выполняться с заданным вами зна- 
чением переменной. 

Инспектор Отладки позволяет исследовать различные данные: переменные, 
массивы, классы, функции, указатели. На рис. 2.43 приведено окно, которое вы 
могли бы увидеть, если бы в качестве объекта исследования указали кнопку 
Form1->Labell. Как видите, это окно имеет три страницы, из которых одна — стра- 
ница свойств Properties, показана на рисунке. На этой странице вы можете увидеть 
перечисление всех свойств компонента, их значения и функции их чтения и записи. 


Рис. 2.43 |[реБиа Inspector dain aie eee 
Окно Инспектора Отладки для объекта. Label | Рой > аБеП: Stdetrls:: TLabel * :01193414 : : 


Если вы хотите изменить какее-то свойство (конечно, не из тех, которые толь- 
ко для чтения), вы можете выделить это свойство и нажать появившуюся около 
него кнопку с многоточием. Появится окно изменения Change, аналогичное приве- 
денному на рис. 2.42 6, в котором вы можете ввести новое значение свойства. 

Не все значения свойств могут быть в момент останова досчитаны до конца. В 
этом случае, если вы выделите курсором это свойство, около него появляется кно- 
почка со знаком «?», Она видна на рис. 2.43 в строке свойства Caption. Из рисунка 
видно, что значение надписи метки не посчитано и не выведено в окне. Если вы на- 
жмете кнопочку со знаком «?», то значение будет досчитано и, пока эта кнопочка 
нажата, при каждом останове выполнения свойство будет досчитываться до конца. 

Находясь в окне Инспектора Отладки, можно щелкнуть правой кнопкой. 
мыши и выбрать одну из следующих команд: 


Капае Просмотр данных в заданном диапазоне 
Change Перейти в окно Change для изменения значения элемента 
Show Inherited Если этот флаг включен, то на страницах окна отображают- 


ся все свойства и методы, как объявленные в данном классе, 
так и наследуемые. Если флаг выключен, то отображается 
только то, что объявлено в данном классе 


Show Fully Qualified Отображение наследуемых элементов с их полными именами 
Names 
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Inspect Открывает новое окно для выделенного вами элемента дан- 
ных. Это позволяет детальнее исследовать данные типа 
структур, классов, массивов и т.п. и только для таких дан- 
ных этот раздел доступен 


Descend Аналогична команде Inspect, но детализирующие данные 
появляются не в отдельном, а в том же самом окне. В даль- 
нейшем можно вернуться в исходное окно, воспользовав- 

. шись расположенным вверху окна выпадающим списком, в 
котором накапливаются просмотренные объекты 


New Expression Эта команда позволяет вам задать новое выражение для ана- 
лиза 
Type Cast Позволяет вам указать другой тип для рассматриваемого объ- 


екта, например, указать тип нетипизированного указателя 


2.6.9 Протокол событий, функция OutputDebugString 


В C++Builder предусмотрена возможность просматривать протокол сообщений 
о событиях, происходящих в процессе выполнения приложения в режиме отлад- 
ки. Протокол этих сообщений вы можете посмотреть в процессе выполнения или 
после его окончания, выполнив команду View | Debug Windows | Event Log или нажав 
клавиши Сн-А!-Е. В открывшемся окне Event Log (его пример приведен на 
рис. 2.44) вы увидите протокол событий. На рис. 2.44 вы можете видеть, в частно- 
сти, сообщения точек прерывания, введенных ранее в разделе 2.6.7: три последние 
строки относятся к точке прерывания по 1 = 26, строки с 3 по 5 — к точке прерыва- 
ния по А > 10299. Щелкнув в окне правой кнопкой мыши, вы можете сохранить 
протокол в файле, прокомментировать его, очистить. 


Рис. 2.44 | Е ме! Log xi 
Окно Event Log ] Source Breakpoint at 0x004016DB: D:\Program Files\Borland\R ampage\Projects\ Te | 
1005: Окончание цикла: А = 1E200 Process Pdebug1.exe (OxFFF92E 83) 
| Data Breakpoint at 0x004016E 7: Object at address: 0%00403294. Length: 8. Process. 
| Breakpoint Message: значение A > 16299 Process Pdebug] Jexe (OxFFF92E 83} | 
| Breakpoint Expression А: 1Е+300 Process Pdebug1.exe [0хЕЕЕ92Е 83] 
| Data Breakpoint at 0x004016E7: Object at address: 000403294. Length: 8. Process 


Breakpoint Message: значение А > 1е299 Process Pdebug1.exe (OxFFFS2ZE 83} 
| Breakpoint Expression А: 1Е +300 Process Pdebug1.exe (OxFFF92E 83) } 
] Source Breakpoint at 0x004016DB: D:\Program Files\Borland\R ampage\Projects\T = 
| Breakpoint Message: останов при i=26 во второй pas Process Pdebug].exe (OxFFF. 
| Breakpoint Expression А: 1Е +304 Process Pdebug1.exe [OxFFF9ZE83) 


Какие именно сообщения отображаются в этом окне определяется настройкой 
отладчика, которая рассмотрена в разделе 14.2.8. Для пользователей, не слишком 
сведущих в системном программировании, можно рекомендовать ограничиться со- 
общениями о точках прерывания и сообщениями, генерируемыми функцией 
OutputDebugString. Об этой функции надо сказать особо. Это функция API 
Windows, определенная следующим образом: 


VOID OutputDebugString(LPCTSTR lpOutputString) ;* 


Ее параметр IpOutputString является указателем на строку текста с нулевым 
символом в конце. 

Функция OutputDebugString в процессе отладки выдает сообщение, которое 
вы можете наблюдать в окне протокола сообщений о событиях Event Log. Но если 
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отладчик отключен или если выполняемый модуль вашего приложения запускает- 
ся непосредственно, а не из среды C++Builder, то функция OutputDebugString ни- 
чего не делает. Таким образом, вы можете внести в разных местах своего приложе- 
ния вызовы OutputDebugString с соответствующими сообщениями, которые пока- 
жут вам ход выполнения приложения в режиме отладки. А когда вы или другие 
пользователи впоследствии запустят приложение в обычном режиме, наличие в 
нем вызовов ничем не помешает, кроме очень незначительных затрат времени и 
незначительного увеличения объема модуля. 

Можете опробовать этот инструмент в тестовом приложении, рассмотренном 
ранее, вставив, например, в конце функции TForm1::Button1Click оператор 


Оперу Бери Е г1па ( ("Окончание цикла: А = " + FloatToStr(A)).c_str()); 


Результат выполнения тестового приложения с этим оператором и приведен 
на рис. 2.44 (см. вторую строку окна). Только прежде, чем запускать ваше прило- 
жение, посмотрите в разделе 14.2.8, как отключить системные сообщения. В про- 
тивном случае вы с трудом найдете свои сообщения среди множества системных. 


2.6.10 Другие средства отладки 


В C++Builder имеется еще немало инструментария, позволяющего проводить 
отладку на более детальном уровне. Это, прежде всего, окно CPU (команда View | 
Debug Windows | CPU), позволяющее отследить ход выполнения проекта Ha уровне 
команд макроассемблера. Окно стека (команда View | Debug Windows | Call Stack) по- 
зволяет определить последовательность вызванных функций, не только тех, кото- 
рые вызываются явно вашим приложением, но и всех неявно вызываемых функ- 
ций библиотек. Окно модулей (команда View | Debug Windows | Modules) показывает 
список всех модулей, загруженных в память при выполнении вашего приложения. 
Это окно позволяет, в частности, если выделить на его левой верхней панели имя 
вашего модуля .ехе, увидеть в левой нижней панели список использованных заго- 
ловочных файлов. Двойной щелчок на строке соответствующего файла загрузит 
его в Редактор Кода и вы сможете попробовать понять, что именно из данного фай- 
ла использует ваше приложение и в чем суть возникших проблем. 

Эти и еще’некоторые другие средства отладки предназначены для пользовате- 
лей, чувствующих в себе силы погрузиться в тонкости работы приложения на 
уровне макроассемблера. Подавляющему большинству пользователей это вряд ли 
интересно и нужно. Поэтому в рамках данной книги мы не будем погружаться в 
эти глубины. 


2.6.11 Некоторые приемы программирования, встраивающие 
отладку в код 


Материал данного раздела предполагает наличие у читателя определенных 
сведений о программировании на языке С++ и о некоторых компонентах 
C++Builder. Тем, кто этими сведениями пока не обладает, можно пропустить этот 
раздел и вернуться к нему позднее. | 

В C++Builder имеется полезный инструмент для отладки — функция assert. 
Ее синтаксис: 


#include <assert.h> 
void assert(int test); 


Функция применяется при отладке программ для проверки истинности утвер- 
ждений test, которые по замыслу должны быть истинны, но в силу каких-то оши- 
бок могут нарушаться. Если проверяемое утверждение test окажется ложным (BO3- 
вращает 0), работа приложения завершается вызовом функции abort и выдается 
сообщение об ошибке. 
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Попробуйте использовать эту процедуру в вашем тестовом приложении. 
Вставьте директиву препроцессора 


#include <assert.h> 


и измените, например, цикл в приложении на следующий: 
for(i = 0; i < 50; 1++) 


{ 
А *= 10000; 
assert(A < 1е300); 
} 


В этом коде проверяется условие А < 10300 и если оно нарушается, то выдается 
сообщение об ошибке. Если вы запустите свое приложение, то при повторном 
щелчке на кнопке получите сообщение, представленное на рис. 2.45. В нем, ото- 
бражается условие, которое проверялось, а также модуль и строка, в которой про- 
изошло данное событие. 


Рис. 2.45 
Окно сообщения функции assert 


Закономерен вопрос: «А зачем нужна специальная функция assert, если то же 
самое можно было бы сделать простым оператором if?». Особенностью и преиму- 
ществом функции assert является то, что она реализована в виде макроса, KOTO- 
рый развертывается в соответствующую функцию только в случае, если не опреде- 
лен идентификатор NDEBUG. Поэтому достаточно вставить в ваш файл перед ди- 
рективой 


#include <assert.h> 
директиву 
#define NDEBUG 


и откомпилировать файл, как вызов функций, в которые разворачиваются макро- 
сы assert, исчезнут. Таким образом вы можете одной строкой отключить множест- 
во отладок, которые разбросаны по разным фрагментам вашей программы. При 
этом отладки не просто перестанут работать, но они исчезнут из результирующего 
выполняемого модуля, так что не будут увеличивать его размер и потреблять вы- 
числительные ресурсы. 

Впрочем, возможности assert слишком скромны, чтобы дать достаточную для 
отладки информацию. Вы легко можете сами определить свой макрос с более ши- 
рокими возможностями, позволяющий включать любые переданные в него сооб- 
щения. В качестве примера ниже приведен текст макроса MyWarning, который 
построен по принципу assert, но позволяет отобразить дополнительное переданное 
в него сообщение msg. Только обратите внимание на то, что директива, следующая 
после строки комментария, должна быть записана в тексте вашего модуля в одну 
строку, без переносов. В приведенном тексте переносы введены просто из-за того, 
что при печати книги она не может уместиться в одну строку. 

#ifdef NDEBUG 

#define MyWarning(p,msg) ( (void) 0) 

#else 

// следующая директива должна быть записана в одну строку 

#define MyWarning(p,msg) ((р) ?(void)0O : (ShowMessage( (msg) + 

", ("+AnsiString(#p)+")\ndaun " + AnsiString( FILE) + 
", строка" + IntToStr(_ LINE )))) 
#endif 
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Чтобы воспользоваться этим макросом в нашем примере, можете вставить в 
цикл оператор 


MyWarning(A < 1е300, "А = " +FloatToStr(A) +", i=" + 
IntTostreti) >); 


В момент, когда значение переменной A, превысит 10309, этот макрос выдаст 
сообщение вида, показанного на рис. 2.46. 


Рис. 2.46 
Сообщение вашего макроса MyWarning 


Если вы хотите не просто отобразить сообщение, но и завершить программу, 
проще объявить некоторую функцию, в вызов которой развертывать макрос. В ка- 
честве примера ниже приведен макрос и соответствующая функция, обеспечиваю- 
щие примерно те же возможности, что и рассмотренный выше макрос, но завер- 
шающие работу приложения. 


#ifdef NDEBUG 


#define MyAssert (p,msg) ( (void) 0) 

#else 

// следующая директива должна быть записана в одну строку 

#define MyAssert(p,msg) ((р) ?(void)0 
(FMyAssert((msg), FILE, LINE .))) 

#endif 


void FMyAssert (String msg, String sFile, int Line) 
{ 
ShowMessage ( (мза)+"\пфайл " + sFile + ", строка " + 
IntToStr (Line) ); 
abort (); 
} 


Вызов такого макроса MyAssert может выглядеть аналогично вызову преды- 
дущего макроса: 


MyAssert(A < 1е300, "А = " +FloatToStr(A) +", i = " + IntToStr(i)); 


Преимущество реализации отладок макросами заключается в том, что вы мо- 
жете вставить UX -BbISOBbI, которые выглядят весьма компактно, в различных час- 
тях своей программы. А когда все отладки закончены, можете отключить их все, 
введя в свой файл директиву 


#define NDEBUG 


Вы можете, конечно, обойтись и без макросов, введя в тех или иных местах 
программы операторы, обеспечивающие отладку. При этом целесообразно окру- 
жать эти операторы отладки следующими директивами: 

#ifndef NDEBUG 


операторы отладки 
#епа1 Ё 


Операторы отладки должны обеспечивать отладочную печать, которая помога- 
ет следить за ходом выполнения приложения. В C++Builder для отображения от- 
ладочной информации, на мой взгляд, удобен компонент ТМето — многострочное 
окно редактирования. В него можно заносить отладочные данные и тут же, во вре- 
мя выполнения приложения просматривать их. Чтобы этот компонент не занимал 
место на форме, его можно выводить в отдельное окно. Приведу без особых ком- 
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‘ментариев, как это можно было бы сделать в нашем тестовом примере, если бы нам 
вдруг для отладки захотелось наблюдать, как изменяются в цикле переменные. 


// форма отладочного окна 
TForm * FDebug; ' 
//компонент вывода в отладочном окне 
TMemo * Memol; 
7 оса '™“"™*$}-N-o—"-"-...”I”....”"_-_-_—_—_—_—_—_ 
void  fastcall TForml::FormCreate(TObject *Sender) 
{ 
#ifndef NDEBUG 
// создание отладочного окна и окна редактирования в нем 
FDebug = new TForm(Application) ; 
FDebug->Caption = "Отладка"; 
Memol = new TMemo (FDebug) ; 
Memol->Parent = FDebug; 
Memol->ScrollBars = ssVertical; 
Memol->Align = alClient; 
FDebug->Show (); 
#endif ; 
} 
2 nn en ee 
void _fastcall TForml::FormDestroy(TObject *Sender) 
{ 
#ifndef NDEBUG 
// освобождение памяти 
FDebug->Release (); 
#endif 
} / 
(Fearn nen == 
void _fastcall TForml::ButtonlClick(TObject *Sender) 
{ 
For tint 1. 0 <. 307 14%) 
{ 
A *= 10000; 
#ifndef NDEBUG 
//отладочная печать 


Memol->Lines->Add("A = "+FloatToStr(A)+", i="+IntToS§tr(i)); 
#endif 

} 

Labell->Caption = "A = " + FloatToStr (A); : 


} 


В этом коде прокомментировано все, относящееся к отладке. В обработчике со- 
бытия формы OnCreate создается окно отладки FDebug и в нем — окно редактиро- 
вания Memol. В цикл нашего примера вставлен вывод информации в это окно. В 
событии формы OnDestroy предусмотрено уничтожение отладочного окна. При- 
чем, все это делается только если не определен идентификатор NDEBUG. 

Попробуйте сделать в приложении указанные изменения и запустить его на 
выполнение. Вы увидите в процессе выполнения окно, показанное на рис. 2.47, в 
которое по мере работы приложения будут заноситься данные. Если бы это было 
какое-то сложное приложение, то вы непосредственно в процессе выполнения мог- 
ли бы просматривать эти данные и наблюдать за ходом работы. 

После того, как вы отладили приложение, вы можете легко удалить всю отла- 
дочную печать, введя директиву 


#define NDEBUG J 
Здесь, впрочем, надо сделать одно замечание. Сложное приложение, увы, не 


может быть сделано без ошибок. Ошибки могут проявляться иногда через месяцы 
и годы работы у пользователя в каких-то экзотических ситуациях, при каких-то 
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Рис. 2.47 
Окно отладки 


А = 1£100, 1=24 
А =1Е104, i=25 
14 =1Е108, i=26 
А = 1£112, 1=27 
[А = 1E116, i=28 


редких сочетаниях исходных данных или каких-то непредусмотренных действиях 
пользователя. Причем ошибки могут возникнуть на компьютере пользователя, 
где, естественно, нет ваших исходных файлов а, возможно, нет и C++Builder. В та- 
ких ситуациях могла бы помочь отладка проекта непосредственно на компьютере 
пользователя. Но при рассмотренных ранее подходах отладка в завершенном вы- 
полняемом модуле отсутствует. 

Исходя из этого я, например, предпочитаю в готовом приложении оставить не- 
которые возможности отладочной печати. Включать ее можно, например, создани- * 
ем в текущем каталоге текстового файла с условным именем Debug.txt. Тогда 
можно ввести в проект некоторую переменную debug, значение которой определя- 
ется наличием или отсутствием этого файла: 


bool debug = FileExists ("Debug.txt"); 


Тогда те отладки (конечно, немногочисленные), которые желательно оставить 
в приложении, могут выполняться по условному оператору 


if (debug) 


При нормальной работе, когда файла Debug.txt нет, никаких отладок He будет 
и пользователь даже не будет подозревать об их наличии в приложении. Но стоит 
любым текстовым редактором создать такой файл, и вы получаете возможность 
наблюдать за ходом выполнения приложения. Конечно, реально лучше этот меха- 
низм несколько усложнить, занося в файл Debug.txt, например, тот или иной уро- 
вень отладки, который может читаться приложением. Тогда, ничего не изменяя в 
самом приложении, можно управлять отладкой, делая ее более или менее подроб- 
ной. 
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Обзор компонентов 
библиотеки C++Builder 


3.1 Страницы палитры компонентов 


Палитра компонентов VCL — библиотеки визуальных компонентов C++Buil- 
der, имеет ряд страниц, на которых скомпонованы пиктограммы всех компонен- 
тов, предопределенных в C++Builder. Вы можете изменять компоновку страниц 
(см. раздел 14.2.2), а также добавлять новые страницы, вносить на страницы свои 
новые компоненты и шаблоны компонентов (см. главу 7). 

Предопределенные в C++Builder страницы палитры зависят от версии, с кото- 
рой вы работаете. По умолчанию в палитре C++Builder 5 имеются страницы: 


ЖИ С ИЯ 


Standard 


Additional 
Win32 
System 


Data Access 
Data Controls 
ADO 


Interbase 


Midas 


InternetExpress 


Internet 
FastNet 


Decision Cube 


Qreport 
Dialogs 


А SRR ate “ С seommeapanses - 


Стандартная, содержащая наиболее часто используемые KOM- 
поненты 


Sot 


Дополнительная, являющаяся дополнением стандартной 
32-битные компоненты в стиле Windows 95/98/2000 и NT 


Системная, содержащая такие компоненты, как таймеры, пле- 
еры и ряд других 


Доступ к данным через Borland Database Engine (BDE) 
Управление данными 


Связь с базами данных через Active Data Objects (ADO) — 
множество компонентов ActiveX, использующих для доступа к 
информации баз данных Microsoft OLEDB (только начиная с 
C++Builder 5) 


Прямая связь с Interbase, минуя Borland Database Engine 
(BDE) и Active Data Objects (ADO) (только начиная с C++Buil- 
der 5) 


Построение приложений баз данных с параллельными потока- 
ми (только в вариантах Client/Server и Enterprise и только на- 
чиная с C++Builder 4) 


Построение приложений InternetExpress — одновременно при- 
ложений сервера Web и клиента баз данных с параллельными 
потоками (только начиная с C++Builder 5) 


Компоненты для приложений, работающих с Интернет 


Различные протоколы доступа к Интернет (только начиная с 
C++Builder 5) 


Многомерный анализ данных (только в вариантах Client/Ser- 
ver и Enterprise) 


Быстрая подготовка отчетов 


Системные диалоги типа «Открыть файл» и др. 
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Win 3.1 Windows 3.x, компоненты в стиле Windows 3.x (оставлены для 
обратной совместимости) 


Servers Оболочки VCL для распространенных серверов СОМ (только 
начиная с C++Builder 5) 


Имеются еще две страницы, содержащие примеры: 


ИДИ АЛИ LE АКА ЗОВИ GSE PEELE RSLS ELE ESE ИКЕА ЛЕК OLE АЕ ОСН ль 


Samples Образцы: различные интересные, HO не до конца документиро- 
ванные компоненты 


ActiveX Примеры активных элементов ActiveX 


Примеры на страницах Samples и ActiveX не документированы в C++Builder и 
во встроенной справке сведения о них отсутствуют. Однако, исходные тексты при- 
меров со страницы Samples имеются в каталоге ...\EXAMPLES\CONTROLS\SOUR- 
СЕ. Вы можете их просмотреть и понять, как построены эти примеры и как ими 
пользоваться. 

Примеры со страницы ActiveX также не документированы. Ho если вы перене- 
сете соответствующий компонент на форму и щелкнете на нем правой кнопкой 
мыши, то BO всплывшем меню можете выбрать команду Property и некоторые дру- 
гие; которые отобразят диалоговые окна, помогающие задать необходимые свойст- 
ва компонента. 

Многие из компонентов страниц Samples и ActiveX надо рассматривать скорее 
именно как примеры создания компонентов. Их полезно изучить, но для практи- 
ческого использования в приложениях многие из них не очень приспособлены. 

Компоненты страницы Win 3.1 не рекомендуется использовать в 32-разрядных 
версиях Windows. Они предназначены для приложений, которые должны функ- 
ционировать в любой версии Windows, включая Windows 3.x. Для 32-разрядных 
приложений имеются аналоги большинства компонентов страницы Win 3.1, кото- 
рые приведены в таблице 3.1. 


Таблица 3.1. Соответствие компонентов страницы Win 3.1 
и новых 32-разрядных компонентов 


Компонент Win 3.1 Новый компонент Страница нового компонента 


Data Controls 
Win32 


|TabbedNoteBook | ___| PageControl 


В различных главах данной книги рассмотрено большинство компонентов 
библиотеки C++Builder. Исключение составляют страницы Internet, MIDAS, 
InternetExpress и FastNet, которые не рассматриваются просто из-за ограничения на 
объем книги. 


AF ye 5 


Обзор компонентов библиотеки C++Builde 129 


Все компоненты страниц Оса Access, Data Controls, ADO, Interbase, Decision Cube 
рассмотрены подробно в главах 9, 10, 11 и в данной главе не обсуждаются. Компо- 
ненты страницы ОКерой рассматриваются в главе 11 в разделе 11.2. Компоненты 
мультимедиа рассматриваются в главе 5 (раздел 5.2). Компоненты страницы 
Servers рассматриваются в главе 6 раздел 6.4.4 и в главе 11 раздел 11.3 

В справочной части книги в главе 14 приведен полный состав страниц палит- 
ры компонентов. Но в данном разделе мы будем рассматривать компоненты, ком- 
понуя их не по страницам, а по выполняемым функциям. При этом ограничимся 
только самым общим описанием и сравнением компонентов общего назначения, 
которые применяются в большинстве приложений. Более подробные сведения об 
этих и других компонентах вы почерпнете в последующих главах. 

К сожалению, объем данной книги не позволяет детально рассмотреть все 
функциональные особенности компонентов и привести достаточное количество 
примеров их использования. Значительно более развернутое изложение этих во- 
просов вы можете найти в книгах [2] и [3]. 


3.2 Компоненты ввода и отображения 
текстовой информации 


3.2.1 Перечень компонентов ввода и отображения текстовой 
информации 


В библиотеке визуальных компонентов C++Builder существует множество 
компонентов, позволяющих отображать, вводить и редактировать текстовую ин- 
формацию. В таблице 3.2 приведен их перечень для C++Builder 5 с краткими ха- 
рактеристиками и указанием основных параметров, содержащих отображаемый 
или вводимый текст. В этой таблице не указаны аналогичные элементы отображе- 
ния и редактирования текстов, содержащихся в базах данных, так как они будут 
рассмотрены отдельно в главах 9 и 10. 


| Пиктог- | Компонент | Страница |Описание 
| рамма 


Label (метка) | Standard Отображение текста, который не изме- 
няется пользователем. Никакого оформ- 
ления текста не предусмотрено, кроме 
цвета метки и текста. Основное свойст- 
во — Caption. 


StaticText Additional Подобен компоненту Label, но обеспечи- 
(метка с бор- вает возможность задания стиля бордю- 
дюром) ра. Основное свойство — Caption. 


Таблица 3.2. Компоненты ввода и отображения текстовой информации 


Panel (панель) | Standard Компонент является контейнером для 
группирования органов управления, но 
может использоваться и для отображе- 
ния текста с возможностями объемного 
оформления. Основное свойство — Сар- 
tion. 
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| Пиктог- 
рамма 


Компонент Страница '|Описание 


Edit _ | Standard 
(окно редакти- 
рования) — 


MaskEdit Additional 


(окно маскиро- 
Standard 


ванного редак- 

Win32 Компонент представляет собой окно pe- 
дактирования в стиле Windows в обога- 
щенном формате RTF, позволяющее 
производить выбор атрибутов шрифта, 
поиск текста и многое другое. Основное 


Отображение, ввод и редактирование од- 
нострочных текстов. Имеется возмож- 
ность оформления объемного бордюра. 
Основное свойство — Text. 


Используется для форматирования дан- 
ных или для ввода символов в соответ- 
ствии с шаблоном. Основные свойства — 
Text и EditText. 


Отображение, ввод и редактирование 
многострочных текстов. Имеется воз- 
можность оформления объемного бордю- 
ра. Основное свойство — Lines. 


тирования) 


Мето 
(многострочное 
окно редакти- 

рования) 


RichEdit 
(многострочное 
окно редакти- 


рования в фор- 
мате RTF) 


свойство — Lines. 


Standard Отображение стандартного окна списка 
Windows, позволяющего пользователю 
выбирать из него пункты. Основное 
свойство — Items. 

Additional 

ComboBox (pe- | Standard 

дактируемый 

список) 


StringGrid Additional Отображения текстовой информации в 

(таблица таблице из строк и столбцов с возмож- 

строк) ностью перемещаться по строкам и 
столбцам и осуществлять выбор. Основ- 


ное свойство — Cells. 


ListBox 
(окно списка) 


CheckListBox 
(список с ин- 
дикаторами) 


Компонент является комбинацией спис- 
ка ListBox и индикаторов CheckBox. 


Объединяет функции ListBox и Edit. 
Пользователь может либо ввести текст, 
либо выбрать его из списка. Основное 

свойство — Items. 


Помимо перечисленных компонентов отображать текстовые надписи можно 
непосредственно на свойстве Canvas (холст) любого компонента, имеющего это 
свойство, в частности, непосредственно на форме (см. раздел 5.1.3). Например, 
оператор вида 


Canvas.TextOut (60,16, 'Canvas'"); 


обеспечивает печать, начиная с точки с координатами (60, 16), текста « Canvas ». 
Но это неудобно, так как при этом теряются преимущества визуального проекти- 
рования и приходится рассчитывать координаты размещения надписи. 

Во всех компонентах шрифт текста, его размер, стиль (жирный, курсив и 
т.п.), цвет определяются свойством Font, которое имеет множество подсвойств, ус- 
танавливаемых в процессе проектирования или программно во время выполнения 
приложения. 
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3.2.2 Отображение текста в надписях компонентов Label, 
StaticText, Panel 


Для отображения различных надписей Ha форме используются в основном 
компоненты Label, StaticText и Panel. Первые два из этих компонентов — метки, 
специально предназначенные для отображения текстов. Основное назначение па- 
нели Panel другое: компоновка компонентов в окне формы. Однако, панель можно 
использовать и для вывода текстов. 

Примеры вывода текста в метки приведены на рис. 3.1. Вид панелей Рапе] вы 
можете увидеть на рис. 3.38 в разделе 3.7.2. 


Рис. 3.1 а) сть Label 3 РГ] x} 


| Е `Абоп=аП ор. Alignmetn=taCenter 
Примеры вывода текста в компоненты Label (а) и oa “Align op. AgrmetostaCenter Color=clWhite 
StaticText (6) ee aS 


Align-alNone, Color-cWhite 


WordW Jail aise. ! WordW pues : 
AutoSize=false 


Я, Метки StaticT ext 
г. bor мес он 


: . оф] | Gordes Siyle=sbaSingle ae 


ne iasdess iglesseSnken в пм теч ти 


oS Alignelalenn: 
 .. AutoSize=false. 
ча 


Тексты, отображаемые в перечисленных компонентах, определяются значени- 
ем их свойства Caption. Его можно устанавливать в процессе проектирования или 
задавать и изменять программно во время выполнения приложения. Например: 


Labell->Caption = "Новый текст"; 


Свойство Caption имеет тип строки AnsiString (см. соответствующий раз- 
дел главы 16). При присваивании этому типу числовой информации происходит ее 
автоматическое преобразование в строку. Поэтому вы можете непосредственно осу- 
ществлять подобные присваивания. Например, оператор 


Labell->Caption =. 5.1; 


приведет к появлению в метке надписи «5,1». Но если вы хотите занести в метку 
смешанную информацию, состоящюю из строк символов и чисел, вы должны вос- 
пользоваться функциями FloatToStr и IntToStr, переводящими соответственно 
числа с плавающей запятой и целые в строку. Для формирования текста, состоя- 
щего из нескольких фрагментов, можно использовать операцию «+», которая для 
строк означает их склеивание (конкатенацию). Например, если в программе име- 
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ется целая переменная I, отображающая число сотрудников некоторой организа- 
ции, то вывести в метку Labell информацию 06 этом можно оператором: 


Labell->Caption = "Число сотрудников: "+IntToStr(I); 


Во всех компонентах цвет фона определяется свойством Color, а цвет надпи- 
си — подсвойством Color свойства Font. Например, в большинстве меток (кроме 
верхней) на рис. 3.1 аи в правых метках на рис. 3.1 6 задан цвет фона clWhite — 
белый. Если цвет специально не задавать, то цвет фона обычно сливается с цветом 
контейнера, содержащего метку, так что фон просто не заметен. 

Для метки Label цвет и шрифт — единственно доступные элементы оформле- 
ния надписи. Компоненты StaticText и Panel имеют кроме того свойство 
BorderStyle, определяющее рамку текста — бордюр. На рис. 3.1 6 вы можете ви- 
деть влияние бордюра на вид метки StaticText. При стиле sbsNone метка 
StaticText по виду не отличается от метки Label. Вероятно, если уж использовать 
бордюр, то наиболее приятный стиль $655 ипКеп. 

Компонент Panel кроме свойства BorderStyle имеет еще свойства ВеуеПппег, 
BevelOuter, BevelWidth, BorderWidth, которые предоставляют богатые возмож- 
ности оформления надписи, как вы можете увидеть на рис. 3.38 в разделе 3.7.2. 
Таким образом, с точки зрения оформления выводимого текста максимальные воз- 
можности дает Panel и минимальные — Label. 

Размещение всех рассматриваемых компонентов на форме определяется, в част- 
ности, свойствами Тор, Left, Height, Width, Aline, общими для всех оконных компо- 
нентов. Эти свойства, определяющие координаты компонента, его размеры и их из- 
менение при изменении пользователем размеров родительского компонента, под- 
робно рассмотрены в разделе 4.2. Так что не будем здесь на этом останавливаться. 

Размер меток Label и StaticText определяется также свойством AutoSize. 
Если это свойство установлено в true, то вертикальный и горизонтальный размеры 
компонента определяются размером надписи. Если же AutoSize равно false, то вы- 
равнивание текста внутри компонента определяется свойством Alignment, которое 
позволяет выравнивать текст по левому краю, правому краю или центру клиент- 
ской области метки. В панели Panel также имеется свойство AutoSize, но оно не 
относится к размерам надписи Caption. Однако, свойство выравнивания 
Alignment работает и для панели. 

В метке Label имеется свойство WordWrap — допустимость переноса слов 
длинной надписи, превышающей длину компонента, на новую строчку. Чтобы та- 
кой перенос мог осуществляться, надо установить свойство WordWrap в true, 
свойство AutoSize в false (чтобы размер компонента не определялся размером над- 
писи) и сделать высоту компонента такой, чтобы в нем могло поместиться несколь- 
ко строк (см. пример правой нижней метки на рис. 3.1 a). Если WordWrap не уста- 
новлено в true при AutoSize равном false, то длинный текст, не помещающийся в 
рамке.метки, просто обрезается (см. пример левой нижней метки Ha рис. 3.1 а). 

В метке StaticText перенос длинного текста осуществляется автоматически, 
если значение AutoSize установлено в false и размер компонента достаточен для 
размещения нескольких строк. Для того, чтобы в StaticText осуществлялся пере- 
нос при изменении пользователем размеров окна, надо осуществлять описанную 
выше перерисовку компонента методом Repaint в обработчике события формы 
OnResize. 

В панели размещение надписи в нескольких строках невозможно. 

Можно отметить еще одно свойство меток Label и StaticText, превращающее 
их в некоторое подобие управляющих элементов. Это свойство FocusControl — фо- 
кусируемый компонент. Если в свойстве метки Caption поместить перед одним из 
символов символ амперсант «&», то символ, перед которым поставлен амперсант, 
отображается в надписи метки подчеркнутым (сам амперсант вообще не отобража- 
ется). Если после этого обратиться к свойству метки FocusControl, то из выпадаю- 
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щего списка можно выбрать элемент, на который будет переключаться фокус, если 
пользователь нажмет клавиши ускоренного доступа: клавишу Alt + подчеркнутый 
символ. Подобные клавиши ускоренного доступа предусмотрены в управляющих 
элементах: разделах меню и кнопках. Благодаря свойству FocusControl метки мо- 
гут обеспечить клавишами ускоренного доступа иные элементы, например, окна 
редактирования (см. раздел 3.2.3), в которых такие клавиши не предусмотрены. 
Только для того, чтобы клавиши ускоренного доступа в метках срабатывали, необ- 
ходимо установить свойство ShowAccelChar этих меток в true. 

Для отображение текстовой информации, и даже с дополнительной возможно- 
стью прокрутки длинных текстов, можно использовать также окна редактирова- 
ния Edit и MaskEdit (см. раздел 3.2.3) в режиме ReadOnly. 


3.2.3 Окна редактирования Edit и MaskEdit 


На рис. 3.2 вы можете увидеть примеры окон редактирования. Внешнее 
оформление окон редактирования определяется свойством BorderStyle, влияние 
которого на вид компонента вы можете увидеть на том же рисунке. 


Рис. 3.2 
Примеры окон редактирования 


С 
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В компонентах Edit и MaskEdit вводимый и выводимый текст содержится в 
свойстве Text типа AnsiString. Это свойство можно устанавливать в процессе про- 
ектирования или задавать программно. Выравнивание текста, как это имело место 
в метках и панелях, невозможно. Перенос строк тоже невозможен. Текст, не поме- 
щающийся по длине в окно, просто сдвигается и пользователь может перемещать- 
ся по нему с помощью курсора. Свойство AutoSize в окнах редактирования имеет 
смысл, отличный от смысла аналогичного свойства меток: автоматически под- 
страивается под размер текста только высота, но не ширина окна. 

Окна редактирования снабжены многими функциями, свойственными боль- 
шинству редакторов. Например, в них предусмотрены типичные комбинации «го- 
рячих» клавиш: Ctrl-C — копирование выделенного текста в буфер обмена 
Clipboard (команда Copy), Ctrl-X — вырезание выделенного текста в буфер Clipboard 
(команда Cut), Ctrl-V — вставка текста из буфера Clipboard в позицию курсора (ко- 
манда Paste), Ctrl-Z — отмена последней команды редактирования. Правда, пользо- 
ватели часто не догадываются об этих возможностях редактирования. Так что по- 
лезно напоминать им OO этом соответствующими подсказками. 

Свойство AutoSelect определяет, будет ли автоматически выделяться весь 
текст при передаче фокуса в окно редактирования. Его имеет смысл задавать рав- 
ным true в случаях, когда при переключении в данное окно пользователь будет ве- 
роятнее всего будет заменять текущий текст, а не исправлять его. Имеются также 
свойства только времени выполнения SelLength, SelStart, SelText, определяю- 
щие соответственно длину выделенного текста, позицию перед первым символом 
выделенного текста и сам выделенный текст. Например, если в окне имеется текст 
«выделение текста» и в нем пользователь выделил слово «текста», то SelLength = 
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6, SelStart = 10 и SelText = «текста». Если выделенного текста нет, то свойство 
SelStart просто определяет текущее положение курсора. 

Окна редактирования можно использовать и просто как компоненты отобра- 
жения текста. Для этого надо установить в true их свойство ReadOnly и целесооб- 
разно установить AutoSelect в false. В этом случае пользователь не сможет изме- 
нять отображаемый текст и окно редактирования становится подобным меткам, 
рассмотренным в разделе 3.2.2. Но имеются и определенные отличия. Во-первых, 
окна редактирования оформлены несколько иначе (сравните рис. 3.1 и 3.2.). А 
главное — окна редактирования могут вмещать текст, превышающий их длину. В 
этом случае пользователь может прокручивать текст, перемещая курсор в окне. 
Такими особенностями не обладает ни одна метка. 

Свойство Text окон редактирования имеет тип строки AnsiString (cM. соответ- 
ствующий раздел главы 16). При присваивании этому типу числовой информации 
происходит ее автоматическое преобразование в строку. Поэтому вы можете непо- 
средственно осуществлять подобные присваивания. Например, оператор 


Editii->Text = 5. / 2; 


будет воспринят компилятором нормально и приведет к появлению в окне текста 
«2,5». Но при вводе из окна числовой информации надо использовать функции 
StrToFloat — преобразование строки в значение с плавающей запятой, и StrToInt 
— преобразование строки в целое значение. Если вводимый текст не соответствует 
числу (например, содержит недопустимые символы), то функции преобразования 
генерируют исключение EConvertError (см. раздел 12.10 главы 12). Поэтому в 
программе необходимо предусмотреть обработку этого исключения. Например: 


int A; 
try 
{ 


А = StrToInt (Edit1l->Text) ; 
} 


catch (EConvertError&) 


{ 


ShowMessage ("Вы ввели ошибочное число; повторите ввод"); 


} 


Этот код обеспечивает сообщение пользователю об ошибке ввода и предотвра- 
щает ошибочные вычисления. Впрочем, это не лучший вариант предотвратить 
ошибочный ввод, поскольку пользователь узнает о своей ошибке только после 
того, как программа пытается использовать введенные данные. В разделе 3.3 опи- 
саны специализированные компоненты ввода цифровых данных, которые лучше 
использовать для ввода чисел. Впрочем, и окно Edit можно спроектировать так, 
что пользователь просто не сможет ввести в него неправильные символы. В главе 4 
в разделе 4.3.2 показано, как программно обеспечить, чтобы в окне редактирова- 
ния пользователь, например, мог вводить только цифры или наоборот — мог вво- 
дить символы и не мог вводить числа. В главе 7 в разделе 7.3 рассмотрено, как на 
основе окна Edit можно сделать свой собственный компонент, обладающий этими 
свойствами. 

Свойство MaxLength определяет максимальную длину вводимого текста. Если 
MaxLength = 0, то длина текста не ограничена. В противном случае значение 
MaxLength указывает максимальное число символов, которое может ввести поль- 
зователь. 

Свойство Modified, доступное только во время выполнения, показывает, про- 
водилось ли редактирование текста в окне. Если вы хотите использовать это свой- 
ство, то в момент начала работы пользователя с текстом Modified надо установить 
в false. Тогда при последующем обращении к этому свойству можно по его значе- 
нию (true или false) установить, было или не было произведено редактирование. 
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Свойство PasswordChar позволяет превращать окно редактирования в окно 
ввода пароля. По умолчанию значение PasswordChar равно "#0" — нулевому сим- 
волу. В этом случае это обычное окно редактирования. Но если в свойстве указать 
иной символ (например, символ звездочки "*"), то при вводе пользователем текста 
в окне будут появляться именно эти символы, а не Te, которые вводит пользова- 
тель (см. рис. 3.2). Тем самым обеспечивается секретность ввода пароля. 

Различные аспекты методики работы с окнами редактирования Edit будут еще 
неоднократно рассматриваться на протяжении этой книги (см. разделы 4.1.8 и 
4.3.2.2 главы 4, раздел 7.3 главы 7 и др). Вернемся мы к работе с окном редактиро- 
вания и в данной главе. В разделе 3.7.8 будет рассказано, как добиться того, что 
если в окне записан длинный текст, который не виден целиком, то при задержке 
над этим окном курсора мыши ‘появляется ROMA EATER ярлычок, содержащий 
полный текст окна. 


Компонент MaskEdit отличается от Edit тем, что в нем можно задать строку 
маски в свойстве EditMask. Это позволяет обеспечить синтаксически безошибоч- 
ный ввод пользователем таких данных, как номера телефонов, паспортные дан- 
ные, адреса, даты, время и т.п. Маска состоит из трех разделов, между которыми 
ставится точка с запятой «;». В первом разделе — шаблоне записываются специ- 
альным образом символы (см. таблицу 3.3), которые можно вводить в каждой по- 
зиции, и символы, добавляемые самой маской; во втором разделе записывается 1 
или 0 в зависимости от того, надо или нет, чтобы символы, добавляемые маской, 
включались в свойство Text компонента; в третьем разделе указывается символ, 
используемый для обозначения позиций, в которых еще не осуществлен ввод. Про- 
читать результат ввода можно или в свойстве Text, которое в зависимости OT вида 
второго раздела маски включает или не включает в себя символы маски, или в 
свойстве EditText, содержащем введенный текст вместе с символами маски. 


Таблица 3.3. Символы шаблона маски 


ИИ КА АХ ААА АЕ ИИС HOTS OOE 


Е Наличие символа «!» означает, что в EditText недостающие символы пред- 
варяются пробелами, а отсутствие символа «!» означает, что пробелы раз- 


мещаются в конце 
> Символ «>» означает, что все последующие за ним символы должны вво- 


диться в верхнем регистре, пока не кончится маска или пока не встретит- 
СЯ СИМВОЛ «<» 


а SEE LBL SLE LEEREEENSE EASES АНИ ный 


< Символ «<» означает, что все последующие за ним символы должны вво- 
диться в нижнем регистре, пока не кончится маска или пока не встретит- 
СЯ СИМВОЛ «>» 


<> Символы «<>» означают, что анализ регистра не производится 


\ Символ «\» означает, что следующий за ним символ является буквенным, 
а не специальным, характерным для маски. Например, символ «>» после 
символа «\» воспримется как знак > (больше), а не как символ, указываю- 
щий на верхний регистр 


L Символ «L» означает, что в данной позиции должна быть буква 


] Символ «|» означает, что в данной позиции может быть только буква или 
ничего 


А — Символ «А» означает, что в данной позиции должна быть буква или цифра 


а Символ «a» означает, что в данной позиции может быть буква, или цифра, 
или ничего 
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С Символ «С» означает, что в данной позиции должен быть любой символ 


с Символ «с» означает, что в данной позиции может быть любой символ или 
ничего 


0 Символ «0» означает, что в данной позиции должна быть цифра 


2 


Символ «9» означает, что в данной позиции может быть цифра или ничего 


# Символ «#» означает, что в данной позиции может быть цифра, знак «+», 
знак «-» или ничего 


Символ «:» используется для разделения часов, минут и секунд 
/ Символ «/» используется для разделения месяцев, дней и годов в датах 


Символ «_» означает автоматическую вставку в текст пробела 


Вводить маску можно непосредственно в свойство EditMask. Но удобнее поль- 
зоваться специальным редактором масок, вызываемым при нажатии кнопки с 
многоточием в строке свойства EditMask в Инспекторе Объектов. Окно редактора 
масок имеет вид, представленный на рис. 3.3 (на рисунке изображены маски фай- 
ла российского шаблона, описанного далее). 


Рис. 3.3 Mask Editor 
Окно редактора масок с nput Mas 
загруженным файлом 1\(998\) 000-00-00:1 


российских стандартных масок 


Дата без указания дня 


Время с секундами 
Время без секунд 


В редакторе масок окно Sample Masks содержит наименования стандартных ма- 
сок и примеры ввода с их помощью. В окно Input Mask надо ввести маску. Если вы 
выбираете одну из стандартных масок, то окно Input Mask автоматически заполня- 
ется и вы можете, если хотите, отредактировать эту маску. 

Окно Character for Blanks определяет символ, используемый для обозначения 
позиций, в которых еще не осуществлен ввод (третий раздел маски). Индикатор 
Save Literal Characters определяет второй раздел маски: установлен, если второй раз- 
дел равен 1, и не установлен, если второй раздел равен 0. 

Кнопка Masks позволяет выбрать и загрузить какой-либо другой файл стан- 
дартных масок. К сожалению, среди файлов стандартных масок, поставляемых с 
C++Builder, отсутствует маска, соответствующая российским стандартам. Но вы 
легко можете сами сделать себе такой файл стандартных масок. Он делается в 
обычном текстовом редакторе и должен сохраняться как «только текст» с расши- 
рением .dem. Чтобы редактор масок C++Builder видел этот файл, его надо сохра- 
нить в каталоге C++Builder BIN. Каждая строка файла состоит из трех частей, раз- 
деляемых символом вертикальной черты. Первая часть состоит из пояснительного 
текста, появляющегося в левой панели окна Sample Masks редактора масок. Вторая 
часть — пример, который появляется в правой панели окна Sample Masks редактора 
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масок. А третья часть — сама маска. Например, я сделал себе файл с текстом, при- 
веденным ниже, и сохранил его с именем ru.dem. 

Телефон | 5551212 | !000-00-00;0; __ 

Телефон с кодом страны | 0955551212 | !\(999\) 000-00-00;0;_ 

Почтовый индекс | 123456 | !0000000;1; _ 

Паспорт| \11123456 | !L-LL 999999;0; | 

Дата с указанием дня | 270694 | !99/99/00;1; _ 

Дата без указания дня | 0694 | !99/00;1;_ 

Время с секундами | 210515 | 1!90:00:00;1;_ 

Время без секунд | 1345 | !90:00;1; _ 


На рис. 3.3 вы можете видеть его в работе, а на рис. 3.2 вы можете видеть ввод 
в окна с масками телефона и даты. 

Рассмотрим примеры масок. В приведенном выше файле маска для ввода HO- 
мера телефона имеет вид: 


1\(999\) 009-00-00;0;-. 


В этой маске символ «9» означает, что в соответствующей позиции может 
быть только цифра. Символ «0» означает, что в данной позиции должна быть циф- 
ра. Символ подчеркивания в конце маски будет заполнять пустые позиции. Таким 
образом, пользователю для ввода в окне будет отображен шаблон (см. рис. 3.2): 


(Fr 


Поскольку второй раздел маски равен 0, то при чтении введенных пользовате- 
лем значений свойства EditText и Text будут различаться. Свойство EditText для 
примера рис. 3.2 будет равно «(095) 123-45-67», а свойство Text будет равно 
«0951234567». Если второй раздел маски сделать равным 1, то значения обоих 
свойств будут равны «(095) 123-45-67». 

Рассмотрим еще пример. Если с помощью EditMask надо ввести, например, 
целое число без знака, состоящее не более, чем из двух цифр, можно задать маску 
«99;0;». Если число обязательно должно быть двузначным, то маска должна иметь 
вид «00;0;». 


3.2.4 Многострочные окна редактирования Memo и RichEdit 


Компоненты Memo и RichEdit (см. пример на рис. 3.4) являются окнами ре- 
дактирования многострочного текста. Они так же, как и окно Edit, снабжены мно- 
гими функциями, свойственными большинству редакторов. В них предусмотрены 
типичные комбинации «горячих» клавиш: Ctrl-C — копирование выделенного тек- 
ста в буфер обмена Clipboard (команда Copy), Ctrl-X — вырезание выделенного тек- 
ста в буфер Clipboard (команда Cut), Ctrl-V — вставка текста из буфера Clipboard в 
позицию курсора (команда Paste), Ctrl-Z — отмена последней команды редактирова- 
ния. 

В компоненте Мето формат (шрифт, его атрибуты, выравнивание) одинаков 
для всего текста и определяется свойством Font. Если вы сохраните в файле текст, 
введенный или отредактированный пользователем, то будет создан текстовый 
файл, содержащий только символы и не содержащий элементов форматирования. 
При последующем чтении этого файла в Мето формат будет определяться теку- 
щим состоянием свойства Font компонента Memo, а не тем, в каком формате ранее 
вводился текст. 

Компонент RichEdit работает с текстом в обогащенном формате RTF. При же- 
лании изменить атрибуты вновь вводимого фрагмента текста вы можете задать 
свойство SelAttributes. Это свойство типа TTextAttributes, которое в свою очередь 
имеет подсвойства: Color (цвет), Name (имя шрифта), Size (размер), Style (стиль) и 
ряд других. Например, введите на форму компонент RichEdit, диалог выбора 
шрифта FontDialog со страницы Dialogs (см. подробнее в разделе 3.8.4) и кнопку 
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Puc. 3.4 
Примеры компонентов Memo и RichEdit 


ee RichEdit 
Это текст. a Это текст, 


т. занесенный в окно. занесенный 


В ОКНО. 


Button, которая позволит пользователю менять атрибуты текста. В обработчик 
щелчка кнопки введите текст: 


if (FontDialogl->Execute () ) 
RichEdit1->SelAttributes->Assign (FontDialogl->Font) ; 
RichEdit1->SetFocus(); 


Запустите приложение и увидите, что вы можете менять атрибуты текста, вы- 
полняя отдельные фрагменты различными шрифтами, размерами, цветами, сти- 
лями. Устанавливаемые атрибуты влияют на выделенный текст или, если ничего 
не выделено, то на атрибуты нового текста, вводимого начиная с текущей позиции 
курсора (позиция курсора определяется свойством SelStart). 

В компоненте имеется также свойство DefAttributes, содержащее атрибуты по 
умолчанию. Эти атрибуты действуют до того момента, когда изменяются атрибуты 
в свойстве SelAttributes. Но значения атрибутов в DefAttributes сохраняются и в 
любой момент эти значения могут быть методом Assign присвоены атрибутам 
свойства SelAttributes, чтобы вернуться к прежнему стилю. 

Свойство DefAttributes доступно только во время выполнения. Поэтому ero 
атрибуты при необходимости можно задавать, например, в обработчике события 
OnCreate. 

За выравнивание, отступы и т.д. в пределах текущего абзаца отвечает свойст- 
во Paragraph типа TParaAttributes. Этот тип в свою очередь имеет ряд свойств: 


ЗВАНИЯ SERRE ERE TI ЕН НИНЕ OES TE OT CE RE EOL TERI BIE BE ELE ESERIES LEI LO GLE TES CO NI LE LILES LICL LEE LE LEE IN ERIE 


Alignment Определяет ВырАВНИЗАНИЕ TeKATA. Может принимать значения 
| taLeftJustify (влево), taCenter (по центру) или taRightJustify 
(вправо) 


FirstIndent Число пикселей отступа красной строки 


Numbering Управляет вставкой маркеров, как в списках. Может принимать 
значения пзМопе — отсутствие маркеров, nsBullet — маркеры 
ставятся 


LeftIndent Отступ в пикселях OT левого поля 
RightIndent Отступ в пикселях от правого поля 
TabCount Количество позиций табуляции 


Tab Значения позиций табуляции в пикселях 


Значения подсвойств свойства Paragraph можно задавать только в процессе 
выполнения приложения, например, в событии создания формы или при нажатии 
какой-нибудь кнопки. Значения подсвойств свойства Paragraph относятся к тому 
абзацу, в котором находится курсор. Например, каждый из следующих операторов 
осуществит соответственное выравнивание текущего абзаца: 
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RichEdit1->Paragraph->Alignment = taLeftJustify; // Влево 
RichEdit1->Paragraph->Alignment taCenter; // По центру 
RichEdit1->Paragraph->Alignment taRightJustify; // Вправо 


Следующий оператор приведет к тому, что текущий абзац будет отображаться 
как список, т.е. с маркерами: 


RichEdit1->Paragraph->Numbering = nsBullet; 


Уничтожение списка в текущем абзаце осуществляется оператором 
RichEdit1l->Paragraph->Numbering = nsNone; 


В целом, если с помощью компонента ActionList (см. раздел 3.9.1) определено 
некоторое действие ввода и уничтожения списка, названное ABullet, то операторы 
обработки соответствующего действия могут иметь вид: 

if (ABullet->Checked) 

RichEdit1l->Paragraph->Numbering = nsBullet; 


else RichEdit1l->Paragraph->Numbering = nsNone; 
ABullet->Checked = ! ABullet->Checked; 


Они обеспечивают переключение соответствующей быстрой кнопки и раздела 
меню из нажатого состояния (отмеченного) в ненажатое с соответствующим изме- 
нением вида текущего абзаца. 

На рис. 3.5 приведен пример текстового редактора, использующего описанные 
выше свойства компонента RichEdit. Текст в окне редактора частично поясняет ат- 
рибуты шрифта, использованные при его написании. 

Свойства TabCount и Tab имеют смысл при вводе текста только при значении 
свойства компонента WantTabs = true. Это свойство разрешает пользователю вво- 
дить в текст символ табуляции. Если WantTabs = false, то нажатие пользователем 
клавиши табуляции просто переключит фокус на очередной компонент и символ 
табуляции в текст не введется. 

Мы рассмотрели основные отличия Memo и Richkdit. Теперь остановимся на 
общих свойствах этих окон редактирования. 

Свойства Alignment и WordWrap имеют тот же смысл, что, например, в мет- 
ках, и определяют выравнивание текста и допустимость переноса длинных строк. 
Установка свойства ReadOnly в true задает текст только для чтения. Свойство 
MaxLength определяет максимальную длину вводимого текста. Если Max- 
Length = 0, то длина текста не ограничена. Свойства WantReturns и WantTab 
определяют допустимость ввода пользователем в текст символов перевода строки 
и табуляции. | 

Свойство ScrollBars определяет наличие полос прокрутки текста в окне. По 
умолчанию ScrollBars = ssNone, что означает их отсутствие. Пользователь может 
в этом случае перемещаться по тексту только с помощью курсора. Можно задать 


Рис. 3.5 
Пример редактора на основе 
компонента RichEdit 


сай текст, введенный в компонент 
RichEdit 


| В первом абзаце: 
®* Sebsttributes. Siz = 10 


\* Faragraph Ahgnment= taCenter 
1B слове RichEdit Seétéintutes. Stpfe = [Во] 


1B строках 4 и5 Aavragraph Numbenng = nsBullet 
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свойству ЭсгоНВаг$ значения ssHorizontal, ssVertical или ssBoth, что будет соот- 
ветственно означать наличие горизонтальной, вертикальной или обеих полос про- 
крутки. 

Основное свойство окон Memo и RichEdit — Lines, содержащее текст окна в 
виде списка строк и имеющее тип TStrings. Начальное значение текста можно ус- 
тановить в процессе проектирования, нажав кнопку с многоточием около свойства 
Lines в окне Инспектора Объектов. Перед вами откроется окно редактирования 
списков строк, представленное на рис. 3.6. Вы можете редактировать или вводить 
текст непосредственно в этом окне, или нажать кнопку CodeEditor и работать в 
обычном окне Редактора Кода. В этом случае, завершив работу с текстом, выбери- 
те из контекстного меню, всплывающего при щелчке правой кнопкой мыши, ко- 
манду Close Page и ответьте утвердительно на вопрос, хотите ли вы сохранить 
текст в соответствующем свойстве окна редактирования. 


Рис. 3.6 бита List editor x! 


Окно редактирования списков строк 


энесенный в окно. 


Во время выполнения приложения вы можете заносить текст в окно редакти- 
рования с помощью методов свойства Lines типа TStrings. Этот тип широко ис- 
пользуется в свойствах многих компонентов и его подробное описание вы можете 
найти в разделе 16.4 главы 16. Здесь коротко укажем только на его основные свой- 
ства и методы, используемые в свойстве Lines. 

Весь текст, представленный одной строкой Tuna String, внутри которой ис- 
пользуются разделители типа символов возврата каретки и перевода строки, со- 
держится в свойстве Text. 

Доступ к отдельной строке текста вы можете получить с помощью свойства 
AnsiString Strings[int Index]. Индексы, как и везде в C++Builder, начинаются с 0. 
Так что Memol->Lines->Strings[0] — это текст первой строки. Учтите, что если 
окно редактирования изменяется в размерах при работе с приложением и свойство 
WordWrap = true, то индексы строк будут изменяться при переносах строк, так 
что в этих случаях индекс мало о чем говорит. 

Свойство только для чтения Count указывает число строк в тексте. 

Для очистки текста в окне надо выполнить процедуру Clear. Этот метод отно- 
сится к самому окну, а не к его свойству Lines. 

Для занесения новой строки в конец текста окна редактирования можно вос- 
пользоваться методами Add или Append свойства Lines. Для загрузки текста из 
файла применяется метод LoadFromFile. Сохранение текста в файле осуществля- 
ется методом SaveToFile. 

Пусть, например, в вашем приложении имеется окно редактирования Editl, в 
котором пользователь вводит имя сотрудника, и есть кнопка, при щелчке на кото- 
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рой в окно Memol должна занестись шапка характеристики этого сотрудника, по- 
сле чего пользователь может заполнить текст характеристики. 
Обработчик щелчка на кнопке может иметь вид: 


Мемо1->С1еаг(); 

Мепо1->Г1пез->Ааа ("ХАРАКТЕРИСТИКА"); 
Мемо1->1пез->Ааа ("Сотрудник "+Editl->Text) ; 
Memol->SetFocus (); 


В компоненте RichEdit тот же фрагмент может выглядеть иначе. Можно, на- 
пример, строки «Характеристика» и «Сотрудник...» выделить жирным шрифтом 
и выровнять по центру, после чего вернуться к стилю по умолчанию. Код, выпол- 
няющий подобные операции, может иметь вид: 


RichEdit1l->Clear () ; 

/* установка выравнивания по центру */ 
RichEdit1->Paragraph->Alignment = taCenter; 

/* установка жирного шрифта */ 
RichEdit1->SelAttributes->Style = 
RichEdit1l->SelAttributes->Style << fsBold; 
RichEditl->Lines->Add("X A PAK TEPAUACTA K A"); 
В1спЕа1{1->Г1пе$->Аада ("Сотрудник "+Editl->Text) ; 

/* восстановление атрибутов по умолчанию */ 
RichEditl->SelAttributes -> Аз$1ап (В1срЕа11->реЕАЕсг1раеез); 
/* установка выравнивания по левому краю */ 
RichEdit1l->Paragraph->Alignment = taLeftJustify; 
RichEdit1->SetFocus(); 


Загрузка в окно RichEditl текста из файла (например, хранящейся в файле 
характеристики сотрудника) может осуществляться командой 


RichEditl->Lines->LoadFromFile ("text.rtf"); 


Сохранение текста в файле может осуществляться командой 
RichEdit1l->Lines->SaveToFile ("text.rtf"); 


Свойство SelStart компонентов Memo и RichEdit указывает позицию курсора 
в тексте или начало выделенного пользователем текста. Свойство Саге Роз указы- 
вает на структуру, поле Х которой содержит индекс символа в строке, перед кото- 
рым расположен курсор, а поле У — индекс строки, в которой находится курсор. 
Таким образом, учитывая, что индексы начинаются с 0, значения RichEdit1->Ca- 
retPos.y + 1 u В1леВЕЯИ1->Саге{Роз.х + 1 определяют соответственно номер строки 
и символа в ней, перед которым расположен курсор. В редакторе на рис. 3.5 имен- 
но эти значения использованы, чтобы отображать в полосе состояния (см. раз- 
дел 3.7.7) позицию курсора. 


3.2.5 Компоненты выбора из списков — 
ListBox, CheckListBox, ComboBox 


Пример компонентов ListBox, CheckListBox, ComboBox, обеспечивающих вы- 
бор из списка, приведен на рис. 3.7. 

Компоненты ListBox и ComboBox отображают списки строк. Использование 
этих компонентов позволяет обеспечить безошибочный ввод информации пользо- 
вателем в тех случаях, когда он должен выбрать ответ из конечного множества 
альтернатив, например, из списка отделов предприятия. Компоненты списков от- 
личаются друг от друга прежде всего тем, что ListBox только отображает данные и 
позволяет пользователю выбрать из них то, что ему надо, а ComboBox позволяет 
также редактировать данные. Кроме того различается форма отображения спи- 
сков. ListBox отображает список в раскрытом виде и автоматически добавляет в 
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Рис. 3.7 fa Слиски 
Пример компонентов выбора 3 eee 
из списков 


список полосы прокрутки, если все строки не помещаются в окне компонента. 
ComboBox позволяет отображать список как в развернутом виде, так и в виде вы- 
падающего списка, что обычно удобнее, так как экономит площадь окна приложе- 
ния. | 

Основное свойство обоих компонентов, содержащее список строк, — Items, 
имеющее рассмотренный ранее тип TStrings. Заполнить его во время проектирова- 
ния можно, нажав кнопку с многоточием около этого свойства в окне Инспектора 
Объектов. При этом открывается окно редактирования, рассмотренное ранее в раз- 
деле 3.2.4 (рис. 3.6). Каждая записанная в нем строка будет соответствовать строке 
списка. Во время выполнения работать со свойством Items можно, пользуясь свой- 
ствами и методами класса TStrings (см. раздел 3.2.4 и главу 16) — Clear, Add и 
другими. Свойство Items->Count определяет текущее число строк списка. 

В компоненте ListBox имеется свойство MultiSelect, разрешающее пользова- 
телю множественный выбор в списке (на рис. 3.7 это свойство установлено в true в 
среднем верхнем списке). Если MultiSelect = false (значение по умолчанию), то 
пользователь может выбрать только один элемент списка. В этом случае можно уз- 
нать индекс выбранной строки из свойства ItemIndex, доступного только во время 
выполнения. Если ни одна строка не выбрана, то ItemIndex = -1. Начальное значе- 
ние ItemIndex невозможно задать во время проектирования. По умолчанию 
ItemIndex = -1. Это означает, что ни один элемент списка не выбран. Если вы хоти- 
те задать этому свойству какое-то другое значение, т.е. установить выбор по умол- 
чанию, который будет показан в момент начала работы приложения, то сделать 
это можно, например, в обработчике события OnCreate формы, введя в него опера- 
тор вида 


ListBoxl->ItemIndex = 0; 


Если допускается множественный выбор (MultiSelect = true), то значение 
ItemIndex соответствует тому элементу списка, который находится в фокусе. При 
множественном выборе проверить, выбран ли данный элемент, можно проверив 
свойство bool Selected[int Index]. 

На способ множественного выбора при MultiSelect = true влияет свойство 
ExtendedSelect. Если ExtendedSelect = true, то пользователь может выделить ин- 
тервал элементов, выделив один из них, затем нажав клавишу Shift uw переведя кур- 
сор к другому элементу. Выделить не прилегающие друг к другу элементы пользо- 
ватель может, если будет удерживать во время выбора нажатой клавишу Ctrl. Если 
же ExtendedSelect = false, то клавиши Shift и Си при выборе не работают. 

Свойство Columns определяет число столбцов, в которых будет отображаться 
список, если он не помещается целиком в окне компонента ListBox (в среднем 
верхнем списке на рис. 3.7 свойство Columns равно 2). 

Свойство Sorted позволяет упорядочить список по алфавиту. При Sorted = 
фгие новые строки в список добавляются не в конец, а по алфавиту. 
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Свойство Style, установленное в lbStandard (значение по умолчанию) соответ- 
ствует списку строк. Другие значения Style позволяют отображать в списке не 
только текст, но и изображения (эти стили мы рассматривать не будем — см. в 
книге [2]). 


Имеется еще один компонент, очень похожий на ListBox — это список с инди- 
каторами CheckListBox. Выглядит он так же, Kak ListBox (средний нижний спи- 
сок на рис. 3.7), но около каждой строки имеется индикатор, который пользова- 
тель может переключать. Индикаторы можно переключать и программно, если 
список используется для вывода данных и необходимо в нем отметить какую-то 
характеристику каждого объекта, например, наличие товара данного наименова- 
ния на складе. 

Все свойства, характеризующие компонент CheckListBox как список, анало- 
гичны ListBox, за исключением свойств, определяющих множественный выбор. 
Эти свойства компоненту CheckListBox не нужны, поскольку в нем множествен- 
ный выбор можно осуществлять установкой индикаторов. А свойства, связанные с 
индикаторами, описаны в разделе 3.5.4. 


Рассмотрим теперь компонент ComboBox. Стиль изображения этого компо- 
нента определяется свойством Style, которое может принимать следующие основ- 
ные значения: 


LRG ICL LOL LILA ILE ELLE IEE LALO LLE PND СУВОРОВА BEELER IES LBELEDI BEEBE PRES LIELIISE BEL REE ПА НАКАЗ SOP BLEED ELEN EY GEOL DEE ERLE 


csDropDown Выпадающий список со строками одинаковой высоты и 
с окном редактирования, позволяющим пользователю 
вводить или редактировать текст (правый список на 
рис. 3.7) 


csSimple | Развернутый список CO строками одинаковой высоты и 
| с окном редактирования, позволяющим пользователю 
вводить или редактировать текст (левый нижний спи- 
сок на рис. 3.7) 


csDropDownList Выпадающий список со строками одинаковой высоты, 
не содержащий окна редактирования 


csOwnerDrawFixed Выпадающий список типа csDropDown с графической 
прорисовкой элементов одинаковой высоты 


csOwnerDrawVariable Выпадающий список типа csDropDown с графической 
прорисовкой элементов, которые могут иметь различ- 
ную высоту 


Выбор пользователя или введенный им текст можно определить по значению 
свойства Text. Если же надо определить индекс выбранного пользователем элемен- 
та списка, то можно воспользоваться обсуждавшимся в компоненте ListBox свой- 
ством ItemIndex, доступным только BO время выполнения. Все сказанное ранее об 
ItemIndex и о задании его значения по умолчанию справедливо и для компонента 
ComboBox. Причем для ComboBox задание начального значения ItemIndex еще 
актуальнее, чем для ListBox. Если начальное значение не задано, то в момент за- 
пуска приложения окно редактирования списка будет отображать не один из эле- 
ментов списка, а значение свойства Text. Значит надо или вводить в приложение 
оператор, задающий в первый момент значение ItemIndex, или вводить во время 
проектирования в свойство Text какое-то приглашение к дальнейшим действием. 
Иначе пользователь будет в недоумении, что надо делать с этим списком. 

Если в окне проводилось редактирование данных, то Цепи пех = -1. По этому 
признаку можно определить, что редактирование проводилось. 
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Свойство MaxLength определяет максимальное число символов, которые 
пользователь может ввести в окно редактирования. Если MaxLength = 0, то число 
вводимых символов не ограничено. 

Как и в компоненте ListBox, свойство Sorted позволяет упорядочить список 
по алфавиту. При Sorted = true новые строки в список добавляются не в конец, a 
по алфавиту. 


3.2.6 Таблица строк — компонент StringGrid 


Компонент StringGrid (см. пример на рис. 3.8) представляет собой таблицу, 
содержащую строки. Данные таблицы могут быть только для чтения или редакти- 
руемыми. Таблица может иметь полосы прокрутки, причем заданное число пер- 
вых строк и столбцов может быть фиксированным и не прокручиваться. Таким об- 
разом, можно задать заголовки столбцов и строк, постоянно присутствующие в 
окне компонента. Каждой ячейке таблицы может быть поставлен в соответствие 
некоторый объект. 


Рис. 3.8 1. Компонент StingGrid | 
Пример компонента StringGrid В . : — Зи gGrid & og : вые coe 


eronbeu 1]eronéeu 2]cronGou 3]erondou 4 =] 


Компонент StringGrid предназначен в первую очередь для отображения таб- 
лиц текстовой информации. Однако в разделе 3.4.4 поясняется, как этот компо- 
нент может отображать и графическую информацию. 

Основные свойства компонента, определяющие отображаемый текст: 


РИО И ОИЯИ 


System:: AnsiString Cells Строка, содержащаяся в ячейке с индекса- 
[int ACol][int ARow] ми столбца и строки ACol и ARow 


Classes::TStrings* Cols[int Index] Список строк и связанных с ними объектов, 
содержащихся в столбце с индексом Index 


Classes::TStrings* Rows Список строк и связанных с ними объектов, 
[int Index] содержащихся в строке с индексом Index 


System::TObject* Objects Объект, связанный CO строкой, содержащей- 
{int ACol][int ARow] ся в ячейке с индексами столбца и строки 
ACol и АКом 


Все эти свойства доступны во время выполнения. Задавать тексты можно про- 
граммно или по отдельным ячейкам, или сразу по столбцам и строкам с помощью 
‚ методов класса TStrings (см. краткое описание в разделе 3.2.4 и подробное — в 
главе 16). 

Свойства ColCount и RowCount определяют соответственно число столбцов и 
строк, свойства FixedCols и FixedRows — число фиксированных, не прокручивае- 
мых столбцов и строк. Цвет фона фиксированных ячеек определяется свойством 
FixedColor. Свойства LeftCol и TopRow определяют соответственно индексы пер- 
вого видимого на экране в данный момент прокручиваемого столбца и первой ви- 
димой прокручиваемой строки. 
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Свойство ScrollBars определяет наличие в таблице полос прокрутки. Причем 
полосы прокрутки появляются и исчезают автоматически в зависимости от того, 
помещается таблица в соответствующий размер, или нет. 

Свойство Options является множеством, определяющим многие свойства таб- 
лицы: наличие разделительных вертикальных и горизонтальных линий в фикси- 
рованных (goFixedVertLine и goFixedHorzLine) и не фиксированных (goVertLine 
и goHorzLine) ячейках, возможность для пользователя изменять с помощью 
мыши размеры столбцов и строк (goColSizing и goRowSizing), перемещать столб- 
цы и строки (goColMoving и goRowMoving) и многое другое. Важным элементом в 
свойстве Options является goEditing — возможность редактировать содержимое 
таблицы. 

В основном компонент StringGrid используется для выбора пользователем ка- 
ких-то значений, отображенных в ячейках. Свойства Со] и Row показывают ин- 
дексы столбца и строки выделенной ячейки. Возможно также выделение пользова- 
телем множества ячеек, строк и столбцов. 

Среди множества событий компонента StringGrid следует отметить событие 
OnSelectCell, возникающее в момент выбора пользователем ячейки. В обработчик 
этого события передаются целые параметры ACol и ARow — столбец и строка вы- 
деленной ячейки, и булев параметр CanSelect — допустимость выбора. Параметр 
CanSelect можно использовать для запрета выделения ячейки, задав его значение 
false. А параметры ACol и ARow могут использоваться для какой-то реакции про- 
граммы на выделение пользователя. Например, оператор 


Labell->Caption = "Выбрана ячейка " + IntToStr(ARow) + 
13°") (+ ZRETOStr{ACol) ; 


выдаст в метку Labell сообщение о строке и столбце выбранной ячейки. A onepa- 
тор 


Labell->Caption = StringGridl->Cells[ACol] [ARow]; 


выведет в TY же метку текст выделенной ячейки. Конечно, в реальном приложе- 
нии задача заключается не в том, чтобы вывести подобные тексты при выборе по- 
льзователем той или иной ячейки, а в том, чтобы сделать нечто более полезное. 


3.3 Ввод и отображение чисел, дат и времени 


3.3.1 Перечень компонентов ввода и отображения чисел, 
дат и времени 


В библиотеке визуальных компонентов C++Builder существует ряд компонен- 
тов, позволяющих вводить, отображать и редактировать числа, даты и время. Ко- 
нечно, с подобной информацией можно обращаться и просто как с текстовой, ис- 
пользуя компоненты, описанные в разделе 3.2. Но это не удобно, так как не гаран- 
тирует от ошибок при вводе. В таблице 3.4 приведен перечень специализирован- 
ных компонентов ввода и отображения чисел, дат и времени с краткими характе- 
ристиками и указанием основных параметров, содержащих отображаемый или 
вводимый текст. 
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| IIm«tor- | Компонент Страница |Описание 
| рамма 


UpDown Кнопка-счетчик, в сочетании с KOM- 

(кнопка-счетчик) понентами Edit и другими позволя- 
ющая вводить цифровую информа- 
цию. Основное свойство — Position 


Spinkdit . Окно редактирования в комбинации | 
(кнопка-счетчик с с кнопкой-счетчиком. Почти то же, | 
окном редактирова- что комбинация Edit и UpDown. | 


Основное свойство — Value. 


DateTimePicker Win32 Ввод даты (с выпадающим календа- 
(окно ввода дат и рем) и времени. Основные свойства 
‘времени) — Date и Time 
MonthCalendar Win32 Ввод дат с выбором из календаря 
(окно ввода дат) | 
Calendar Отображение календаря на указан- | 
(календарь на ука- ный месяц. Компонент DateTime- | 
занный месяц) Picker имеет больше возможностей | 
по вводу дат, чем этот компонент. | 
Основные свойства — Month и Day | 


ния) 


F1Book ActiveX |Компонент ввода и обработки чис- 
(страницы Excel) ловой информации, аналогичный 


страницам Excel 


3.3.2 Ввод и отображение целых чисел — компоненты 
UpDown и SpinEdit 


В C++Builder имеются специализированные компоненты, обеспечивающие 
ввод целых чисел — UpDown и Spinkdit (см. пример на рис. 3.9). 


Рис. 3.9 
Пример компонентов UpDown и SpinEdit 


Компонент UpDown превращает окно редактирования Edit в компонент, в KO- 
тором пользователь может выбирать целое число, изменяя его кнопками со стрел- 
ками. Если к тому же установить в true свойство окна ReadOnly, то пользователь 
просто не сможет ввести в окно какой-либо свой текст и вынужден будет ограни- 
читься выбором числа. Компонент SpinEdit представляет собой сочетание Edit и 
UpDown, оформленное как отдельный тип компонента. 

Основное свойство компонента UpDown — Associate, связывающее кнопки со 
стрелками с одним из оконных компонентов, обычно с Edit. Чтобы опробовать 
компонент UpDown, перенесите на форму его и окно редактирования Edit, pacno- 
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ложив Edit там, где это требуется, а UpDown — в любом месте формы. Далее в вы- 
падающем списке свойства Associate компонента UpDown выберите Editl. Компо- 
нент UpDown немедленно переместится к Edit и как бы сольется с ним. 

Свойство AlignButton компонента UpDown, которое может принимать значе- 
ния udLeft или udRight, определяет, слева или справа от окна будут размещаться 
кнопки. Свойство Orientation, которое может принимать значения udHorizontal 
или udVertical, определяет, расположатся ли кнопки по вертикали (одна под дру- 
гой — см. левый компонент на рис. 3.9) или по горизонтали (одна рядом с дру- 
гой — см. правый компонент на рис. 3.9). Свойство ArrowKeys определяет, будут 
ли управлять компонентом клавиши клавиатуры со стрелками. Свойство 
Thousands определяет наличие или отсутствие разделительного пробела между Ka- 
ждыми тремя цифрами разрядов вводимого число. 

Свойства Min и Мах компонента UpDown задают соответственно минимальное 
и максимальное значения чисел, свойство Increment задает приращение числа при 
каждом нажатии на кнопку. Свойство Position определяет текущее значение чис- 
ла. Это свойство можно читать, чтобы узнать, какое число задал пользователь. Его 
можно задать во время проектирования в диапазоне Мт — Мах. Тогда это будет 
значение числа по умолчанию, отображаемое в окне в начале выполнения прило- 
жения. 

Свойство Wrap определяет, как ведет себя компонент при достижении макси- 
мального или минимального значений. Если Wrap = false, то при увеличении или 
уменьшении числа до максимального или минимального значения это число фик- 
сируется на. предельном значении и нажатие кнопки, пытающейся увеличить мак- 
симальное число или уменьшить минимальное, ни к чему не приводит. Если же 
Wrap = true, то попытка превысить максимальное число приводит к его сбросу на 
минимальное значение. Аналогично, попытка уменьшить минимальное число 
приводит к его сбросу на максимальное значение. Т.е. изменение чисел «закольцо- 
вывается». 

Если в компоненте Edit, связанном с UpDown, не задать ReadOnly равным 
true, то пользователь сможет редактировать число, не пользуясь кнопками со 
стрелками. Это удобно, если требуемое число далеко от указанного по умолчанию, 
а шаг приращения Increment в UpDown мал. Но тут проявляется серьезный недос- 
таток компонента UpDown: ничто не мешает пользователю ввести по ошибке не 
цифры, а какие-то другие символы. Чтобы избавиться от этого недостатка, можно 
использовать прием, описанный в главе 4 в разделе 4.3.2.2, который не дает воз- 
можность пользователю ввести в окно редактирования какие-то символы, кроме 
цифр. Но лучше для этих целей использовать компонент ЗршЕЯЦ. | 

Свойства компонента SpinEdit похожи на рассмотренные, только имеют дру- 
гие имена: свойства Min, Max, Position называются соответственно MinValue, 
MaxValue, Value. В целом компонент SpinEdit во многих отношениях удобнее 
простого сочетания UpDown и Edit. Так что, если не требуются какие-то из опи- 
санных выше дополнительных возможностей UpDown (нестандартное расположе- 
ние кнопок, «закольцовывание» изменений ит.п.), то можно рекомендовать поль- 
зоваться компонентом Spinkdit. 


3.3.3 Ввод и отображение дат и времени — компоненты 
DateTimePicker, MonthCalendar, Calendar 


Примеры компонентов ввода и отображение дат и времени приведены на 
рис. 3.10. 

Из этих компонентов наиболее удобным является DateTimePicker (на 
рис. 3.10, слева вверху показан этот компонент в режиме ввода времени, а ниже — 
в двух вариантах режима ввода даты). Компонент очень эффектен за счет появле- 
ния выпадающего календаря (иногда даже слишком эффектен для строго оформ- 
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Рис. 3.10 
Примеры компонентов отображения 
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ленного приложения) и обеспечивает безошибочный с точки зрения синтаксиса 
ввод дат и времени. Его свойство Kind определяет режим работы компонента: 
dtkDate — ввод даты, dtkTime — ввод времени. 

При вводе дат можно задать свойство DateMode равным dmComboBox — нали- 
чие выпадающего календаря, или равным dmUpDown — наличие кнопок увеличе- 
ния и уменьшения (см. средний компонент DateTimePicker на рис. 3.10), напоми- 
нающих те, которые используются в описанных ранее компонентах UpDown и 
SpinEdit. Только в данном случае пользователь может независимо устанавливать с 
помощью кнопок число, месяц и год. Формат представления дат определяется 
свойством DateFormat, которое может принимать значения dfShort — краткий 
формат (например, «08.03.00»), или dfLong — полный формат (например, «8 Март 
2000г.»). 

Значение даты по умолчанию можно задать в Инспекторе Объектов через свой- 
ство Date. Это же свойство читается для определения заданной пользователем 
даты. При чтении Date надо учитывать тип этого свойства — TDateTime, пред- 
ставляющий собой число с плавающей запятой, целая часть которого содержит 
число дней, отсчитанное от некоторого начала календаря, а дробная часть равна 
части 24-часового дня, т.е. характеризует время и не относится к дате. За начало 
календаря принята дата 12/30/1899 00 часов. 

Для преобразования значения свойства Date в строку можно воспользоваться 
функцией DateToStr. Например, оператор 


Memol->Lines->Add("Jlatra: " + DateToStr (DateTimePickerl->Date) ); 


добавит в окно Memol строку вида «Дата: 08.03.00». 

При вводе дат можно задать значения свойств MaxDate и MinDate, опреде- 
ляющих соответственно максимальную и минимальную дату, которую может за- 
дать пользователь. 

В режиме ввода времени dtkTime введенное пользователем значение можно 
найти в свойстве Time, тип которого — тот же рассмотренный выше TDateTime. 
Преобразовать время в строку можно функцией TimeToStr. 


Компонент MonthCalendar похож на компонент DateTimePicker, работающий 
в режиме ввода дат. Правда, в компоненте MonthCalendar предусмотрены некото- 
рые дополнительные возможности: можно допустить множественный выбор дат в 
некотором диапазоне (свойство MultiSelect), можно указывать в календаре номера 
недель с начала года (свойство WeekNumbers), перестраивать календарь, задавая 
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первый день каждой недели (свойство FirstDayOfWeek) и т.п. Для некоторых 
офисных приложений все это достаточно удобно. 


Компонент Calendar представляет собой менее красочный и более обыденно 
оформленный календарь на один месяц. Вместо свойства Date в нем предусмотре- 
ны отдельные свойства Year — год, Month — месяц, Day — день. Все это целые 
числа, с которыми иногда удобнее иметь дело, чем с типом TDateTime. Перед ото- 
бражением на экране или в процессе проектирования надо задать значения Month 
и Year, чтобы компонент отобразил календарь на указанный месяц указанного 
года. Впрочем, если вам надо иметь календарь на текущий месяц, надо установить 
в true значение свойства UseCurrentDate (установлено по умолчанию). В этом слу- 
чае по умолчанию будет показан календарь на текущий месяц с выделенным в нем 
текущим днем. Свойство StartOfWeek задает день, с которого начинается неделя. 
По умолчанию задано 0 — воскресенье, как это принято в западных календарях. 
Но для нас все-таки как-то привычнее начинать неделю с рабочего дня — поне- 
дельника. Так что желательно задать StartOfWeek = 1. 


3.3.4 Страницы Excel — компонент F1IBook 


Очень интересным компонентом является FIBook на странице ActiveX. Этот 
компонент позволяет встроить в ваше приложение таблицы типа Ехсе] (рис. 3.11), 
которые пользователь может заполнять соответствующими числами, а компонент 
будет производить по заданным формулам вычисления и тут же отображать их ре- 
зультаты в указанных ячейках. В таблицу можно встроить диаграммы и графики 
различных типов. И все изменения, вносимые пользователем в данные таблицы, 
немедленно будут отображаться в диаграммах. Таким образом вы можете вклю- 
чать в свое приложение различные бланки смет, счетов, ведомостей, с которыми 
будет работать пользователь, различные таблицы, производящие статистические 
или технические расчеты и т.п. 


Рис. 3.11 | Учет товаров на складе __ 
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Перенесите на форму компонент Е1Воок и щелкните на нем правой кнопкой 
мыши. Выберите из всплывшего меню команду Workbook Designer. Перед вами поя- 
вится диалоговое окно проектирования, представленное на рис. 3.12. Те, кто зна- 
ком с программой Excel, могут увидеть, что это окно является несколько упрощен- 
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ным вариантом Excel. Проектирование таблицы производится фактически по тем 
же правилам, что ив Excel. Вы можете писать в ячейках необходимые надписи, за- 
давая шрифт, его стиль, обрамление. Можете записывать формулы. Так на 
рис. 3.11 и 3.12 последний столбец представляет собой стоимость соответствующе- 
го товара, являющуюся произведением его количества на его цену. А ячейка внизу 
таблицы суммирует стоимость всех товаров. 
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Правая быстрая кнопка Ha рис. 3.12 позволяет ввести на страницу диаграммы 
и графики. Чтобы задать диаграмму, надо сначала выделить курсором в таблице 
данные, которые должны отображаться в диаграмме, затем нажать кнопку ввода 
диаграммы, после этого указать курсором рамку, в которой должна отображаться 
диаграмма. В результате вы попадете в диалоговое окно, в котором сможете вы- 
брать тип диаграммы и необходимые ее атрибуты. 

Рассказывать подробно о работе с окном проектирования компонента F1Book 
невозможно из-за ограничения на объем данной книги. Те, кто знаком с Excel, без 
труда смогут в этом окне ориентироваться. К тому же в нем имеется встроенная 
справка, вызываемая командой меню Help или клавишей Fl. 

Щелкнув правой кнопкой мыши на компоненте F1Book, вы можете выбрать 
еще одну команду — Properties. В появившемся при этом диалоговом окне вы може- 
те, в частности, задать опции, определяющие, что будет видно или не видно в таб- 
лице при работе приложения: заголовки строк и столбцов (Row Heading и Column 
Heading), сетка (Gridlines), формулы вычислений (Formulas) и т.п. 


3.4 Компоненты отображения и ввода иных 
видов информации 


3.4.1 Компоненты отображения иерархических 
данных — TreeView и Outline 


Компоненты Tree View и Outline служат для отображения иерархических дан- 
ных в виде дерева (см. пример на рис. 3.13), в котором пользователь может вы- 
брать нужный ему узел или узлы. Иерархическая информация может быть самой 
разной: структура некоторого предприятия, структура документации учреждения, 
структура отчета и т.п. С каждым узлом дерева могут быть связаны некоторые 
данные. 

Возможности компонента TreeView несколько шире, чем компонента Outline. 
К тому же TreeView — 32-разрядный компонент, a Outline — 16-разрядный. По- 
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Рис. 3.13 
Примеры компонентов TreeView и Outline 
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этому Outline целесообразно использовать только в приложениях, предназначен- 
ных для работы в любых версиях Windows, включая Windows 3.x. 

Основным свойством TreeView, содержащим информацию об узлах дерева, яв- 
ляется Цетз. Доступ к информации об отдельных узлах осуществляется через 
свойство Items[int Index]. Например, Tree View1->Items->Item[0] — это узел дере- 
ва с индексом 0 (первый узел дерева). Каждый узел является объектом типа 
TTreeNodes, обладающим своими свойствами и методами. 

Во время проектирования формирование дерева осуществляется в окне редак- 
тора узлов дерева, представленном на рис. 3.14. Это окно вызывается двойным 
щелчком на компоненте TreeView или нажатием кнопки с многоточием около 
свойства Items в окне Инспектора Объектов. 

Кнопка New Нет (новый узел) позволяет добавить в дерево новый узел. Он бу- 
дет расположен на том же уровне, на котором расположен узел, выделенный кур- 
сором в момент щелчка на кнопке New Item. 

Кнопка New Subltem (новый дочерний узел) позволяет добавить в дерево дочер- 
ний узел. Он будет расположен на уровень ниже уровня того узла, который выде- 
лен курсором в момент щелчка на кнопке New Subltem. 

Кнопка Delete (удалить) удаляет выделенный узел дерева. Кнопка Load позво- 
ляет загрузить структуру дерева из файла. Файл, хранящий структуру дерева — 
это обычный текстовый файл, содержащий тексты узлов. Уровни узлов обознача- 
ются отступами. Например, файл дерева, изображенного на рис. 3.13 и 3.14, мо- 
жет иметь вид: 

производство 

цех 1 

цех 2 

цех 3 
управление 


администрация 
бухгалтерия 


Для каждого нового узла дерева можно указать ряд свойств в панели Нет 
Properties окна на рис. 3.14. Это прежде всего свойство Text — надпись, появляю- 
щаяся в дереве около данного узла. Свойства Image паех и Selected Index определяют 
индекс пиктограммы, отображаемой для узла, который соответственно не выделен 
и выделен пользователем в данный момент. Эти индексы соответствуют списку 


Рис. 3.14 
Окно редактора узлов дерева компонента 
TreeView 
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изображений, хранящихся в отдельном компоненте ImageList (см. раздел 3.9.2). 
Указание на этот компонент вы можете задать в свойстве Images компонента 
TreeView. Индексы начинаются с 0. Если вы укажете индекс -1 (значение по умол- 
чанию), пиктограммы изображаться не будут. Последнее свойство — State Index в 
панели Нет Properties позволяет добавить вторую пиктограмму в данный узел, не 
зависящую от состояния узла. Подобная пиктограмма может просто служить до- 
полнительной характеристикой узла. Индекс, указываемый Kak State Index, соот- 
ветствует списку изображений, хранящихся в отдельном компоненте ImageList, 
указанном в свойстве StateImages компонента TreeView. 

Мы рассмотрели формирование дерева в процессе проектирования. Однако, 
дерево можно формировать или перестраивать и во время выполнения приложе- 
ния. Для этого служит ряд методов объектов типа TTreeNodes. Следующие методы 
позволяют вставлять в дерево новые узлы: 


ТАРА ИИ я 


Add(TTreeNode* No е, 
const System::AnsiString 5) последний узел уровня, на котором 
расположен Node 


AddFirst(TTreeNode* Node, Вставляет новый узел с текстом $ как 
const System::AnsiString 5) первый из узлов уровня, на котором 
находится Моде. Индексы последую- 
щих узлов увеличиваются на 1 


Insert(TTreeNode* Node, Вставляет новый узел с текстом S cpa- 
const System::AnsiString 5) зу после узла Node на то же уровень. 
Индексы последующих узлов увеличи- 
ваются на 1 


AddChild(TTreeNode* Node, Добавляет узел с текстом S как по- 
const System::AnsiString 5) следний дочерний узла Node 


AddChildFirst(TTreeNode* Node, Вставляет новый узел с текстом 8 как 
const System::AnsiString 5) первый из дочерних узлов узла Node. 
Индексы последующих узлов увеличи- 
ваются на 1 


Каждый из этих методов возвращает вставленный узел. 
Ниже в качестве примера приведен код, формирующий то же дерево, которое 
вы можете видеть на рис. 3.13 и 3.14. 


TreeViewl->Items->Clear(); // очистка списка 
// добавление корневого узла "производство" (индекс О0) 
TreeViewl->Items->Add (NULL, "производство"); 


/* добавление дочених узлов "цех 1" — "цех 3" 

(индексы 1 — 3)*/ 
TreeViewl->Items->AddChild(TreeViewl->Items->Item[0],"uex 1"); 
TreeViewl->Items->AddChild(TreeViewl->Items->Item[0],"uex 2"); 
TreeViewl->Items->AddChild(TreeViewl->Items->Item[0],"uex 3"); 


/* добавление корневого узла "управление" после узла 
"производство" (индекс 4) */ 
TreeViewl->Items->Add (TreeViewl->Items->Item[0], "управление"); 


/* добавление дочених узлов "администрация" и "бухгалтерия" 
узла "управление"*/ 
TreeViewl->Items->AddChild ( 
| TreeViewl->Items->Item[4], "angmuyHuctpauna") ; 
TreeViewl->Items->AddChild ( ; 
TreeViewl->Items->Item[4],"6yxrantrepua") ; 
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Дерево может быть сколь угодно разветвленным. Например, следующие опе- 
раторы добавляют дочерние узлы «бригада 1» и «бригада 2» в сформированный ра- 
нее узел «цех 1»: 


TreeViewl->Items->AddChild(TreeViewl->Items->Item[1], 
"бригада 1"); 

TreeViewl->Items->AddChild(TreeViewl->Items->Item[1], 
"бригада 2"); 


Текст, связанный с некоторым узлом, можно найти с помощью его свойства 
Text. Например, TreeView1->Items->Item[1]->Text — это надпись «цех 1». 

С каждым узлом может быть связан некоторый объект. Добавление таких y3- 
лов осуществляется методами AddObject, AddObjectFirst, InsertObject, AddChild- 
Object, AddChildObjectFirst, аналогичными приведенным выше, HO содержащими 
в качестве параметра еще указатель на объект: 


AddObject(TTreeNode* Node, Добавляет новый узел с текстом Зи 
const System::AnsiString 5, void * Ptr) объектом Ptr как последний узел 
уровня, Ha котором расположен Node 


AddObjectFirst(TTreeNode* Node, Вставляет новый узел с текстом $ и 
const System::AnsiString 5, void * Ptr) объектом Ptr как первый из узлов 
уровня, на котором находится No- 
де. Индексы последующих узлов 
увеличиваются на 1 


InsertObject(TTreeNode* Node, Вставляет новый узел с текстом $ и 

const System::AnsiString 5, void * Ptr) объектом Ptr сразу после узла Node 

| на то же уровень. Индексы последу- 
ющих узлов увеличиваются на 1 


AddChildObject(TTreeNode* Node, Добавляет узел с текстом $ и объ- 
const System::AnsiString 5, void * Ptr) ектом Ptr как последний дочерний 
узла Node 


AddChildObjectFirst(TTreeNode* Node, Вставляет новый узел с текстом $ и 
const System::AnsiString 5, void * Ptr) объектом Ptr как первый из дочерних 
узлов узла Node. Индексы последу- 

ющих узлов увеличиваются на 1 


Объект, связанный с некоторым узлом, можно найти с помощью его свойства 
Data. Например, Tree Viewl1->Items->Item[1]->Data. 

Для удаления узлов имеется два метода: Clear(void), очищающий все дерево, и 
Delete(TTreeNode* Node), удаляющий указанный узел Node и все его узлы — по- 
томки. Например, оператор 


TreeViewl->Items->Clear(); 


удалит в нашем примере все узлы, а оператор 


TreeViewl->Items->Delete (TreeViewl->Items->Item[1]); 


удалит узел «цех 1» и его дочерние узлы (если они имеются). 
При удалении узлов, связанных с объектами, сами эти объекты не удаляются. 
Реорганизация дерева, связанная с созданием или удалением многих узлов, 
может вызывать неприятное мерцание изображения. Избежать этого можно с по- 
мощью методов Верт Орда{е и EndUpdate. Первый из них запрещает перерисовку 
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дерева, a второй — разрешает. Таким образом, изменение структуры дерева может 
осуществляться по следующей схеме: 


TreeViewl->Items->BeginUpdate(); 
<операторы изменения дерева> 
TreeViewl->Items->EndUpdate (); 


Если метод BeginUpdate применен подряд несколько раз, то перерисовка дере- 
ва произойдет только после того, как столько же раз будет применен метод 
EndUpdate. 

Среди свойств узлов следует отметить Count — число узлов, управляемых дан- 
ным, т.е. дочерних узлов, их дочерних узлов ит.п. Если значение Count узла рав- 
но нулю, значит у узла нет дочерних узлов, т.е. он является листом дерева. 

Вернемся к свойствам компонента TreeView. Важным свойством компонента 
TreeView является Selected. Это свойство указывает узел, который выделен поль- 
зователем. Пользуясь этим свойством можно запрограммировать операции, кото- 
рые надо выполнить для выбранного пользователем узла. Если ни один узел не вы- 
бран, значение Selected равно NULL. При выделении пользователем нового узла 
происходят события OnChanging (перед изменением выделения) и OnChanged — 
после выделения. В обработчик события OnChanging передаются параметры 
TTreeNode *Node — узел, который выделен в данный момент, и bool &AllowChan- 
ge — разрешение на перенос выделения. Если в обработчике задать AllowChange = 
false, то переключение выделения не произойдет. В обработчик события OnChan- 
ged передается только параметр TTreeNode *Node — выделенный узел. В этом 06- 
работчике можно предусмотреть действия, которые должны производится при вы- 
делении узла. 

У компонента TreeView имеется свойство RightClickSelect, разрешающее 
(при значении равном true) выделение узла щелчком как левой, так и правой 
кнопкой мыши. Но и в этом случае событие OnChanged наступает только при вы- 
делении узла левой кнопкой мыши. 

Ряд событий компонента TreeView связан с развертыванием и свертыванием 
узлов. При развертывании узла происходят события OnExpanding (перед развер- 
тыванием) и OnExpanded (после развертывания). В обработчики обоих событий пе- 
редается параметр TTreeNode *Node — развертываемый узел. Кроме того в обра- 
ботчик OnExpanding передается параметр bool &AllowExpansion, который можно 
задать равным false, если желательно запретить развертывание. При свертывании 
узла происходят события OnCollapsing (перед свертыванием) и OnCollapsed (после 
свертывания). Так же, как и в событиях, связанных с развертыванием, в обработ- 
чики передается параметр TTreeNode *Node — свертываемый узел, а в обработчик 
OnCollapsing дополнительно передается параметр bool &AllowCollapse, разре- 
шающий или запрещающий свертывание. 

Свойство ReadOnly компонента TreeView позволяет запретить пользователю 
редактировать отображаемые данные. Если редактирование разрешено, то при ре- 
дактировании возникают события OnEditing и OnEdited, аналогичные рассмот- 
ренным ранее (в обработчике OnkEditing параметр bool &АПомЕЧЁ позволяет за- 
претить редактирование). 

Ряд свойств компонента TreeView: ShowButtons, ShowLines, ShowRoot отве- 
чают за изображение дерева и позволяют отображать или убирать из него кнопки, 
показывающие раскрытия узла, линии, связывающие узлы, и корневой узел. По- 
экспериментируйте с этими свойствами и увидите, как они влияют на изображе- 
ние. 

Свойство SortType позволяет автоматически сортировать ветви и узлы дерева. 
По умолчанию это свойство равно stNone, что означает, что дерево не сортируется. 
Если установить SortType равным stText, то узлы будут автоматически сортиро- 
ваться по алфавиту. Возможно также проводить сортировку по связанным с узла- 
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ми объектам Data (значение SortType равно stData), одновременно по тексту и 
объектам Data (значение Зогё Туре равно stBoth) или любым иным способом. Для 
использования этих возможностей сортировки надо написать обработчик события 
OnCompare, в который передаются, в частности, параметры TTreeNode *Nodel и 
TTreeNode *Node2 — сравниваемые узлы, и параметр int &Сошраге, в который 
надо заносить результат сравнения: отрицательное число, если узел Nodel должен 
располагаться ранее Node2, 0, если эти узлы считаются эквивалентными, и поло- 
жительное число, если узел Nodel должен располагаться в дереве после Node2. 
Например, следующий оператор в обработчике события ОпСотраге обеспечивает 
обратный алфавитный порядок расположения узлов: 


Compare = — AnsiStriIComp(Nodel->Text.c str(), 
Node2->Text.c str()); 


События OnCompare наступают после задания любого значения SortType, or- 
личного от stNone, и при изменении пользователем свойств узла (например, при 
редактировании им надписи узла), если значение SortType не равно stNone. После 
сортировки первоначальная последовательность узлов в дереве теряется. Поэтому 
последующее задание SortType = stNone не восстанавливает начальное располо- 
жение узлов, но исключает дальнейптую генерацию событий OnCompare, т.е. авто- 
матическую перестановку узлов, например, при редактировании их надписей. 
Если же требуется изменить характер сортировки или провести сортировку с уче- 
том новых созданных узлов, TO надо сначала задать значение SortType = stNone, а 
затем задать любое значение Зогё Туре, отличное от stNone. При этом будут creHe- 
рированы новые обращения к обработчику событий OnCompare. — 

Имеются и другие возможности сортировки. Например, метод Alpha- 
Sort(void) обеспечивает алфавитную последовательность узлов независимо от зна- 
чения SortType, но при отсутствии обработчика событий OnCompare (если обра- 
ботчик есть, то при выполнении метода AlphaSort происходит обращение к этому 
обработчику). Отличие метода AlphaSort от задания значения SortType = stText 
заключается в том, что изменение надписей узлов приводит к автоматической пе- 
ресортировке дерева только при SortType = stText. 


Мы рассмотрели основные возможности компонента TreeView. Компонент 
Outline похож на него. Структура дерева тоже содержится в свойстве Items и дос- 
туп к отдельным узлам также осуществляется через этот индексный список узлов. 
Но индексы начинаются с 1. Например, Outlinel->Items[1] ->Text — это текст 
узла дерева с индексом 1 (первого узла). Свойство Items имеет тип TOutlineNode. 
Его свойства и методы отличаются от свойств и методов типа узлов в TreeView. И 
заполняется структура дерева иначе: через свойство Lines типа TStrings. Редактор 
этого свойства можно вызвать, щелкнув на кнопке с многоточием около свойства 
Lines в окне Инспектора Объектов. Вы попадете в окно, в котором можете записать 
тексты всех узлов, делая отступы, чтобы выделить уровни узлов. Текст должен вы- 
глядеть так, как выше описывалось представление структуры в текстовом файле. 

Пиктограммы, сопровождающие изображения узлов, задаются параметрами 
PictureOpen (пиктограмма развернутого узла), PictureClosed (пиктограмма свер- 
нутого узла), PictureMinus (пиктограмма символа «-» около развернутого узла, 
имеющего наследников), PicturePlus (пиктограмма символа «+» узла, имеющего 
наследников, но не развернутого), PictureLeaf (пиктограмма узла, не имеющего 
наследников — листа дерева). Основное отличие пиктограмм компонента Outline 
заключается в том, что они одинаковы для всех узлов одного типа, тогда как в 
TreeView можно задавать пиктограммы индивидуально для каждого узла. 

Программно изменять структуру дерева можно с помощью методов Add, 
AddObject (добавление узла в дерево), Insert, InsertObject (вставка узла в задан- 
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ную позицию), AddChild, AddChildObject (вставка дочернего узла), Delete (удале- 
ние узла). 

Индекс выделенного пользователем узла можно определить через свойство 
SelectedItem. Если SelectedItem = 0, значит ни один узел не выделен. Текст выде- 
ленного узла определяется свойством Text: например, 


Outlinel->Items [Outlinel->SelectedItem] ->Text 


Впрочем, TOT же самый текст даст и выражение 
Outlinel->Lines->Strings (Outlinel->SelectedItem - 1] 


3.4.2 Отображение информации в стиле папок Windows — 
компонент ListView 


Компонент ListView позволяет отображать в стиле Windows данные в виде 
списков, таблиц, крупных и мелких пиктограмм. С подобным отображением все 
вы сталкиваетесь, раскрывая папки Windows. 

Стиль отображения информации определяется свойством ViewStyle, которое 
может устанавливаться в процессе проектирования или программно во время вы- 
полнения. Свойство может принимать значения: vVSIcon — крупные значки (см. 
рис. 3.15 а), vsSmallIcon — мелкие значки, vsList — список (см. рис. 3.15 6), 
vsReport — таблица (см. рис. 3.15 в). Что означает каждое из этих значений вы 
можете посмотреть не только на рис. 3.15, но и в любой папке Windows на рабочем 
столе. 


Рис. 3.15 

Пример компонента ListView в 
режимах vsicon (а), vsList (6) и 
vsReport (в) 


„+, 


Цех 5 
Цех 4 


= 


Рассмотрим основные свойства и методы компонента List View. Начните новое 
приложение и перенесите на него ListView. Основное свойство компонента 
List View, описывающее состав отображаемой информации — Items. Во время про- 
ектирования OHO может быть установлено специальным редактором (рис. 3.16), 
вызываемым щелчком на кнопке с многоточием рядом с этим свойством в окне Ин- 
спектора Объектов. Окно редактора похоже на окно, описанное для компонента 
TreeView (рис. 3.14). Точно так же в нем задаются новые узлы кнопкой New Item и 
дочерние узлы — кнопкой New Subltem. Только смысл дочерних узлов другой: это 
информация, которая появляется только в режиме vSReport — в виде таблицы. 
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Рис. 3.16 ListView Items Editor 


Окно редактора списка объектов 
компонента ListView 


Задайте в редакторе некоторое множество элементов и дочерних узлов. Смысл 
их зависит от конкретной задачи. Это могут быть некоторые изделия и цеха, в KO- 
торых они должны проходить обработку, или это могут быть товары и пункты, 
куда их надо отправить, и т.п. На рис. 3.16 указаны некоторые абстрактные объек- 
ты и цеха. 

Для каждого узла задается свойство Caption — надпись, появляющаяся около 
пиктограммы. Для дочерних узлов это свойство соответствует надписи, появляю- 
щейся в ячейках таблицы в режиме vsReport (см. надписи вида «Цех ...» Ha 
рис. 3.15 в). 

Свойство Image Index определяет индекс пиктограммы. Индекс соответствует 
спискам изображений, хранящимся в отдельных компонентах ImageList (см. раз- 
дел 3.9.2). Указания на эти компоненты вы можете задать в свойствах LargeIma- 
ges для режима у$соп и SmallIlmages для режимов vsSmallicon, vsList и vsRe- 
port. Индексы начинаются с 0. Если вы укажете индекс -1 (значение по умолча- 
нию), пиктограммы изображаться не будут. 

Свойство State Index в панели Item Properties позволяет добавить вторую пикто- 
грамму в данный объект. Подобная пиктограмма может просто служить дополни- 
тельной характеристикой объекта. Индекс, указываемый Kak State Index, соответ- 
ствует списку изображений, хранящихся в отдельном компоненте ImageList, ука- 
занном в свойстве StateImages компонента List View. 

Остановимся пока на этих свойствах и построим приложение, предоставляю- 
щее пользователю возможность изменять вид списка в окне List View и кроме того 
позволяющее при стилях vsIcon и узЗтаШсоп перетаскивать пиктограммы мы- 
шью в любое место окна. Для реализации такого приложения нам потребуется 
компонент меню MainMenu (см. раздел 3.6.1). Кроме того для понимания некото- 
рых приведенных ниже операторов надо представлять себе технологию перетаски- 
вания Drag&Drop, с которой вы познакомитесь подробно в главе 4 в разделе 4.4.1. 
После изучения этого раздела вы сможете вернуться к приведенному ниже приме- 
ру и понять то, что в нем покажется вам неясным. 

Для реализации примера надо сделать следующее: 


Ш введите в приложение разделы меню Крупные значки (пусть его имя будет MI- 
соп), Мелкие значки (имя М5шаШсоп), Список (имя MList) и Таблица (им 
MReport) 


Ш установите во всех этих разделах одинаковый отличный OT нуля индекс Grou- 
pIndex и свойства Radioltem в true 


Ш один из разделов пометьте Kak Checked и в свойстве списка Views tyra устано- 
вите значение, соответствующее этому разделу 


Ш напишите следующие обработчики щелчков для этих разделов: 


void _fastcall TForml::MIconClick(TObject *Sender) 
{ 

ListViewl->ViewStyle = vsIcon; 

MIcon->Checked = true; 

ListViewl->DragMode = dmAutomatic; 
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} 
1 ——=———м————_—ЦЩЦ`—-—> 
void _ Еаз&са11 TForml::MSmalliconClick(TObject *Sender) 
{ | 

ListViewl->ViewStyle = vsSmallicon; 
MSmallicon->Checked = true; 

ListViewl->DragMode = dmAutomatic; 

} 

ен нь 
void _fastcall TForml::MListClick(TObject *Sender) 
{ 

ListViewl->ViewStyle = vsList; 

MList->Checked = true; 

ListViewl->DragMode = dmManual; 

} 

1 sas ——=————————————— 

void _fastcall TForml::MReportClick(TObject *Sender) 
{ 

ListViewl->ViewStyle = vsReport; 

MReport->Checked = true; 

ListViewl->DragMode = dmManual; 


} 
Кроме того надо написать следующие обработчики событий OnDragOver и On- 


DragDrop компонента List View: 


void _fastcall TForml::ListViewlDragOver(TObject *Sender, 
TObject ‘Source /i( int Хх, ‘int’ У, 
TDragState State, bool &Accept) 


{ 


} 

РО За EE 

void _fastcall TForml::ListViewlDragDrop(TObject *Sender, 
TObject *Source, int X, int Y) 


Accept = (Source = ListView1) ; 


{ 
((TListView*) Sender) ->Selected->Position = Point(X,Y); 


} 
Реализуйте этот пример. Вы увидите, что создали окно, имеющее много обще- 


го с обычными папками Windows. 


Метод Arrange: 
void  fastcall Arrange(TListArrangement Code) ; 


позволяет упорядочить пиктограммы в режимах vsicon и vsSmallicon. Параметр 
Code определяет способ упорядочивания: 


Ps 


ИИ ИЯ LBB ELLA LILLE LEE ОИ ЗИ ЛИОН АКИ ЗАЛЕ 


arAlignBottom выравнивание вдоль нижнего края области 


arAlignLeft выравнивание вдоль левого края области 

arAlignRight выравнивание вдоль правого края области 

arAlignTop выравнивание вдоль верхнего края области 

arDefault выравнивание по умолчанию (вдоль верхнего края области) 
arSnapToGrid размещение каждой пиктограммы в ближайшем узле сетки 


Вы можете ввести в свое тестовое приложение раздел Выравнивание и в обработ- 


чик щелчка на нем записать оператор 


ListViewl->Arrange (arAlignTop) ; 
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Тогда после перетаскивания элементов вы всегда сможете опять упорядочить 
их расположение, выбрав этот раздел меню. 

Способ упорядочивания определяется соответствующим заданием свойства 
SortType, которое уже рассматривалось нами для компонента TreeView. 

Свойство Checkboxes, установленное в true, определяет отображение индика- 
тора с флажком около каждого элемента списка (см. рис. 3.15). Только учтите, что 
свойство. срабатывает только в случае, если вы не установили описанное ранее 
свойство StateImages. Иначе говоря, около пиктограммы может появляться или 
индикатор, или дополнительная пиктограмма. 

Индикаторы элементов можно устанавливать программно или их может изме- 
нять пользователь во время выполнения. Тогда узнать программно, установлен ли 
индикатор в некотором элементе Items[i], можно проверкой его свойства Checked. 
Например: 

for (int 1=0; i < ListViewl->Items->Count; i++) 

if (ListViewl->Items->Item[i]->Checked) 


ShowMessage ("Выбран элемент " + 
ListViewl->Items->Item[i]->Caption) ; 


Приведенный оператор проверяет все элементы и отображает сообщения о TeX, 
в которых установлен индикатор. В реальном приложении, конечно, вместо такого 
сообщения должны предприниматься какие-то действия. 

Свойства HotTrack и HotTrackStyles определяют появление выделения при 
перемещении курсора над элементом списка и стиль этого выделения. Свойство 
HoverTime задает в миллисекундах задержку появления такого выделения. 

Свойство списка Selected определяет выделенный пользователем элемент спи- 
ска. Этим можно воспользоваться для выполнения каких-то действий. Например, 
если требуются некие действия при двойном щелчке на каком-то элементе, то в об- 
работчике события OnDbIClick компонента List View можно написать оператор: 


if (ListViewl->Selected != NULL) 
ShowMessage (ListViewl->Selected->Caption) ; 


Оператор if проверяет, выделен ли какой-то элемент, т.е. произведен ли двой- 
ной щелчок на элементе, а не просто на пустом поле списка. Если щелчок на эле- 
менте, то с ним можно провести какие-то действия (в данном примере вместо этого 
просто отображается сообщение). 

Свойство Columns определяет список заголовков таблицы в режиме vsReport 
(см. заголовки «Объект», «подр. 1», «подр. 2» на рис. 3.15 в) при свойстве Show- 
ColumnHeaders (показать заголовки), установленном в true. Свойство Columns 
можно задать в процессе проектирования специальным редактором заголовков, 
вызываемом двойным щелчком на компоненте List View или щелчком на кнопке.с 
многоточием рядом со свойством Columns в окне Инспектора Объектов. В обоих 
случаях перед вами откроется окно редактора заголовков, представленное на 
рис. 3.17. Кнопка Add New (крайняя левая) позволяет добавить новую секцию в 3a- 
головок, кнопка Delete Selected (вторая слева) — удалить секцию, кнопки Move 
Selected Up и Move Selected Down (кнопки со стрелками) позволяют изменять после- 
довательность секций. | 


Рис. 3.17 fea ->Columns 3 | 
Окно редактора заголовков on 
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После того, как вы добавили секцию и установили на ней курсор, в окне Ин- 
спектора Объектов появится множество свойств этого объекта. В свойстве Caption 
вы можете задать текст заголовка. В свойстве ImageIndex можете указать индекс 
пиктограммы, которая появится перед заголовком. Свойства MinWidth и 
Мах Width определяют соответственно минимальную и максимальную ширину за- 
головка в пикселях. Только в этих пределах пользователь может изменять ширину 
заголовка курсором мыши. Значение ширины по умолчанию задается значением 
свойства Width. При изменении ширины секции во время выполнения генериру- 

ется событие OnSectionResize. 
| На этом мы завершим обсуждение свойств и методов List View. Более деталь- 
ное рассмотрение вы можете найти в книге [2]. 


3.4.3 Отображение хода длительных процессов — 
компоненты ProgressBar и CGauge 


Компоненты ProgressBar со страницы библиотеки Win32 и CGauge со страни- 
цы Samples предназначены для отображения хода процессов, занимающих замет- 
ное время, например, копирования больших файлов, настройку приложения, ус- 
тановку приложения на комньютере и т.п. Пример возможных вариантов отобра- 
жения хода процесса компонентами ProgressBar и CGauge приведен на рис. 3.18. 


Рис. 3.18 | 
Пример отображения хода процесса компонентами 
ProgressBar и CGauge 
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Свойство Свойство |Описание 
ProgressBar | CGauge 


MaxValue | Максимальное значение позиции (Position, Progress), 
которое соответствует завершению отображаемого 
| процесса. По умолчанию задается в процентах — 100 
MinValue | Начальное значение позиции (Position, Progress), ко- 
торое соответствует началу отображаемого процесса 


| Position Progress Позиция, которую можно задавать по мере протека- 
ния процесса, начиная со значения Min или MinVa- 
lue в начале процесса, и кончая значением Мах или 
MaxValue в конце. Если минимальное и максималь- 
ное значения выражены в процентах, то позиция — 
это процент завершенной части процесса 
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| Свойство Свойство |Описание 
ProgressBar | CGauge 


Непрерывное (при значении true) или дискретное 
отображение процесса. На рис. 3.18 в горизонталь- 
ном компоненте ProgressBar задано Smooth = true, а 
в вертикальном — false 


Шаг приращения позиции, используемый в методе 
StepIt. Значение по умолчанию — 10 


Orientation Ориентация шкалы компонента: pbHorizontal — го- 
ризонтальная, pbVertical — вертикальная. Если за- 
дана ориентация pbVertical, то компонент надо вытя- 


нуть по вертикали (см. на рис. 3.18 компонент слева) 


|=.’ | ForeCotor | 


Цвет заполнения 


Тип диаграммы: gkHorizontalBar — горизонтальная 
полоса, gk VerticalBar — вертикальная полоса, gkPie 
— круговая диаграмма, gkNeedle — секторная диа- 

грамма, gkText — отображение текстом 


Отображение хода процесса можно осуществлять, задавая значение позиции 
— Position в ProgressBar или Progress в CGauge. Например, если полная длитель- 
ность процесса характеризуется значением целой переменной Count (объем всех 
копируемых файлов, число настроек, количество циклов какого-то процесса), а 
выполненная часть — целой переменной Current, то задавать позицию диаграммы 
в случае, если используются значения минимальной и максимальной позиции по 
умолчанию (т.е. 0 и 100), можно операторами 


ProgressBarl->Position = 100 * Current / Count; 
или 
Cgaugel->Progress = 100 * Current / Count; 


соответственно для ProgressBar и CGauge. 

Можно поступать иначе: задать сначала значение максимальной величины 
равным Count, а затем в ходе процесса задавать позицию равной Current. Напри- 
мер: 


CGaugel->MaxValue Count; 


CGaugel->Progress = Current; 


Компонент ProgressBar имеет два метода, которыми тоже можно воспользо- 
ваться для отображения процесса: StepBy(Delta: Integer) — увеличение позиции 
на заданную величину Delta, и StepIt — увеличение позиции на один шаг, величи- 
на которого задается свойством Step. Ниже приведен пример использования мето- 
да Steplt: 


ProgressBarl->Max = Count; 
ProgressBarl->Step = 1; 


ProgressBarl->StepIt(); 


0 Зак. 322 
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3.4.4 Таблицы изображений — компоненты DrawGrid 
и StringGrid 


Компонент DrawGrid используется для создания в приложении таблицы, ко- 
торая может содержать графические изображения (см. пример на рис. 3.19). Этот 
компонент подобен компоненту StringGrid (см. раздел 3.2.6), поскольку послед- 
ний является производным от DrawGrid. Поэтому в DrawGrid присутствуют все 
свойства, методы, события компонента StringGrid, кроме относящихся к тексту, 
т.е. кроме свойств Cells, Cols, Rows, Objects. С этой точки зрения компонент 
StringGrid обладает существенно большими возможностями, чем DrawGrid, по- 
скольку он может хранить в ячейках и изображения, и тексты. А если вы захотите 
внести текст в какие-то ячейки DrawGrid, то вам надо будет использовать для это- 
го методы вывода текста на канву, что не очень удобно. 


Е 


Рис. 3.19 ||, Таблица Огаб и 


Пример таблицы DrawGrid 


Рассмотрим свойства компонентов DrawGrid и StringGrid, относящиеся к изо- 
бражениям, поскольку свойства StringGrid, относящиеся к тексту, уже рассмат- 
ривались в разделе 3.2.6. 

Компоненты DrawGrid и StringGrid имеют канву Canvas, на которой можно 
размещать изображения методами, изложенными в главе 5. Имеется метод 
CellRect, который возвращает область канвы, отведенную под заданную ячейку. 
Этот метод определен как 


Windows::TRect _fastcall CellRect(int ACol, int ARow); 


где ACol и ARow — индексы столбца и строки, начинающиеся с 0, Ha пересечении 
которых расположена ячейка. Возвращаемая этой функцией область является об- 
ластью канвы, в которой можно рисовать необходимое изображение. Например, 
оператор 


DrawGridl->Canvas->CopyRect (DrawGridl->CellRect(1,1), 
BitMap->Canvas, Rect (0,0, BitMap->Height, BitMap->Width) ) ; 


копирует методом CopyRect (см. главу 5 раздел 5.1.5.2.) в ячейку (1,1) таблицы 
DrawGridl изображение из компонента ВИМар. Эта ячейка является второй слева 
и второй сверху в таблице, поскольку индексы начинаются с 0. Учтите, что если 
размеры ячейки меньше, чем размер копируемого изображения, то в ячейке поя- 
вится только левая верхняя часть картинки. 

Изображение на канве компонентов DrawGrid и StringGrid, как и на канве 
любого компонента, подвержено стиранию при перекрытии окна приложения дру- 
гими окнами или, например, при сворачивании приложения. Поэтому необходимо 
принимать меры, описанные в главе 5 в разделе 5.1.7, чтобы с помощью обработ- 
чика событий OnPaint восстанавливать испорченное изображение. Это делает KOM- 
понент DrawGrid не слишком удобным для использования. 

Все свойства и события, позволяющие определить выбранную пользователем 
ячейку таблицы, были рассмотрены в разделе 3.2.6. Там же вы найдете описание 
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свойств, отвечающих за внешний вид и допустимость перестройки пользователем 
таблицы во время выполнения приложения. 


3.4.5 Отображение форм — компонент Shape 


Компонент Shape представляет собой различные геометрические фигуры, со- 
ответствующим образом заштрихованные. Основное свойство этого компонента — 
Shape (форма), которое может принимать значения: 


[stRectangle квадрат 


| 


istRoundRect | прямоугольник со stRoundSquare | квадрат со скругленны- 
| скругленными углами || ми углами 
| stEllipse эллипс stCircle круг 


Примеры этих форм показаны на рис. 3.20. 


Рис. 3.20 Shape = stCircle Shape = stEllipse _ 
Brush-> Style = bsSolid Brush->Style = bsBDiagonal 
Примеры компонента Shape 
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Shape =stSquae === Shape = stRoundSquare _ 
Brush->Style = bsClear Brush->Style = bsCross 


Shape = stRectangle = | Shape =stHoundRect 
Brush-> Style = bsDiagCross Brush-> Style = bsFDiagonal 


Другое существенное свойство компонента — Brush (кисть). Это свойство AB- 
ляется объектом типа TBrush, имеющим ряд подсвойств, в частности: цвет 
(Brush.Color) и стиль (Brush.Style) заливки фигуры. Заливку при некоторых зна- 
чениях Style вы можете видеть на рис. 3.20. Третье из специфических свойство 
компонента Shape — Реп (перо), определяющее стиль линий. Свойства Brush и 
Реп подробно рассмотрены в главе 5. Справочные данные об этих свойствах вы мо- 
жете найти в главе 16. 


3.4.6 Графики и диаграммы — компонент Chart 


Компонент Chart позволяет строить различные диаграммы и графики, KOTO- 
рые выглядят очень эффектно (рис. 3.21). Компонент имеет множество свойств, 
методов, событий, так что если все их рассматривать, то этому пришлось бы посвя- 
тить целую главу. Поэтому ограничимся рассмотрением только основных характе- 
ристик Chart. А с остальными вы можете ознакомиться во встроенной справке 
C++Builder или просто опробовать их, экспериментируя с диаграммами. 

Компонент Chart является контейнером объектов Series типа TChartSeries — 
серий данных, характеризующихся различными стилями отображения. Каждый 
компонент может включать несколько серий. Если вы хотите отображать график, 
то каждая серия будет соответствовать одной кривой на графике. Если вы хотите 
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Р 1; Демонстрация компонента Chart 1. Демонстрация комлонента Chart 
ис. 3.21 


Пример приложения с 
диаграммами: начальное 
состояние (а) и 
состояние при 
изменении типа 
диаграммы и увеличении 
фрагмента графика (6) 


отображать диаграммы, то для некоторых видов диаграмм можно наложить друг 
на друга несколько различных серий, для других (например, для круговых диа- 
грамм) это, вероятно, будет выглядеть некрасиво. Однако, и в этом случае вы мо- 
жете задать для одного компонента Chart несколько серий одинаковых данных с 
разным типом диаграммы. Тогда, делая в каждый момент времени активной одну 
из них, вы можете предоставить пользователю выбор типа диАгреммы, отображаю- 
щей интересующие его данные. 

Разместите один или два (если захотите воспроизвести рис. 3.21) компонента 
Chart на форме и посмотрите открывшиеся в Инспекторе Объектов свойства. При- 
ведем пояснения некоторых из них. 


AllowPanning Определяет возможность пользователя т прокручивать наблюда- 
емую часть графика во время выполнения, нажимая правую 
кнопку мыши. Возможные значения: ртМопе — прокрутка 
запрещена, pmHorizontal, pmVertical или pmBoth — разре- 
шена соответственно прокрутка только в горизонтальном Ha- 
правлении, только в вертикальном или в обоих направлениях 


С ELE RELL ONT EDULE IRE TRE SE 


AllowZoom Позволяет пользователю изменять во время выполнения мас- 
штаб изображения, вырезая фрагменты диаграммы или гра- 
фика курсором мыши (на рис. 3.21 6 внизу показан момент 
просмотра фрагмента графика, целиком представленного на 


рис. 3.21 а) 
Title Определяет заголовок диаграммы 
Foot Определяет подпись под диаграммой. По умолчанию отсутст- 
вует. Текст подписи определяется подсвойством Text 
Frame Определяет рамку вокруг диаграммы 
Legend Легенда диаграммы — список обозначений 
MarginLeft, Значения левого, правого, верхнего и нижнего полей 
MarginRight, 
MarginTop, 
MarginBottom 
BottomAxis, Эти свойства определяют характеристики соответственно 
LeftAxis, нижней, левой и правой осей. Задание этих свойств имеет 
RightAxis смысл для графиков и некоторых типов диаграмм 
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LeftWall, Эти свойства определяют характеристики соответственно ле- 
Bottom Wall, вой, нижней и задней граней области трехмерного отображе- 
BackWall ния графика (см. рис. 3.21 a, нижний график) 

SeriesList Список серий данных, отображаемых в компоненте 

View3d Разрешает или запрещает трехмерное отображение диаграммы 


View3DOptions Характеристики трехмерного отображения 


Chart3DPercent Масштаб трехмерности (для рис. 3.21 это толщина диаграммы 
и ширина лент графика) 


Рядом со многими из перечисленных свойств в Инспекторе Объектов располо- 
жены кнопки с многоточием, которые позволяют вызвать ту или иную страницу 
Редактора Диаграмм — многостраничного окна, позволяющего установить все 
свойства диаграмм. Вызов Редактора Диаграмм возможен также двойным щелч- 
ком на компоненте Chart или щелчком на нем правой кнопкой мыши и выбором 
команды Edit Chart во всплывшем меню. 

Если вы хотите попробовать воспроизвести приложение, показанное на 
рис. 3.21, сделайте двойной щелчок на верхнем компоненте Chart. Вы попадете в 
окно Редактора Диаграмм (рис. 3.22) на страницу Chart, которая имеет несколько 
закладок. Прежде всего вас будет интересовать на ней закладка Series. Щелкните 
на кнопке Add — добавить серию. Вы попадете в окно (рис. 3.23), в котором вы MO- 
жете выбрать тип диаграммы или графика. В данном случае выберите Р!е — круго- 
вую диаграмму. Воспользовавшись закладкой Titles вы можете задать заголовок диа- 
граммы, закладка Legend позволяет задать параметры отображения легенды диа- 
граммы (списка обозначений) или вообще убрать ee с экрана, закладка Panel опреде- 
ляет вид панели, на которой отображается диаграмма, закладка 3D дает вам воз- 
можность изменить внешний вид вашей диаграммы: наклон, сдвиг, толщину ит.д. 


Рис. 3.22 
Редактор Диаграмм, страница Chart, 
закладка Series 


nd] Panel | Paging| Wats | 32 |. 


Когда вы работаете с Редактором Диаграмм и выбрали тип диаграммы, в KOM- 
понентах Chart на вашей форме отображается ее вид с занесенными в нее условны- 
ми данными (см. рис 3.24). Поэтому вы сразу можете наблюдать результат приме- 
нения различных опций к вашему приложению, что очень удобно. 

Страница Series, также имеющая ряд закладок, дает вам возможность выбрать 
дополнительные характеристики отображения серии. В частности, для круговой 
диаграммы на закладке Format полезно включить опцию Circled Pie, которая обеспе- 
чит при любом размере компонента Chart отображение диаграммы в виде круга. Ha 
закладке Marks кнопки группы Style определяют, что будет написано на ярлычках, 
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Рис. 3.23 1G? TeeChart Gallery 
Выбор типа диаграммы в Редакторе ) Standasd | Fu pea 
Диаграмм : ВИ 

Рис. 3.24 


Форма приложения рис. 3.21 с занесенными в нее 
условными данными 


относящихся к отдельным сегментам диаграммы: Value — значение, Percent — про- 
центы, Label — названия данных и т.д. В примере рис. 3.21 включена кнопка 
Percent, а на закладке General установлен шаблон процентов, обеспечивающий ото- 
бражение только целых значений. 

Вы можете, если хотите, добавить на этот компонент Chart еще одну тождест- 
венную серию, нажав на закладке Series страницы Chart кнопку Clone, а затем для 
этой новой серии нажать кнопку Change (изменить) и выбрать другой тип диаграм- 
мы, например, Bar. Конечно, два разных типа диаграммы на одном рисунке будут 
выглядеть плохо. Но вы можете выключить индикатор этой новой серии на за- 
кладке Series, а потом предоставить пользователю выбрать тот или иной вид ото- 
бражения диаграммы (ниже будет показано, как это делается). 

Выйдите из Редактора Диаграмм, выделите в вашем приложении нижний 
компонент Chart и повторите для него задание свойств с помощью Редактора Диа- 
грамм. В данном случае вам надо будет задать две серии, если хотите отображать 
на графике две кривые, и выбрать тип диаграммы Line. Поскольку речь идет о гра- 
фиках, вы можете воспользоваться закладками Axis и Walls для задания координат- 
ных характеристик осей и трехмерных граней графика. 
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На этом проектирование внешнего вида приложения заверитается. Осталось 
написать код, задающий данные, которые вы хотите отображать. Для тестового 
приложения давайте зададим в круговой диаграмме просто некоторые констант- 
ные данные, а в графиках — функции синус и косинус. 

Для задания отображаемых значений надо использовать методы серий Series. 
Остановимся только на трех основных методах. 


Метод Clear очищает серию от занесенных ранее данных. 
Метод Add: 


long int Add(const double AValue, 
const String ALabel, TColor AColor); 


позволяет добавить в диаграмму новую точку. Параметр AValue соответствует до- 
бавляемому значению, параметр ALabel — название, которое будет отображаться 
на диаграмме и в легенде, АСо]ог — цвет. Параметр ALabel — не обязательный, 
его можно задать пустым: «>». 

Метод AddXY: 


long int AddXY(const double AValue, 
- const String ALabel, TColor AColor); 


позволяет добавить новую точку в график функции. Параметры AX Value и AYVa- 
lue соответствуют аргументу и функции. Параметры ALabel и AColor те же, что и 
в методе Add. 

Таким образом, процедура, обеспечивающая загрузку данных в нашем приме- 
ре, может иметь вид: 


int Al=155; 
int A2=251; 
int A3=203; 
int A4=404; 
const Pi=3.14159; 


Seriesl->Clear(); 
Seriesl->Add (Al, "Uex 1",clYellow) ; 
Seriesl->Add(A2,"Uex 2",clBlue) ; 
бег1е51->Ааа (АЗ, "Цех 3",clRed) ; 
Зег1ез1->Ааа (А4,"Цех 4",clPurple) ; 
Series2->Clear(); 
Series3->Clear(); 


for (int:i = 0; i <= 100; i++) 

{ 

Series2->AddXY (0.02*Pi*i,sin(0.02*Pi*i),"",clRed); 
Series3->AddxXY (0.02*Pi*i,cos(0.02*Pi*i),"",clBlue); 


} 


Эту процедуру можно включить в обработку щелчка какой-нибудь кнопки, в 
команду меню или просто в событие OnCreate формы. Операторы Clear нужны, 
если в процессе работы приложения вы собираетесь обновлять данные. Без этих 
операторов повторное выполнение методов Add и AddXY только добавит новые 
точки, не удалив прежние. 

Если вы предусмотрели, например, для данных, отображаемых в диаграмме, 
две серии Seriesl и Series4 разных видов — Реи Bar, то можете ввести процедуру, 
изменяющую по требованию пользователя тип диаграммы. Эту процедуру можно 
ввести в событие OnClick какой-нибудь кнопки, в команду меню или, например, 
просто в обработку щелчка на компоненте Chart. Для того, чтобы загрузить дан- 
ные в Series4 и сделать эту диаграмму в первый момент невидимой, можно вста- 
вить в конце приведенной ранее процедуры операторы 


Series4->Assign(Series1) ; 
Series4->Active = false; 
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Первый из этих операторов переписывает данные, помещенные в Земе$ 1, в се- 
puro Series4. А второй оператор делает невидимой серию Series4. Смену типа диа- 
граммы осуществляет процедура 


Seriesl->Active ' Seriesl->Active; 
Series4->Active = ! Series4->Active; 


На рис. 3.21 6 вы можете видеть результат переключения пользователя на 
другой вид диаграммы. 


3.4.7 Графики и диаграммы — компоненты Chartfx и Graph 


В C++Builder 5 на странице ActiveX имеется несколько интересных компонен- 
тов, предназначенных для отображения диаграмм и графиков. Отметим, в частно- 
сти, уже рассмотренный нами в разделе 3.3.4 компонент F1Book. Ha приводив- 
шемся в этом разделе рис. 3.11 показано, как можно использовать Е1Воок для ото- 
бражения диаграмм и графиков данных, занесенных в таблицу. 

Еще одним интересным компонентом на странице ActiveX является Chartfx. 
Он представляет собой законченный редактор диаграмм со встроенной инструмен- 
тальной панелью (рис. 3.25). Нажимая кнопки инструментальной панели пользо- 
ватель может задавать новые данные (самая правая кнопка на рис. 3.25 и выбор 
опции Data Editor), изменять тип диаграммы, сохранять диаграмму в файле с рас- 
ширением .chf или загружать ее из аналогичного файла, копировать диаграмму в 
буфер обмена Clipboard и таким образом включать ее в другие документы (напри- 
мер, в документы Word) и т.п. 


Рис. 3.25 1, Товар склада 1 
Приложение на основе | lice [74 
компонента Chartfx = : ees 


Как и в других компонентах ActiveX, доступ к свойствам Chartfx во время 
проектирования может осуществляться с помощью Инспектора Объектов или 
щелчком правой кнопки мыши и выбором из всплывшего меню команды Properties 
(Свойства). При выборе этой команды вы попадете в многостраничное диалоговое 
окно (см. рис. 3.26), позволяющее задать свойства компонента. Остановимся толь- 
ко на нескольких из них, которые вы можете задавать в этом диалоге, в Инспекто- 
ре Объектов или программно. 

Свойство Series на странице Data Values (рис. 3.26 а) диалога (в Инспекторе 
Объектов это свойство названо NSeries) обозначает число серий данных (на 
рис. 3.25 равно 2). Свойство Points на той же странице диалога (в Инспекторе Объ- 
ектов оно названо NValues) обозначает число значений по оси аргументов (на 
рис. 3.25 равно 4). Страница диалога Elements позволяет задать какие-то характер- 
ные уровни (опции Value — Text, на рис. 3.25 отмечен уровень 40 с текстом «Мини- 


| 
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Рис. 3.26 
Окно задания свойств компонента Chartfx: 
страницы Data Values (а) и Шрифты (6) 
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мально допустимый запас»), выделить цветом какие-то полосы уровней (опции 
From — То — Color, на рис. 3.25 выделены полосы 0 — 20 и 20 — 40), задать текст в 
строке состояния (опции ID — Width — Text). Прочие свойства позволяют задать тек- 
сты вверху диаграммы, внизу, слева, справа, задать координатные сетки и многое 
другое. Следует обратить внимание на выбор шрифтов на странице Шрифты 
(рис. 3.26 6). Шрифты, естественно, надо выбрать такие, которые содержат симво- 
лы кириллицы. При выборе шрифтов надо сначала в выпадающем списке Свойст- 
во выбрать надпись, для которой указывается шрифт (например, TopFont — 
шрифт надписи над диаграммой), а затем в окнах Шрифт, Начертание, Размер уста- 
новить атрибуты шрифта. Подобную процедуру надо повторить для всех надписей. 

Теперь давайте коротко рассмотрим некоторые кнопки инструментальной па- 
нели компонента во время выполнения приложения (см. рис. 3.25). Первая и вто- 
рая слева быстрые кнопки обеспечивают соответственно чтение и сохранение диа- 
граммы. Диаграмма сохраняется в файле с расширением .chf и может быть прочи- 
тана в последующих сеансах работы. Третья кнопка слева заносит диаграмму в бу- 
фер обмена Clipboard, откуда ее можно взять в каком-то другом приложении (на- 
пример, в Word) и вставить в документ. Кнопки в центральной части панели по- 
зволяют изменять тип диаграммы или графика. Поэкспериментируйте с ними и 
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вы легко поймете, что они означают. Вторая справа группа кнопок позволяет вво- 
дить на диаграмме или графике координатную сетку. Правая группа кнопок обес- 
печивает задание надписей на изображении, выбор шрифта надписей и т.п. Глав- 
ной из этих кнопок является крайняя правая. Она вызывает выпадающее меню, 
содержащее, в частности, раздел Data Editor. Если вы выберете этот раздел, вместо 
диаграммы вы увидите окно редактора данных, отображаемых на графике или в 
диаграмме. Сделав двойной щелчок на том или ином числе, вы можете изменить 
его. После того, как вы отредактировали данные, опять щелкните на второй спра- 
ва кнопке инструментальной панели и снимите выделение с раздела Data Editor. Вы 
опять увидите диаграмму, отображающую введенные вами данные. 


Более простым, но, возможно, более полезным на странице библиотеки 
ActiveX является компонент Graph (рис. 3.27). Он позволяет отображать данные в 
виде диаграмм различных типов. Настройку можно проводить так же, как и в дру- 
гих компонентах ActiveX, или в Инспекторе Объектов, или командой Properties из 
меню, всплывающего при щелчке правой кнопкой мыши на компоненте. В много- 
страничном диалоговом окне, всплывающем при выполнении этой команды, на 
странице Graph можно выбрать тип диаграммы или графика (опция GraphType) и 
число точек аргумента (NumPoints). На странице Data можно задать данные: 
GraphData — значения функции в различных точках, XPosData — значения аргу- 
ментов в этих точках, ColorData — значения цветов в точках (для диаграмм). Oc- 
тальные опции достаточно похожи на те, которые рассматривались для предыду- 
щих компонентов. 


Рис. 3.27 Я, Компонент Graph 
Приложение на основе компонента Graph 


Выпуск продукции по 
кварталам 


Во время выполнения приложения задать новые данные, отредактировать их, 
настроить график или диаграмму можно методом BrowseProperties. Например, 
оператор 


Graphl->BrowseProperties (); 


вызовет то же многостраничное окно свойств, которое вы видите во время проекти- 
рования, выполняя команду Properties из всплывающего меню компонента. В этом 
окне можно задать или отредактировать всю отображаемую компонентом инфор- 
мацию. Изменять во время выполнения данные и способ их отображения можно 
также задавая значения свойствам компонента, большинство из которых вы може- 
те видеть в процессе проектирования в окне Инспектора Объектов. 
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3.5 Кнопки, индикаторы, управляющие элементы 


3.5.1 Управляющие кнопки Button и BitBtn 


На рис. 3.28 показаны примеры кнопок Button, BitBtn и рассмотренной в сле- 
дующем разделе кнопки ЗреедВи Йоп. Простейшей и, пожалуй, наиболее часто ис- 
пользуемой кнопкой является кнопка Button (на рис. 3.28 в верхнем левом углу 
формы), расположенная на странице библиотеки Standard. Реже используется 
кнопка BitBtn (на рис. 3.28 справа), отличающаяся, прежде всего, возможностью 
отобразить на ее поверхности изображение. Большинство свойств, методов и собы- 
тий у этих видов кнопок одинаковы. 

Рис. 3.28 |1 m8 Mile) Es 


Примеры кнопок 
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Основное с точки зрения внешнего вида свойство кнопки — Caption (надпись). 
В надписях кнопок можно предусматривать использование клавиш ускоренного 
доступа, выделяя для этого один из символов надписи. Перед символом, который 
должен соответствовать клавише ускоренного доступа, ставится символ амперсан- 
та «&». Этот символ не появляется в надписи, а следующий за ним символ оказы- 
вается подчеркнутым. Тогда пользователь может вместо щелчка на кнопке нажать 
в любой момент клавишу All совместно с клавишей выделенного символа. 

Например, если в вашем приложении имеется кнопка выполнения какой-то 
операции, вы можете задать ее свойство Caption равным «&Выполнить». На кноп- 
ке эта надпись будет иметь вид «Выполнить». И если пользователь нажмет клави- 
ши Alt-B, то это будет эквивалентно щелчку на кнопке. 

Основное событие любой кнопки — OnClick, возникающее при щелчке на ней. 
Именно в обработчике этого события записываются операторы, которые должны 
выполняться при щелчке пользователя на кнопке. Помимо этого есть еще ряд со- 
бытий, связанных с различными манипуляциями клавишами и кнопками мыши. 
Эти события подробно рассмотрены в главе 4 разделе 4.3. 

Свойство Cancel, если установить его в true, определяет, что нажатие пользо- 
вателем клавиши Esc будет эквивалентно щелчку на данной кнопке. Это свойство 
целесообразно задавать равным true для кнопок Отменить в различных диалого- 
вых окнах, чтобы можно было выйти из диалога, нажав на эту кнопку или нажав 
клавишу Esc. 

Свойство Default, если его установить в true, определяет, что нажатие пользо- 
вателем клавиши ввода Enter будет эквивалентно нажатию на данную кнопку, даже 
если данная кнопка в этот момент не находится в фокусе. Правда, это сработает, 
если в фокусе находится какой-то оконный компонент. Если же в момент нажатия 
Enter в фокусе находится другая кнопка, то все-таки сработает именно кнопка в фо- 
кусе. 

Еще одно свойство — ModalResult используется в модальных формах, KOTO- 
рые будут рассмотрены в разделе 4.5.2. В обычных приложениях значение этого 
свойства должно быть равно шгМопе. 
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Из методов, присущих кнопкам, имеет смысл отметить один — Click. Выпол- 
нение этого метода эквивалентно щелчку на кнопке, т.е. вызывает событие кнопки 
OnClick. Этим можно воспользоваться, чтобы продублировать какими-то другими 
действиями пользователя щелчок на кнопке. Пусть, например, вы хотите, чтобы 
при нажатии пользователем клавиши с символом «С» или «с» в любой момент ра- 
боты с приложением выполнялись операции, предусмотренные в обработчике со- 
бытия OnClick кнопки Ви Йоп1. Поскольку неизвестно, какой компонент будет на- 
ходиться в фокусе в момент этого события, надо перехватить его на уровне формы. 
Такой перехват осуществляется, если установить свойство формы KeyPreview в 
true (см. раздел 4.3.2). Тогда в обработчике события формы OnKeyPresss можно 
написать оператор 


if ((Кеу=='С') || (Key=='c')) Buttonl->Click(); 


Если пользователь ввел символ «С» ИЛИ «с», то в результате будет выполнен 
обработчик щелчка кнопки Ви Йоп1. 

Все сказанное выше в равной степени относится и к Button, и к BitBtn. Pac- 
смотрим теперь особенности кнопки с пиктограммой BitBtn. Изображение на этой 
кнопке задается свойством Glyph. При нажатии кнопки с многоточием в строке 
свойства Glyph в Инспекторе Объектов вызывается окно, представленное на 
рис. 3.29. Нажав в нем кнопку Load вы перейдете в обычное окно открытия файла 
рисунка и можете выбрать файл битовой матрицы .bmp, содержащий желаемое 
изображение. В частности, с C++Builder поставляется большое количество изобра- 
жений для кнопок. Они расположены в каталоге \lmages\Buttons, а сам каталог 


Images в C++Builder 5 обычно расположен в каталоге ...\Program Files\Borland\Borland 
Shared. 


Puc. 3.29 
Окно редактора пиктограммы 


После того, как вы выбрали изображение, нажмите ОК и выбранное изображе- 
ние появится на вашей кнопке левее надписи. 

Файл изображения для кнопки может содержать до четырех изображений 
пиктограмм размера 16х16. Самое левое соответствует отжатой кнопке. Второе 
слева соответствует недоступной кнопке, когда ее свойство Enabled равно false. 
Третье слева изображение используется при нажатии пользователя на кнопку при 
ее включении. Четвертое слева изображение используется в кнопках с фиксацией 
SpeedButton, о которых будет сказано позднее, для изображения кнопки в нажа- 
том состоянии. Большинство изображений для кнопок использует две пиктограм- 
мы. Число пиктограмм вы можете узнать из свойства кнопки NumGlyphs, которое 
после загрузки изображения покажет вам число пиктограмм в нем. Подробнее об 


изображениях на кнопках и о создании своих собственных пиктограмм см. в разде- 
ле 5. 1 ем: Я 4 
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Расположение изображения и надписи на кнопке определяется свойствами 
Margin, Layout и Spacing. Если свойство Margin равно -1 (значение по умолча- 
нию), то изображение и надпись размещаются в центре кнопки. При этом положе- 
ние изображения по отношению к надписи определяется свойством Layout, кото- 
poe может принимать значения: bIGlyphLeft (слева, это значение принято по умол- 
чанию — см. верхнюю кнопку BitBtn на рис. 3.28), blGlyphRight (справа), 
blGlyphTop (вверху), blGlyphBottom (внизу — см. нижнюю кнопку BitBtn на 
рис. 3.28). Если же Margin > 0, то в зависимости от значения Layout изображение 
и надпись смещаются к той или иной кромке кнопки, отступая от нее на число 
пикселей, заданное значением Margin. 

Свойство Spacing задает число пикселей, разделяющих изображение и над- 
пись на поверхности кнопки. По умолчанию Spacing = 4. Если задать Spacing = 0, 
изображение и надпись будут размещены вплотную друг к другу. Если задать 
Spacing = -1, то текст появится посередине между изображением и краем кнопки. 

Еще одно свойство BitBtn — свойство Kind определяет тип кнопки. По умол- 
чанию значение этого свойства равно bkCustom — заказная. Но можно установить 
и множество других предопределенных типов: bkOK, bkCancel, bkHelp, bkYes, 
bkNo, bkClose, bkAbort, bkRetry, bkIgnore, bkAll. В этих типах уже сделаны со- 
ответствующие надписи, введены пиктограммы, заданы еще некоторые свойства. 
Обычно все-таки лучше ими не пользоваться. Во-первых, надписи все равно надо 
переводить на русский язык. Во-вторых, предопределенные рисунки обычно выби- 
ваются из общего стиля конкретного приложения. И главное — предопределение 
некоторых свойств, не учтенных вами, может иногда приводить к странным ре- 
зультатам работы. Уж лучше использовать заказные кнопки и самому устанавли- 
вать в них все необходимые свойства. 


3.5.2 Кнопка с фиксацией SpeedButton 


Кнопки SpeedButton имеют возможность отображения пиктограмм и могут 
использоваться как обычные управляющие кнопки или как кнопки с фиксацией 
нажатого состояния (см. на рис. 3.28). Обычно они используются в качестве быст- 
рых кнопок, дублирующих различные команды меню, и в инструментальных па- 
нелях, в которых требуется фиксация нажатого состояния. 

У кнопок SpeedButton, как и у других кнопок, имеется свойство Caption — 
надпись, но в этих кнопках оно обычно оставляется пустым, так как вместо надпи- 
си используется пиктограмма. Изображение на кнопке задается свойством Glyph 
точно так же, как описано в разделе 3.5.1 для кнопок BitBtn. И точно так же свой- 
ство NumGlyphs определяет число используемых пиктограмм, свойства Layout и 
Margin определяют расположение изображения, а свойство Spacing — расстояние 
между изображением и надписью (если, конечно, вы все-таки хотите использовать 
надпись на кнопке). 

Особенностью кнопок SpeedButton являются свойства GroupIndex (индекс 
группы), АПомАПОр (разрешение отжатого состояния всех кнопок группы) и 
Down (исходное состояние — нажатое). Если GroupIndex = 0, то кнопка ведет себя 
так же, как Button и BitBtn. При нажатии пользователем кнопки она погружает- 
ся, а при отпускании возвращается в нормальное состояние. В этом случае свойст- 
ва AllowAllUp и Down не влияют на поведение кнопки. 

Если GroupIndex > 0 u AllowAllUp = true, то кнопка при щелчке пользовате- 
ля на ней погружается и остается в нажатом состоянии. При повторном щелчке 
пользователя на кнопке она освобождается и переходит в нормальное состояние 
(именно для того, чтобы освобождение кнопки состоялось, необходимо задать 
AllowAllUp = true). Если свойство Down во время проектирования установлено 
равным true, то исходное состояние кнопки — нажатое. 
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Если есть несколько кнопок, имеющих одинаковое ненулевое значение 
GroupIndex, то они образуют группу взаимосвязанных кнопок из которых нажа- 
той может быть только одна. Если одна кнопка находится в нажатом состоянии и 
пользователь щелкает на другой, то первая кнопка освобождается, а вторая фикси- 
руется в нажатом состоянии. Поведение нажатой кнопки при щелчке на ней завис- 
ти от значения свойства AllowAllUp. Если оно равно true, то кнопка освободится, 
поскольку в этом случае возможно состояние, когда все кнопки группы отжаты. 
Если же AllowAllUp равно false, то щелчок на нажатой кнопке не приведет к из- 
менению вида кнопки. Впрочем, и в этом случае, как и при любом щелчке на кноп- 
Ke, возникает событие OnClick, которое может быть обработано. 

Состояние кнопки во время выполнения можно определить по значению свой- 
ства Down: если значение равно true, то кнопка нажата. Во время события OnClick 
значение Down уже равно тому состоянию, которое примет кнопка в результате 
щелчка на ней. 


3.5.3 Группы радиокнопок — компоненты RadioGroup, 
RadioButton и GroupBox 


Радиокнопки образуют группы взаимосвязанных индикаторов, из которых 
обычно может быть выбран только один. Они используются для выбора пользова- 
телем одной из нескольких взаимоисключающих альтернатив, например, отдела, 
в котором работает сотрудник, или пола сотрудника. Впрочем, радиокнопки могут 
использоваться не только для выбора, но и для отображения аналогичных данных. 
В этом случае управление кнопками осуществляется программно. Примеры разме- 
щения радиокнопок вы можете увидеть на рис. 3.30. 
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Начнем рассмотрение радиокнопок с компонента RadioGroup — панели груп- 
пы радиокнопок. Это панель, которая может содержать регулярно расположенные 
столбцами и строками радиокнопки. Надпись в левом верхнем углу панели (см. 
рис. 3.30) определяется свойством Caption. А надписи кнопок и их количество оп- 
ределяются свойством Items, имеющим тип TStrings. Щелкнув на кнопке с много- 
точием около этого свойства в окне Инспектора Объектов, вы попадете в редактор 
списков строк, который уже рассматривался нами в разделе 3.2.4 (рис. 3.6). В нем 
вы можете занести надписи, которые хотите видеть около кнопок, по одной в стро- 
ке. Сколько строчек вы запишете — столько и будет кнопок. Например, для ком- 
понента RadioGroup в нижней части формы рис. 3.30 свойство Items имеет вид: 
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‚ Кнопки, появившиеся в панели после задания значений Items, можно размес- 
тить в несколько столбцов (не более 17), задав свойство Columns. По умолчанию 
Columns = 1, т.е. кнопки размещаются друг под другом. На рис. 3.30 задано 
Columns = 3. 

Определить, какую из кнопок выбрал пользователь, можно по свойству 
ItemIndex, которое показывает индекс выбранной кнопки. Индексы, как всегда в 
C++Builder, начинаются с 0. По умолчанию ItemIndex = -1, что означает отсутст- 
вие выбранной кнопки. Если вы хотите, чтобы в момент начала выполнения при- 
ложения какая-то из кнопок была выбрана (это практически всегда необходимо), 
то надо установить соответствующее значение ItemIndex во время проектирова- 
ния. Если вы используете радиокнопки не для ввода, а для отображения данных, 
устанавливать значение ItemIndex можно программно во время выполнения при- 
ложения. - 

Компонент RadioGroup очень удобен, но не свободен OT некоторых недостат- 
ков. Его хорошо использовать, если надписи кнопок имеют примерно одинаковую 
длину и если число кнопок в каждом столбце (при размещении их в нескольких 
столбцах) одинаково. Например, на рис. 3.30 группа радиокнопок в верхнем левом 
углу формы имеет нормальный вид. А группа аналогичных радиокнопок в нижней 
части формы выглядит плохо: она занимает слишком много места, которое пропа- 
дает впустую. Связано это с тем, что длина надписей у кнопок первого столбца пре- 
вышает длину надписей у остальных кнопок. А RadioGroup при размещении кно- 
пок ориентируется на надпись максимальной длины. Еще хуже выглядела бы эта 
группа, если бы число кнопок было, например, равно 5. 

В подобных случаях желательно нерегулярное расположение кнопок. Такую 
возможность дают компоненты RadioButton, сгруппированные панелью GroupBox 
(в правом верхнем углу на рис. 3.30). Панель GroupBox выглядит на форме так же, 
как RadioGroup, и надпись в ee верхнем левом углу также определяется свойством 
Caption. Эта панель сама по себе пустая. Ее назначение — служить контейнером 
для других управляющих элементов, в частности, для радиокнопок RadioButton. 
Отдельная радиокнопка RadioButton особого смысла не имеет, хотя и может слу- 
жить индикатором, включаемым и выключаемым пользователем. Но в качестве 
индикаторов обычно используются другие компоненты — CheckBox. А радиокноп- 
ки имеют смысл, когда они взаимодействуют друг с другом в группе. Эта группа и 
объединяется единым контейнером, обычно панелью GroupBox. 

Рассмотрим свойства радиокнопки RadioButton. Свойство Caption содержит 
надпись, появляющуюся около кнопки. Значение свойства Alignment определяет, 
с какой стороны OT кнопки появится надпись: taLeftJustify — слева, 
taRightJustify — справа (это значение принято по умолчанию). Свойство Checked 
определяет, выбрана данная кнопка пользователем, или нет. Поскольку в начале 
выполнения приложения обычно надо, чтобы одна из кнопок группы была выбра- 
на по умолчанию, ее свойство Checked надо установить в true в процессе проекти- 
рования. Если вы поэкпериментируете, то заметите, что в true можно установить 
значение Checked только у одной кнопки из группы. 

Размещение кнопок RadioButton в панели GroupBox, как можно видеть из 
рис. 3.30, дает большую свободу по сравнению с компонентом RadioGroup и позво-. 
ляет разместить кнопки не регулярно. 

Радиокнопки RadioButton могут размещаться не только в панели GroupBox, 
но и в любой панели другого типа, а также непосредственно на форме. Группа 
взаимосвязанных кнопок в этих случаях определяется тем оконным компонентом, 
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который содержит кнопки. В частности, для радиокнопок, размещенных непо- 
средственно на форме, контейнером является сама форма. Таким образом, все 
кнопки, размещенных непосредственно на форме, работают как единая группа, 
т.е. только в одной из этих кнопок можно установить значение Checked в true. 


3.5.4 Индикаторы CheckBox и CheckListBox 


Индикаторы с флажком CheckBox (см. в нижней части рис. 3.30 раздела 
3.5.3) используются в приложениях в основном для того, чтобы пользователь мог 
включать и выключать какие-то опции, или для индикации состояния. При каж- 
дом щелчке пользователя на индикаторе его состояние изменяется, проходя в OO- 
щем случае последовательно через три значения: выделение (появление черной га- 
лочки), промежуточное (серое окно индикатора и серая галочка) и не выделенное 
(пустое окно индикатора). Этим трем состояниям соответствуют три значения 
свойства компонента State: cbChecked, сЪСгауед, cbUnchecked. Впрочем, эти три 
состояния допускаются только при значении другого свойства AllowGrayed рав- 
ном true. Если же AllowGrayed = false (значение по умолчанию), то допускается 
только два состояния: выделенное и не выделенное. И State, и AllowGrayed можно 
устанавливать во время проектирования или программно во время выполнения. 

Промежуточное состояние обычно используется, если индикатор применяется 
для отображения какой-то характеристики объекта. Например, если индикатор 
призван показать, какой регистр использовался при написании какого-то фраг- 
мента текста, то в случае, если весь текст написан в верхнем регистре индикатор 
может принимать выделенное состояние, если в нижнем — не выделенное, а если 
использовались оба регистра — промежуточное. 

Проверять состояние индикатора можно не только по значению State, но и по 
значению свойства Checked. Если Checked равно. true, то индикатор выбран, т.е. 
State = cbhChecked. Если Checked равно false, то State равно cbUnchecked или 
cbGrayed. Установка Checked в true во время проектирования или выполнения ав- 
томатически переключает State в cbhChecked. 

Как и в радиокнопке, в индикаторе CheckBox надпись задается свойством 
Caption, a ее размещение по отношению к индикатору — свойством Alignment. 

Еще один компонент, имеющий индикаторы — список CheckListBox. Это ана- 
лог рассмотренного в разделе 3.2.5 компонента ListBox, но около каждой строки 
списка имеется индикатор, состояние которого пользователь может изменять (см. 
рис. 3.7). Свойства, общие у CheckListBox и ListBox, мы рассматривать не будем, 
так как все, характеризующее этот компонент как список, рассмотрено в разделе 
3.2.5. А состояния индикаторов определяют два свойства: State и Checked. Оба эти 
свойства можно рассматривать как индексированные массивы, каждый элемент 
которого соответствует индексу строки. Общее количество элементов определяется 
свойством Count (только для чтения). Поскольку индексы начинаются с 0, TO ин- 
декс последнего элемента равен Count — 1. 

Свойства State и Checked можно устанавливать программно или читать, опре- 
деляя установки пользователя. Например, операторы 


CheckListBoxl->Checked[1] = true; 
CheckListBoxl->State[2] = cbGrayed; 


устанавливают индикатор второй строки списка CheckListBoxl в состояние вы- 
бранного, а индикатор третьей строки — в промежуточное состояние (вспомним, 
что индексы начинаются с 0). 

Оператор 


for (int i= 0; i < CheckListBoxl->Items->Count; itt) 
if (CheckListBox1l->Checked[i]) 


sob il le a a 
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проверяет состояние всех индикаторов списка, и для выбранных пользователем 
строк. осуществляет какие-то действия (в приведенном операторе на месте этих 
действий просто поставлено многоточие). 

В компоненте CheckListBox имеется также событие OnClickCheck, возникаю- 
щее при каждом изменении пользователем состояния индикатора. Его можно ис- 
пользовать для обработки результатов изменения. 


3.5.5 Ползунки и полосы прокрутки — компоненты 
TrackBar и $сгоЙВаг. 


Компонент TrackBar представляет собой элемент управления в виде ползунка, 
который пользователь может перемещать курсором мыши или клавишами во вре- 
мя выполнения. Таким образом, пользователь может управлять какими-то процес- 
сами: громкостью звука, размером изображения ит.п. На рис. 3.31 приведены раз- 
личные формы отображения ползунка. Как видно из рисунка, он может распола- 
гаться горизонтально, вертикально, иметь шкалу с различных сторон, иметь ка- 
кой-то выделенный диапазон шкалы. 


Рис. 3.31 


Различные варианты ползунков 


Основное свойство компонента — Position. Это свойство можно задавать во 
время проектирования или программно во время выполнения. При перемещении 
пользователем ползунка можно прочитать значение Position, характеризующее 
позицию, в которую пользователь переместил ползунок. Для возможности такого 
чтения служит событие OnChange. В обработчике этого события можно прочитать 
значение Position и использовать его для управления каким-то компонентом. 

Свойство Position — целое, значение которого может изменяться в пределах, 
задаваемых свойствами Min и Мах. По умолчанию Min = 0, Max = 10, так что 
Position может принимать только 11 значений — от 0 до 10. Если задать большее 
значение Мах, соответственно увеличится количество возможных значений 
Position в диапазоне Min — Мах. 

Свойство Orientation определяет ориентацию ползунка: trHorizontal — ropu- 
зонтальная, trVertical — вертикальная. 

Свойство TickMarks указывает размещение шкалы относительно компонента 
и может принимать значения: tmBottomRight — снизу или справа в зависимости 
от ориентации компонента (верхний и правый компоненты на рис. 3.31), 
tmTopLeft — сверху или слева в зависимости от ориентации компонента (нижний 
компонент на рис. 3.31), tmBoth — с обеих сторон (средний компонент на 
рис. 3.31). 

Свойство TickStyle определяет способ изображения шкалы. Оно может прини- 
мать значения: tsAuto — автоматическая прорисовка шкалы, tsNone — отсутст- 
Bue шкалы, tsManual — программное рисовавие шкалы с помощью метода 
SetTick(Value: Integer), который помещает метку шкалы в позицию, соответст- 
вующую величине Value. Метки, соответствующие началу и концу шкалы автома- 
тически размещаются и в случае TickStyle = tsManual. 

При TickStyle = tsAuto частота меток шкалы определяется свойством 
Frequency. Это свойство задает, сколько возможных значений Position лежит ме- 
жду метками. Например, если Frequency = 2, то метки ‘удут соответствовать толь- 
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ко каждому второму возможному значению позиции (такое значение Frequency 
задано в верхнем компоненте на рис. 3.31). 

Свойства LineSize и PageSize определяют, насколько смещается ползунок, 
если пользователь управляет им с помощью соответственно клавиш со стрелками 
или клавишами PageUp и PageDown. 

Свойства SelStart и SelEnd позволяют визуально выделить на шкале некото- 
рый диапазон (см. средний компонент на рис. 3.31), который о чем-то говорит 
‚ пользователю, например, рекомендуемый диапазон значений. При этом ничто не 
мешает пользователю выйти за пределы этого диапазона. 


Похож на ползунок по своим функциям и компонент ScrollBar, хотя выгля- 
дит он иначе и предназначен по замыслу для других целей. Этот компонент пред- 
ставляет собой стандартную линейку прокрутки Windows. Однако, он может ис- 
пользоваться и для целей прокрутки (впрочем, многие оконные компоненты 
C++Builder имеют собственные полосы прокрутки), и для управления, подобно 
компоненту TrackBar. 

Основные свойства ScrollBar — Position, Min и Мах те же, что у компонента 
TrackBar. Свойство Kind, определяющее горизонтальное или вертикальное распо- 
ложение полосы и принимающее соответственно значения SbHorizontal или 
sbVertical, аналогично свойству Orientation компонента TrackBar. 

Имеются два свойства, отсутствующие у TrackBar: SmallChange и Large- 
Change. Они определяют соответственно «малый» сдвиг при щелчке на кнопке в 
конце полосы или нажатии клавиши со стрелкой, и «большой» сдвиг при переме- 
щении на страницу щелчком рядом с бегунком или нажатием клавиш PageUp или 
PageDown. 

Событие, соответствующее перемещению пользователем бегунка полосы про- 
крутки — OnScroll. В процедуру обработчика этого события передается по ссылке 
параметр ScrollPos — позиция бегунка, которую можно читать, но можно и изме- 
нять, и передается параметр ScrollCode, характеризующий вид перемещения бе- 
гунка. Этот параметр может иметь значения: 


® 
И СЕ И ИС Е ИЛИ И ИАА НЕ ОИ Е И EEE ASG 


scLineUp, scLineDown «Малый» сдвиг: перемещение соответственно вверх 
или налево и вниз или вправо после нажатия кнопки 
полосы прокрутки или клавиши со стрелкой 


scPageUp, scPageDown «Большой» сдвиг: перемещение на страницу щелчком 
рядом с бегунком или нажатием клавиш PageUp или 


PageDown 
scPosition Пользователь переместил и освободил бегунок 
sceTrack Пользователь перемещает бегунок 
scTop, scBottom Бегунок перемещен соответственно в крайнюю верх- 


нюю или левую позицию и в крайнюю нижнюю или 
правую позицию 


scEndScroll Окончание перемещения 


В обработке события ScrollPos можно поместить операторы, перемещающие 
требуемую область формы или компонент, а можно поместить операторы, которые 
управляют некоторым компонентом, используя значение позиции бегунка Scroll- 
Pos. 


соот is Baia aah a ae 
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3.5.6 Таймер — компонент Timer 


Компонент Timer позволяет задавать в приложении интервалы времени. Тай- 
мер находит многочисленные применения: синхронизация мультипликации, за- 
крытие каких-то окон, с которыми пользователь долгое время не работает, вклю- 
чение хранителя экрана или закрытие связей с удаленным сервером при отсутст- 
вии действий пользователя, регулярный опрос каких-то источников информации, 
задание времени на ответ в обучающих программах — все это множество задач, в 
которых требуется задавать интервалы времени, решается с помощью таймера. 

Таймер — невизуальный компонент, который может размещаться в любом 
месте формы. Он имеет два свойства, позволяющие им управлять: Interval — ин- 
тервал времени в миллисекундах и Enabled — доступность. Свойство Interval за- 
дает период срабатывания таймера. Через заданный интервал времени после пре- 
дыдущего срабатывания, или после программной установки свойства Interval, или 
после запуска приложения, если значение Interval установлено во время проекти- 
рования, таймер срабатывает, вызывая событие OnTimer. В обработчике этого co- 
бытия записываются необходимые операции. 

Если задать Interval = 0 или Enabled = false, то таймер перестает работать. 
Чтобы запустить отсчет времени надо или задать Enabled = true, если установлено 
положительное значение Interval, или задать положительное значение Interval, 
если Enabled = false. 

Например, если требуется, чтобы через 5 секунд после запуска приложения 
закрылась форма — заставка, отображающая логотип приложения, на ней надо 
разместить таймер, задать в нем интервал Interval = 5000, а в обработчик события 
OnTimer вставить оператор Close, закрывающий окно формы. 

Если необходимо в некоторой процедуре запустить таймер, который отсчитал 
бы заданный интервал, например, 5 секунд, после чего надо выполнить некоторые 
операции и отключить таймер, это можно сделать следующим образом. При проек- 
тировании таймер делается доступным (Enabled = true), но свойство Interval зада- 
ется равным 0. Таймер не будет работать, пока в момент, когда нужно запустить 
таймер, не выполнится оператор 


Timerl->Interval = 5000; 


Через 5 секунд после этого наступит событие ОпТипег. В его обработчике надо 
задать оператор 


Timerl->Interval = 0; 


который отключит таймер, после чего можно выполнять требуемые операции. 
Другой эквивалентный способ решения задачи — использование свойства 

Enabled. В время проектирования задается значение Interval = 5000 и значение 

Enabled = false. В момент, когда надо запустить таймер выполняется оператор 


Timerl->Enabled = true; 


В обработчик события OnTimer, которое наступит через 5 секунд после запус- 
ка таймера, можно вставить оператор 


Timerl->Enabled = false; 


который отключит таймер. 

Таймер точно выдерживает заданные интервалы Interval, если они достаточно 
велики — сотни и тысячи миллисекунд. Если же задавать интервалы длительно- 
стью десятки или единицы миллисекунд, то реальные интервалы времени оказы- 
ваются заметно больше вследствие различных накладных расходов, связанных с 
вызовами функций и иными вычислительными аспектами. 
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3.6 Компоненты — меню 


3.6.1 Главное меню — компонент Май Мепи 


В C++Builder имеется два компонента, представляющие меню: MainMenu — 
главное меню, и РорирМепи — всплывающее меню. Оба компонента расположены 
на странице Standard. Эти компоненты имеют много общего. Начнем рассмотрение 
с компонента MainMenu. 

Это невизуальный компонент, т.е. место его размещения на форме в процессе 
проектирования не имеет никакого значения для пользователя — он все равно уви- 
дит не сам компонент, а только меню, сгенерированное им. 

Обычно на форму помещается один компонент MainMenu. В этом случае ero 
имя автоматически заносится в свойство формы Menu. Но можно поместить на 
форму и несколько компонентов MainMenu с разными наборами разделов, соответ- 
ствующими различным режимам работы приложения. В этом случае во время про- 
ектирования свойству Menu формы присваивается ссылка на один из этих компо- 
нентов. А в процессе выполнения в нужные моменты это свойство можно изме- 
нять, меняя соответственно состав главного меню приложения. 

Основное свойство компонента — Items. Его заполнение производится с помо- 
щью Конструктора Меню, вызываемого двойным щелчком на компоненте 
MainMenu или нажатием кнопки с многоточием рядом со свойством Items в окне 
Инспектора Объектов. В результате откроется окно, вид которого представлен на 
рис. 3.32. В этом окне вы можете спроектировать все меню. На рис. 3.33 показано 
в работе то меню, которое соответствует проектируемому на рис. 3.32. 


Рис. 3.32 | Form1->MainMenul 
Окно Конструктора Меню . 


Puc. 3.33 
Результат конструирования меню 


При работе в конструкторе меню новые разделы можно вводить, помещая кур- 
сор в рамку из точек, обозначающую место расположения нового раздела (см. 
рис. 3.33). Если при этом раздел ввелся не на нужном вам месте, вы можете отбук- 
сировать его мышью туда, куда вам надо. Другой путь ввода нового раздела — ис- 
пользование контекстного меню, всплывающего при щелчке правой кнопкой 
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мыши. Если вы предварительно выделите какой-то раздел меню и выберете из 
контекстного меню команду Insert, то рамка нового раздела вставится перед ранее 
выделенным. Из контекстного меню вы можете также выполнить команду Create 
Submenu, позволяющую ввести подменю в выделенный раздел (см. подменю разде- 
ла Опции на рис. 3.32, 3.33). 

При выборе нового раздела вы увидите в Инспекторе Объектов множество 
свойств данного раздела. Дело в том, что каждый раздел меню, т.е. каждый эле- 
мент свойства Items, является объектом типа TMenultem, обладающим своими 
свойствами, методами, событиями. 

Свойство Caption обозначает надпись раздела. Заполнение этого свойства под- 
чиняется тем же правилам, что и заполнение аналогичного свойства в кнопках 
(см. раздел 3.5.1), включая использование символа амперсанта для обозначения 
клавиш быстрого доступа. Если вы в качестве значения Caption очередного разде- 
ла введете символ минус «-», то вместо раздела в меню появится разделитель (см. 
на рис. 3.32 и 3.33 разделители после разделов Сохранить как и Опции). 

Свойство Маше задает имя объекта, соответствующего разделу меню. Очень 
полезно давать этим объектам осмысленные имена, так как иначе вы скоро запу- 
таетесь в ничего не говорящих именах типа N21. Куда понятнее имена типа MFile, 
MOpen, MSave и т.п. 

Свойство ShortCut определяет клавиши быстрого доступа к разделу меню — 
«горячие» клавиши, с помощью которых пользователь, даже не заходя в меню, 
может в любой момент вызвать выполнение процедуры, связанной с данным разде- 
лом. Чтобы определить клавиши быстрого доступа, надо открыть выпадающий 
список свойства ShortCut в окне Инспектора Объектов и выбрать из него нужную 
комбинацию клавиш. Эта комбинация появится в строке раздела меню (см. коман- 
ду Сохранить на рис. 3.32, 3.33). В разделе 3.6.3 рассказано о некоторых дополни- 
тельных возможностях задания комбинаций горячих клавиш. 

Свойство Default определяет, является ли данный раздел разделом по умолча- 
нию своего подменю, т.е. разделом, выполняемым при двойном щелчке пользова- 
теля на родительском разделе. Подменю может содержать только один раздел по 
умолчанию, выделяемый жирным шрифтом (см. раздел Открыть на рис. 3.32, 3.33). 

Свойство ВгеаК используется в длинных меню, чтобы разбить список разделов 
на несколько столбцов. Возможные значение Break: mbNone — отсутствие разбие- 
ния меню (это значение принято по умолчанию), mbBarBreak и mbBreak — в 
меню вводится новый столбец разделов, отделенный от предыдущего полосой 
(mbBarBreak) или пробелами (mbBreak). На рис. 3.34 показан пример, в котором в 
разделе 1-3 установлено значение Break = mbBreak, а в разделе 1-5 — Break = 
mbBarBreak. 


Puc. 3.34 
Пример меню с разбиением на столбцы 


Свойство Checked, установленное в true, указывает, что в разделе меню будет 
отображаться маркер флажка, показывающий, что данный раздел выбран (см. на 
рис. 3.32, 3.33 раздел Автосохранение). Правда, сам по себе этот маркер не изменя- 
ется и в обработчик события OnClick такого раздела надо вставлять оператор типа 


MAutoSave->Checked = ! MAutoSave->Checked; 


(в приведенном операторе подразумевается, что раздел меню назван MAutoSave). 
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Еще одним свойством, позволяющим вводить маркеры в разделы меню, явля- 
ется RadioItem. Это свойство, установленное в true, определяет, что данный раз- 
дел должен работать в режиме радиокнопки совместно с другими разделами, 
имеющими TO же значение свойства GroupIndex. По умолчанию значение 
GroupIndex равно 0. Но можно задать его большим нуля и тогда, если имеется не- 
сколько разделов с одинаковым значением GroupIndex и с Radioltem = true, то в 
них могут появляться маркеры флажков, причем только в одном из них (на 
рис. 3.32, 3.33 свойство Radioltem установлено в true в разделах Шаблон 1 и Шаб- 
лон 2, имеющих одинаковое значение GroupIndex). Если вы зададите программно 
в одном из этих разделов Checked = true, то в остальных разделах Checked автома- 
тически сбросится в false. Впрочем, установка Checked = true лежит на програм- 
ме; эта установка может выполняться аналогично приведенному выше оператору. 

Описанные маркеры флажков в режиме радиокнопок и в обычном режиме ис- 
пользуются для разделов меню, представляющих собой различные опции, взаимо- 
исключающие или совместимые. 

Для каждого раздела могут быть установлены во время проектирования или 
программно во время выполнения свойства Enabled (доступен) и Visible (види- 
мый). Если установить Enabled = false, то раздел будет изображаться серой надпи- 
сью и не будет реагировать на щелчок пользователя. Если же задать Visible = 
false, то раздел вообще не будет виден, а остальные разделы COMKHYTCA, заняв ме- 
сто невидимого. Свойства Enabled и Visible используются для того, чтобы изме- 
нять состав доступных пользователю разделов в зависимости от режима работы 
приложения. 

Начиная с C++Builder 4 предусмотрена возможность ввода в разделы меню 
изображений. За это ответственны свойства разделов Bitmap и Ппагетдех. Пер- 
вое из них позволяет непосредственно ввести изображение в раздел, выбрав его из 
указанного вами файла. Второе позволяет указать индекс изображения, храняще- 
гося во внешнем компоненте ImageList (см. раздел 3.9.2). Указание на этот компо- 
нент вы можете задать в свойстве Images компонента МатМепи. Индексы начина- 
ются с 0. Если вы укажете индекс -1 (значение по умолчанию), изображения не бу- 
дет. 

Мы рассмотрели все основные свойства объектов, соответствующих разделам 
меню. Основное событие раздела — OnClick, возникающее при щелчке пользовате- 
ля на разделе или при нажатии «горячих» клавиш быстрого доступа. 

Рассмотрим теперь вопросы объединения главных меню вторичных форм с 
меню главной формы. Речь идет о приложениях с несколькими формами, в кото- 
рых и главная, и вспомогательные формы имеют свои главные меню — компонен- 
ты MainMenu. Конечно, пользователю неудобно работать одновременно с несколь- 
кими окнами, каждое из которых имеет свое меню. Обычно надо, чтобы эти меню 
сливались в одно меню главной формы. 

Приложения с несколькими формами могут быть двух видов: приложения с 
интерфейсом множества документов — так называемые МПТ приложения, и обыч- 
ные приложения с главной и вспомогательными формами. Типичными примерами 
приложений MDI являются программы Word и Excel. Подробнее это рассмотрено в 
разделах 4.1.2 и 4.5.4. Сейчас нас интересует только один вопрос: как объединяют- 
ся меню различных форм. В МПТ приложениях меню дочерних форм всегда объе- 
диняются с меню родительской формы. А в приложениях с несколькими формами 
наличие или отсутствие объединение определяется свойством AutoMerge компо- 
нентов ТМатМепи. Если требуется, чтобы меню вторичных форм объединялись с 
меню главной формы, то в каждой такой вторичной форме надо установить 
AutoMerge в true. При этом свойство AutoMerge главной формы должно оставать- 
ся в false. 

Способ объединения меню определяется свойством разделов GroupIndex. По 
умолчанию все разделы меню имеют одинаковое значение GroupIndex, равное 
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нулю. Если требуется объединение меню, то разделам надо задать неубывающие 
номера свойств GroupIndex. Тогда, если разделы встраиваемого меню имеют те же 
значения GroupIndex, что и какие-то разделы меню основной формы, TO эти разде- 
лы заменяют соответствующие разделы основного меню. В противном случае раз- 
делы вспомогательного меню встраиваются между элементами основного меню в 
соответствии с номерами GroupIndex. Если встраиваемый раздел имеет GroupIn- 
dex меньший, чем любой из разделов основного меню, то разделы встраиваются в 
начало. 

Пусть, например, в основной и вторичной формах структуры меню имеет сле- 
дующие значения GroupIndex: 


Форма 1 Форма 2 
2—4 eae 
| | | | 
2 4 1 3 
| | | 
2 4 1 


Тогда в момент, когда активизируется вторая форма, в первой появляется 
меню со структурой: 


фа — + 
м — 5 — Bb 


В этом примере отсутствовали разделы, имеющие в обеих формах одинаковые 
значения GroupIndex. Если бы такие были, то при активизации второй формы соот- 
ветствующие разделы ее меню заменили бы аналогичные разделы первой формы. 

Если в меню имеются разделы, работающие как радиокнопки, то нельзя забы- 
вать, что их взаимодействие также определяется свойствами GroupIndex. 

Теперь остановимся на одном из вопросов, связанных с меню в упоминавших- 
ся выше приложениях МПТ. В них пользователь может открывать столько окон до- 
кументов, сколько ему требуется. Обычно в подобных приложениях имеется меню 
Окно (см. рис. 3.35), которое содержит такие разделы, как Упорядочить. В конце 
меню идет обычно список открытых окон документов, в который заносятся назва- 
ния открытых пользователем окон. Выбирая в этом списке, пользователь может 
переключаться между окнами документов. 


Рис. 3.35 
Меню «Окно» в приложении MDI со списком 
открытых документов 


Для включения в меню раздела списка открытых окон, надо в свойстве 
WindowMenu главной формы приложения MDI указать имя меню, в конец которо- 
го должен помещаться список. Указывается именно имя меню, а не разделов выпа- 
лалющего списка. Для примера рис. 3.35 должно быть указано имя элемента меню, 
‹00%хветствующего команде Окно. 
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В разделе 4.1.6 приведены требования, предъявляемые к меню приложений 
для Windows. Одним из требований является стандартизация меню и их разделов. 
Этому помогает команда Save As Template в контекстном меню, всплывающем при 
щелчке правой кнопкой мыши в окне Конструктора Меню. Эта команда вызывает 
диалог, представленный на рис. 3.36. В этом диалоге вы можете в верхнем окне 
указать описание (заголовок), под которым хотите сохранить ваше меню. Впослед- 
ствии в любом вашем новом приложении вы можете загрузить этот шаблон в 
меню, выбирая из всплывающего меню в окне Конструктора Меню команду Insert 
From Template. 


Puc. 3.36 


Окно сохранения шаблона разработанного меню “Template Se 
[Главное меню | : 
“ oe а аа ай 
{File Menu 

‚ | File Menu (for TextE dit Example) 

Нар Menu 

‚ |Help Menu (Expanded) 

“1 MDI Frame Menu 


—|\Window Menu 


На этом мы пока закончим рассмотрение компонента MainMenu. В разделе 
3.6.3 мы еще вернемся к нему и покажем на примере один из видов настройки 
меню в процессе выполнения приложения. 


3.6.2 Контекстное всплывающее меню — компонент 
РорирМепи 


Контекстное меню привязано к конкретным компонентам. Оно всплывает, 
если во время, когда данный компонент в фокусе, пользователь щелкнет правой 
кнопкой мыши. Обычно в контекстное меню включают те команды главного меню, 
которые в первую очередь могут потребоваться при работе с данным компонентом. 

Контекстному меню соответствует компонент РорирМепи. Поскольку в при- 
ложении может быть несколько контекстных меню, то и компонентов РорирМепи 
может быть несколько. Оконные компоненты: панели, окна редактирования, а 
также метки и др. имеют свойство PopupMenu, которое по умолчанию пусто, HO 
куда можно поместить имя того компонента РорирМепи, с которым будет связан 
данный компонент. 

Формирование контекстного всплывающего меню производится с помощью 
Конструктора Меню, вызываемого двойным щелчком на РорирМепи, точно так 
же, как это делалось для главного меню. Обратим только внимание на возмож- 
ность упрощения этой работы. Поскольку разделы контекстного меню обычно по- 
вторяют некоторые разделы уже сформированного.главного меню, то можно обой- 
тись копированием соответствующих разделов. Для этого, войдя в Конструктор 
Меню из компонента PopupMenu, щелкните правой кнопкой мыши и из всплыв- 
шего меню выберите команду Select Menu (выбрать меню). Вам будет предложено 
диалоговое окно, в котором вы можете перейти в главное меню. В нем вы можете 
выделить нужный вам раздел или разделы (при нажатой клавише Shift выделяются 
разделы в заданном диапазоне, при нажатой клавише Ctrl можно выделить сово- 
купность разделов, не являющихся соседними). Затем выполните копирование их 
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в буфер обмена, нажав клавиши Ctrl-C. После этого опять щелкните правой кноп- 
кой мыши, выберите команду Select Menu и вернитесь в контекстное меню. Укажи- 
те курсором место, в которое хотите вставить скопированные разделы, и нажмите 
клавиши чтения из буфера обмена — Cirl-V. Разделы меню вместе со всеми их свой- 
ствами будут скопированы в создаваемое вами контекстное меню. 

В остальном работа с РорирМепи не отличается от работы с MainMenu. Толь- 
ко не возникает вопросов объединения меню разных форм: контекстные меню не 
объединяются. 


3.6.3 Горячие клавиши — компонент HotKey 


Компонент HotKey, расположенный в библиотеке на странице Win82, являет- 
ся вспомогательным, обеспечивающим возможность задания самим пользователем 
горячих клавиш, определяющих быстрый доступ к разделам меню. К тому же этот 
компонент позволяет задать такие сочетания горячих клавиш, которые не преду- 
смотрены в выпадающем списке свойства разделов меню ShortCut. 

Компонент HotKey внешне выглядит как обычное окно редактирования Edit. 
Но если в него входит пользователь, то оно переводит нажимаемые им клавиши в 
тип TShortCut, хранящий комбинацию горячих клавиш. Например, если пользо- 
ватель нажимает клавиши С41]-ф, то в окне HotKey появится текст «Ctrl + ф». 

Основное свойство компонента — HotKey, равное по умолчанию комбинации 
клавиш Alt-A. Это свойство можно прочесть и присвоить свойству ShortCut како- 
го-то раздела меню Например, оператор 


MOpen->ShortCut = HotKeyl->HotKey; 


присваивает разделу меню с именем MOpen комбинацию клавиш, заданную в KOM- 
поненте HotKeyl. 

Свойство Modifiers указывает модификатор — вспомогательную клавищу, на- 
жимаемую перед символьной. Это свойство является множеством, которое может 
включать значения hkShift, hkCtrl, hkAlt, hkExt, что соответствует клавишам 
Shift, Ctrl, Alt, Extra. По умолчанию Modifiers =[hkAIt]. Если вы хотите, например, 
задать вместо этого значения в качестве модификатора клавишу Ctrl, вы должны 
выполнить операторы: 


HotKeyl->Modifiers.Clear(); 
HotKeyl->Modifiers << hkCtrl; 


Свойство InvalidKeys задает недопустимые клавиши или их комбинации. Это 
свойство является множеством, которое может включать значения hcNone, 
hcShift, hcCtrl, hcAlt, hcShiftCtrl, hcShiftAlt, hcCtrlAlt, hcShiftCtrlAlt, что со- 
ответствует отсутствию модификатора и клавишам Shift, Ctrl, Alt, Shift-Ctrl, Shifft-Alt, 
Cirl-Alt, Shift-Ctrl-Alt. 

В заключение приведем пример использования компонента HotKey и настрой- 
ки горячих клавиш меню в процессе выполнения приложения. | 

Пусть у вас есть главная форма приложения, содержащая компонент 
MainMenu и пусть вы хотите ввести команду настройки, позволяющую пользова- 
телю изменить установленные для разделов меню горячие клавиши. Для упроще- 
ния задачи будем считать, что меню, сконструированное в Маш Мепи: 


Ш не каскадное (т.е. состоит только из двух уровней — заголовков меню и выпа- 
дающих списков разделов) 


Ш в свойствах Caption разделов меню не использованы амперсанты 
Ш в меню отсутствуют разделители 


Эти предположения сделаны просто для того, чтобы упростить код. 
Начните новое приложение, разместите на форме компонент МашМепи и 
сконструируйте с его помощью любое меню, удовлетворяющее перечисленным тре- 
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бованиям. Задайте каким-то из разделов меню быстрые клавиши. Один из разде- 
лов меню должен называться Настройка и при выборе его мы хотим предоставить 
пользователю вспомогательную форму для настройки быстрых клавиш. 

Добавьте в приложение еще одну форму (команда File | New Form). Эта форма бу- 
дет вспомогательной. В обработчик команды Настройка главной формы вставьте 
оператор 


Form2->ShowModal (); 


Этот оператор покажет пользователю окно вспомогательной формы как мо- 
дальное — т.е. пользователь не сможет вернуться в главную форму, пока не закро- 
ет вспомогательную. Чтобы компилятор понял этот оператор, надо в модуль глав- 
ной формы Unitl вставить ссылку на заголовочный файл модуля вспомогательной 
формы Unit2. Можете вручную вставить директиву препроцессора 


#include "Unit2.h" 


А можете сделать это, перейдя в окне Редактора Кода в модуль Unitl, выпол- 
HUB команду File | Use Unit u указав, что хотите связаться с модулем Unit2. Посколь- 
ку из модуля Unit2 надо будет видеть меню модуля Unitl, то аналогичным обра- 
зом введите и обратную связь — свяжите модуль Unit2 с Unitl. 

Теперь давайте спроектируем вспомогательную форму. Она может иметь вид, 
представленный на рис. 3.37. Ha ней расположено два списка ListBox (см. раз- 
дел 3.2.5): ListBoxl1, в котором отображаются заголовки меню, и ListBox2, в кото- 
ром отображаются разделы меню, соответствующие выбранному заголовку. В 
нижней части формы расположен компонент HotKey и кнопка Button, которая 
фиксирует в меню сделанный пользователем выбор и закрывает форму. В компо- 
ненте HotKey надо стереть с помощью Инспектора Объектов свойство HotKey, ко- 
торое содержит некоторое значение по умолчанию. 


Рис. 3.37 


Окно настройки горячих клавиш во время выполнения 


[Сш+с а & ue 


void _fastcall TForm2::FormShow(TObject *Sender) 
{ 
/* Загрузка ListBoxl заголовками меню 

при событии OnShow формы Form2 */ 


ListBoxl->Clear(); 
for(int 1 = 0; i < Forml->MainMenul->Items->Count; i++) 
ListBox1l->Items->Add ( 
Forml->MainMenul->Items->Items [i]->Caption) ; 
ListBoxl->ItemiIndex = 0; 
// Обращение к процедуре загрузки ListBox2 
ListBox1Click (Sender) ; 
} 
av: 


void  fastcall TForm2::ListBox1Click(TObject *Sender) 
{ 
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/* Загрузка ListBox2 заголовками разделов меню 
MainMenul->Items->Items [ListBoxl->ItemIndex], 
выделенного пользователем в ListBox] 
при событии OnShow формы Form2 */ 


ListBox2->Clear(); 
for(int 1 = 0; 1 < Forml->MainMenul->Items->Items [ 
ListBoxl->ItemIndex]->Count; i++) 
ListBox2->Items->Add (Forml->MainMenul->Items->Items [ 
~ListBox1l->ItemIndex] ->Items[i]->Caption) ; 
ListBox2->ItemIndex = 0; 
} 
lteor—n—nhn eee nnn es _=~=S<S~_ 
void _fastcall TForm2::ListBox2Click(TObject *Sender) 
{ 


/* Занесение горячих клавиш выделенного в ListBox2 раздела 
в компонент HotKeyl */ 


HotKeyl->HotKey = Forml->MainMenul->Items->Items [ 
ListBox1->ItemIndex]->Items [ 
ListBox2->ItemIndex]->ShortCut; 


} 
bb ——ere—————e————nkk ee e_=S 
void _fastcall TForm2::ButtonlClick(TObject *Sender) 


{ 
/* Изменение горячих клавиш выбранного раздела меню 
и закрытие вспомогательной формы */ 


Forml->MainMenul->Items->Items [ 
ListBox1->ItemIndex] ->Items [ListBox2->ItemIndex]->ShortCut 
= HotKeyl->HotKey; 
Close(); 
} 


При событии OnShow формы Form2 происходит загрузка списка ListBox] 3a- 
головками меню. Цикл загрузки перебирает индексы от 0 до Еогт1->МашМе- 
nul->Items->Count — 1. Свойство Count равно числу элементов в меню. 

При щелчке пользователя на списке ListBoxl происходит загрузка списка List- 
Вох2. При этом к соответствующим разделам меню получается доступ с помощью вы- 
ражения Form1->MainMenu1->Items->Items] ListBox1->ItemIndex]->Items[i]. В этом 
выражении Form1->MainMenul->Items->Items[ListBox1->ItemIndex] — элемент 
головного раздела меню, выбранного пользователем в ListBoxl. Каждый такой 
раздел можно рассматривать как элемент массива меню и в то же время он сам яв- 
ляется массивом разделов второго уровня. Поэтому его свойство Цетз[1] указыва- 
ет на подраздел с индексом 1. | 

При щелчке пользователя на списке ListBox2 происходит загрузка компонен- 
та HotKeyl символами горячих клавиш выбранного пользователем раздела. Если 
раздел не имеет горячих клавиш, то в окне HotKeyl отображается текст «Нет». 
Далее пользователь может войти в окно HotKeyl и нажать сочетание клавиш, KO- 
торое он хочет назначить выбранному им разделу меню. Обработка щелчка на 
кнопке фиксирует это сочетание в разделе меню и закрывает вспомогательную 
форму. 

Опробуйте это приложение в работе и вам станет яснее механизм работы с раз- 
делами меню и с быстрыми клавишами. 
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3.7 Панели и компоненты внешнего оформления 


3.7.1 Общая характеристика 


Панели являются контейнерами, служащими для объединения других управ- 
ляющих элементов. Они могут выполнять как чисто декоративные функции, зри- 
тельно объединяя компоненты, связанные друг с другом по назначению, так и 
функции управления, организуя совместную работу своих дочерних компонентов. 
Примером этого была рассмотренная в разделе 3.5.3 организация работы группы 
радиокнопок. 

В таблице 3.5 приведен перечень панелей, обслуживающих их компонентов и 
компонентов внешнего оформления, включенных в библиотеку C++Builder 5. 


Таблица 3.5 Панели и обслуживающие их компоненты 


| Пиктог- | Компонент Страница | Описание 


Standard Является контейнером, объединяю- 
щим группу связанных органов управ- 
ления, таких, как радиокнопки Radi- 
oButton, контрольные индикаторы 


GroupBox 
(групповое окно) 


Checkbox и т.д. 


Panel Standard Является контейнером для группиро- 

(панель) ` вания органов управления и меньших 
контейнеров. Панель можно использо- 
вать также для построения полос со- 
стояния, инструментальных панелей, 


палитр инструментов. 
Веуе] Additional 
(рамка) 


ScrollBox Additional |Используется для создания зон OTO- 
(окно с прокрут- бражения с прокруткой. 


кой) 
Splitter Additional |Используется для создания в прило- 
(разделитель па- жении панелей с изменяемыми поль- 
зователем размерами. 
Win32 Позволяет создавать составные пере- 
мещаемые заголовки. 
Win 3.1 Позволяет создавать составные пере- 
мещаемые заголовки, с меньшими 
возможностями, чем у HeaderControl. 


нелей) 
Additional 


Используется для рисования прямо- 
угольной рамки, изображенной как 
выступающая или утопленная. 


HeaderControl 
(заголовок) 


Header 
(заголовок) 


Используется для размещения компо- 
нентов инструментальной панели. 


ControlBar 
(инстументальная 
панель) 


TabControl 
(страница с 3a- 
кладкой) 


Позволяет добавлять закладки в стиле 
Windows, которые может выбирать 
пользователь. 
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Пиктог- | Компонент | Страница |Описание * 
рамма | 


PageControl Win32 Позволяет создавать страницы в стиле 

(многостраничное Windows, управляемые закладками 

окно) или иными органами управления, для 
экономии места на рабочем столе. 

ToolBar Win32 Инструментальная панель для быстро- 

(инструменталь- го доступа к часто используемым фун- 

ная панель) кциям приложения. 

CoolBar Win32 Контейнер инструментальной панели, 

(инструменталь- размеры которой могут изменяться 

ная перестраивае- пользователем. 

мая панель) 

PageScroller Win32 Обеспечивает прокрутку больших 

(прокрутка стра- окон, например, инструментальных 

ниц) панелей. 

TabSet Win3. 1 Используется для создания блокнота с 

(блокнот с заклад- закладками. 

ками) 

TabbedNotebook |\/п3.1 Используется для создания многостра- 

(многостраничная ничных форм с закладками. 

форма) 

Notebook Wins. |] Используется для создания пачки 

(пачка страниц) страниц, может применяться совмест- 
но с TabSet. 


Standard Используется Kak проектируемый в 
виде отдельного окна контейнер лю- 
бых компонентов. Обладает возможно- 
‚стями наследования, может включать- 
ся в Депозитарий. 


3.7.2 Панели общего назначения — компоненты Panel, 
GroupBox, Bevel, ScrollBox, Splitter 


На рис. 3.38 приведен пример, демонстрирующий вид таких панелей, как 
Panel, GroupBox, Bevel, ScrollBox. В левой части формы размещены компоненты 
Panel с различными значениями параметров. С этих компонентов мы и начнем 
рассмотрение панелей. 

Панели Panel используются наиболее широко. С их помощью компонуются 
различные элементы интерфейса (кнопки, окна редактирования, списки), функ- 
ционально связанные друг с другом. Такая функциональная связь должна поддер- 
живаться и зрительной связью — объединением соответствующих элементов в 
рамках одной панели. Панели Panel могут также использоваться для организации 
инструментальных панелей, полос состояния и т.п., хотя для этих целей имеются 
и специализированные компоненты, которые будут рассмотрены позднее. 

Одним из назначений панелей является также группирование таких управ- 
ляющих элементов, как RadioButton — радиокнопки (см. раздел 3.5.3). Все ра- 
диокнопки, расположенные на панели, работают как согласованная группа: в лю- 
бой момент может быть выбрана только одна из них. Аналогично согласованной 
группой работают и расположенные на панели быстрые кнопки SpeedButton (см. 
раздел 3.5.2), если они имеют одинаковое значение свойства GroupIndex. В то же 
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Рис. 3.38 
Пример панелей общего 
назначения 


ов ert Ая | Stjle-beLonved 
SheperbeBos _ ре: |. 


на | ЕО ЗЬЫ 
ме и - K ны ve 
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время SpeedButton, расположенные на разных панелях или на панели и форме, не 
образуют связанной группы даже при одинаковом значении GroupIndex. 

Методика использования панелей подробно рассмотрена в главе 4 в разде- 
ле 4.2. Поэтому здесь стоит обратить внимание только на некоторые свойства ком- 
понентов Panel. Внешний вид панели Panel определяется совокупностью парамет- 
ров BevelInner — стиль внутренней части панели, BevelOuter — стиль внешней 
части панели, Bevel Width — ширина внешней части панели, BorderStyle — стиль 
бордюра, BorderWidth — ширина бордюра. Результат сочетания некоторых значе- 
ний этих параметров показан на рис. 3.38. Верхняя панель соответствует значени- 
ям параметров по умолчанию. Нижняя панель соответствует случаю, когда не оп- 
ределен стиль ни одной из областей панели (значения всех параметров равны 
None). В этом случае сама панель никак не выделяется на форме. Видна только 
надпись на ней (свойство Caption), если надпись задана, и, конечно, видны те ком- 
поненты, которые размещаются на панели. 

Вопросы задания и форматирования надписи панели были рассмотрены в раз- 
деле 3.2.2, вопросы размещения панелей на форме и автоматического изменения 
их размеров рассмотрены в разделе 4.2. Там же рассмотрена методика построения 
панелей, размеры которых могут перестраиваться пользователем. В библиотеке 
C++Builder имеется специальный компонент — Splitter, который позволяет легко 
осуществить это. Его свойства Beveled и ResizeStyle, определяющие вид раздели- 
теля, и свойство MinSize, ограничивающее минимальный размер панелей по обе 
стороны от разделителя, рассмотрены в разделе 4.2.3. 

Панель GroupBox не имеет таких широких возможностей задания различных 
стилей оформления, как Panel. Но она имеет встроенную рамку с надписью (см. 
рис. 3.38), которая обычно используется для выделения на форме группы функ- 
ционально объединенных компонентов. Никаких особых свойств, отличных от 
уже рассмотренных, панель GroupBox не имеет. 

Компонент Bevel формально не является панелью, он не может служить кон- 
тейнером для компонентов. Например, с помощью Bevel нельзя сгруппировать ра- 
диокнопки. Однако, чисто зрительно компонент Bevel может использоваться как 
подобие панели. На рис. 3.38 в правой нижней части окна представлены различ- 
ные варианты оформления Bevel. 

Стиль отображения Bevel определяется свойством Style, которое может при- 
нимать значения bsLowered — утопленный, и bsRaised — приподнятый. А контур 
компонента определяется свойством Shape, которое может принимать значения: 
bsBox — прямоугольник, bsFrame — рамка, bsSpacer — пунктирная рамка, 
bsTopLine, bsBottomLine, bsLeftLine, bsRightLine — соответственной верхняя, 
нижняя, левая и правая линии. В зависимости от значения Style линии могут 


/ 
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быть утопленными или выступающими. Все перечисленные варианты приведены 
на рис. 3.38. 

Остановимся теперь на компоненте ScrollBox — панели с прокруткой. Этот 
компонент предназначен для создания области, в которой могут размещаться ком- 
поненты, занимающие площадь большую, чем cam ScrollBox. Например, компо- 
нент ScrollBox можно использовать для размещения длинных текстовых строк 
или больших инструментальных панелей, которые исходя из соображений эконо- 
мии площади окна нецелесообразно отображать целиком. В примере рис. 3.38 в 
ScrollBox помещена панель с надписью: «Это ScrollBox, содержащая панель с 
длинной надписью». В пределах ScrollBox видна только часть этой панели. Если 
размеры ScrollBox меньше, чем размещенные компоненты, то появляются полосы 
прокрутки, которые позволяют пользователю перемещаться по всем размещенным 
в ScrollBox компонентам. 

Разместить в пределах небольшой области ScrollBox большие компоненты 
или много компонентов, занимающих в сумме большую площадь, можно в процес- 
се проектирования, например, с помощью такого приема. Увеличьте временно раз- 
мер ScrollBox так, чтобы в этом компоненте поместилось все, что вы хотите раз- 
местить. Проведите необходимое размещение. А затем сократите размеры 
ScrollBox до требуемых. 

Свойство BorderStyle определяет стиль рамки компонента ScrollBox. Свойст- 
во AutoScroll позволяет задать автоматическое появление необходимых полос 
прокрутки, если размер размещенных компонентов превышает размер области по 
горизонтали, вертикали или в обоих измерениях. Если по каким-то соображениям 
это нежелательно, вы можете сами управлять появлением горизонтальной и верти- 
кальной полос с помощью свойств HorzScrollBar и VertScrollBar соответственно. 
Но в этом случае вы должны сами задавать ряд свойств полосы прокрутки и, преж- 
де всего, Range — размер в пикселях прокручиваемой области. Значение переме- 
щения при однократном нажатии пользователем кнопки прокрутки может рассчи- 
тываться компонентом автоматически исходя из размеров области и окна, если 
свойство полосы прокрутки Smooth установлено в true. В противном случае вы 
должны задать величину единичного перемещения в свойстве Increment. 


3.7.3 Заголовки — компоненты HeaderControl и Header 


Компоненты заголовков HeaderControl и Header являются компонентами, с 
помощью которых можно управлять размещением расположенных под ними пане- 
лей. Заголовок состоит из ряда секций (см. рис. 3.39), причем пользователь во вре- 
мя выполнения приложения может изменять ширину отдельных секций с помо- 
щью мыши. 


Рис. 3.39 ; fu Заголовки 
Пример использования заголовков У 3 


ae Характеристика : 
> | Иванова Ивана Ивановича © 


Отличный работник! 


_ Начальник ОК Иванов И.И. : 


: Характеристика : 
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Отличный работник! 


ачальник ОК Иванов ии. 
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По умолчанию свойство Align в HeaderControl задано равным а! Тор, что обес- 
печивает размещение компонента вверху окна формы. Но это свойство можно из- 
менить, например, на а Мопе и разместить компонент в любом необходимом месте. 

Основное свойство компонента HeaderControl — Sections. Оно является спи- 
ском объектов типа THeaderSection, каждый из которых описывает одну секцию 
заголовка. Свойство Sections можно задать во время проектирования, нажав кноп- 
ку с многоточием рядом с этим свойством в Инспекторе Объектов или просто сде- 
лав двойной щелчок на компоненте HeaderControl. В обоих случаях перед вами OT- 
кроется окно редактора заголовков, подобное рассмотренному ранее в разделе 
3.4.2 и представленному на рис. 3.17. Левая быстрая кнопка позволяет добавить 
новую секцию в заголовок. Следующая быстрая кнопка позволяет удалить сек- 
цию. Кнопки со стрелкой позволяют изменять последовательность секций. 

После того, как вы добавили секцию и установили на ней курсор, в окне Ин- 
спектора Объектов появится множество свойств этого объекта. В свойстве Text вы 
можете задать текст заголовка. Свойства MinWidth и Max Width определяют соот- 
ветственно минимальную и максимальную ширину секции в пикселях. Только в 
этих пределах пользователь может изменять ширину секции курсором мыши. Зна- 
чение ширины по умолчанию задается значением свойства Width. При изменении 
ширины секции во время выполнения генерируется событие OnSectionResize. В 
обработчик этого события надо вставить операторы, синхронно изменяющие ши- 
рину того, заголовком чего является секция: это может быть какая-то панель, таб- 
лица, изображение и т.п. | 

Свойство AllowClick, равное по умолчанию true, определяет поведение секции 
как кнопки при щелчке пользователя на ней. В этом случае при щелчке генериру- 
ется событие OnSectionClick компонента HeaderControl, в обработчик которого и 
надо вставить операторы, выполняющие необходимые действия. 

Свойство Style может иметь значение hsText — в этом случае в заголовке ото- 
бражается значение свойства Text, или hsOwnerDraw — в этом случае отображает- 
ся то, что рисуется непосредственно на канве операторами, записанными в обра- 
ботчике события OnDrawSection компонента HeaderControl. 

Компонент Неа4ег обладает существенно меньшими возможностями, чем 
HeaderControl. В нем свойство Sections имеет тип TStrings и содержит только 
тексты заголовков, не позволяя регулировать пределы изменения ширины секций, 
их функционирование как кнопок и т.д. Таким образом, Header имеет смысл ис- 
пользовать только в 16-разрядных приложениях. 


3.7.4 Многостраничные панели — компоненты TabControl, 
PageControl, TabSet, TabbedNotebook, Notebook 


Многостраничные панели позволяют экономить пространство окна приложе- 
ния, размещая на одном и том же месте страницы разного содержания. На 
рис. 3.40 показаны различные формы отображения многостраничного компонента 
PageControl. Начнем рассмотрение многостраничных панелей именно с этого KOM- 
понента. | 

Перенесите компонент’ PageControl на форму. Чтобы задавать и редактиро- 
вать страницы этого компонента, надо щелкнуть на нем правой кнопкой мыши. Во 
всплывшем меню вы можете видеть команды: New Раде — создать новую страни- 
цу, Мех! Page — переключиться на следующую страницу, Previous Раде — переклю- 
читься на предыдущую страницу. 

Каждая создаваемая вами страница является объектом типа TTabSheet. Это 
панель, на которой можно размещать любые управляющие компоненты, окна ре- 
дактирования и т.п. После того, как вы создадите несколько страниц, выделите 
одну из них, щелкнув в ее середине, и посмотрите ее свойства в Инспекторе Объек- 
тов. Страница имеет следующие основные свойства: 
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Рис. 3.40 


Иллюстрация различных 
вариантов панели PageControl 
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Имя, по которому можно ссылаться на страницу 
Надпись, которая появляется на ярлычке закладки 
Индекс страницы, по которому можно ссылаться на страницу 


Индекс изображения, которое может появляться на ярлычке за- 
кладки 


Из общих свойств компонента PageControl можно отметить: 


MultiLine 


TabPosition 


TabHeight 
и 
TabWidth 


Images 


ScrollOppo- 
site 
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Определяет стиль отображения компонента: tsTabs — закладки 


(верхние компоненты на рис. 3.40), tsButtons — кнопки (левый 
нижний компонент на рис. 3.40), tsFlatButtons — плоские 
кнопки (правый нижний компонент на рис. 3.40) 


Определяет, будут ли закладки размещаться в несколько рядов, 
если все они не помещаются в один ряд (на рис. 3.40 вверху два 
одинаковых компонента, но в левом MultiLine = false, а в пра- 
вом — true; примером компонента с MultiLine = false является 
также знакомая вам палитра компонентов в C++Builder) 


Определяет место расположения ярлычков закладок: tpBot- 

tom — внизу, tpLeft — слева, tpRight — справа и tpTop — 
вверху компонента (это значение по умолчанию и именно оно за- 
дано в примерах рис. 3.40) 


Высота и ширина ярлычков закладок в пикселях. Если значения 
этих параметров заданы равными 0, то размеры ярлычков опеде- 
ляются автоматически по размерам надписей на них 


Ссылка на компонент ImageList (см. раздел 3.9.2), который содер- 
жит список изображений на ярлычках. Свойства ImagelIndex стра- 
ниц содержат индексы, соответствующие именно этому списку 


Определят способ перемещения закладок при размещении их в 
несколько рядов (опробуйте экспериментально, как это свойство 
влияет на поведение компонента) 
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ActivePage Uma активной страницы 


Pages _ Доступ к странице по индексу (первая страница имеет индекс 0). 
fint Index] Свойство только для чтения 
PageCount Количество страниц. Свойство только для чтения 


В компоненте имеется ряд методов, позволяющих оперировать страницами, 
создавать их, уничтожать, переключать. Посмотрите их во встроенной справке 
C++Builder. Основные события компонента — OnChanging и OnChange. Первое из 
них происходит непосредственно перед переключением на другую страницу после 
щелчка пользователя на новой закладке. При этом в обработчик события передает- 
ся по ссылке параметр AllowChange — разрешение переключения. Если в обработ- 
чике задать AllowChange = false, то переключение не произойдет. Событие 
OnChange присходит сразу после переключения. 


Рассмотрим теперь компонент TabControl. Внешне этот компонент выглядит 
так же, как PageControl, и имеет много тех же свойств: Style, MultiLine, TabPosi- 
tion, TabHeight, TabWidth, Images, ScrollOpposite, те же события OnChanging и 
OnChange. Но принципиальное отличие его от PageControl заключается в TOM, что 
TabControl не имеет множества панелей (страниц). Компонент представляет собой 
одну страницу с управляющим элементом типа кнопки со многими положениями. 
И надо написать соответствующие обработчики событий OnChanging и OnChange, 
чтобы определить, что именно должно происходить на панели при переключениях 
закладок пользователем. У компонента имеется еще одно свойство — MultySelect, 
позволяющее множественный выбор закладок. Если это свойство установлено в 
true, то в обработчиках событий надо описать реакцию на такой выбор пользова- 
теля. 

Число закладок и их надписи определяются свойством Tabs типа TStrings. В 
нем вы можете задать надписи закладок. Сколько строчек надписей вы укажете, 
столько будет закладок. Текущее состояние переключателя определяется свойст- 
вом TabIndex. Вы можете установить его в процессе проектирования, чтобы опре- 
делить исходное состояние переключателя. А затем в обработчиках событий 
OnChanging и OnChange можете читать это свойство, чтобы определить, что имен- 
но выбрал пользователь. 

Применять компонент TabControl имеет смысл в тех приложениях, в которых 
нужен многопозиционный переключатель. Вы можете, конечно, имитировать с по- 
мощью. TabControl поведение, аналогичное компоненту PageControl. Для этого 
достаточно, например, расположить в пределах TabControl две закрывающие друг 
друга панели и в обработчик события OnChange вставить оператор: 

if (TabControll->TabIndex == 0) 


Panel2->Visible = false; 
else Panel2->Visible = true; 


Если Panel2 — верхняя панель, TO при выборе первой закладки (TabIndex = 0) 
она будет делаться невидимой и под ней будет проступать нижняя панель. 

Но подобная имитация PageControl не имеет смысла, так как проще использо- 
вать сам компонент PageControl. A TabControl надо применять, если требуются 
какие-то перестроения в рамках одной панели. 


Теперь коротко остановимся на компонентах TabSet, TabbedNotebook и 
Notebook. Эти компоненты не рекомендуются для применения в 32-разрядных 
приложениях. 

Компонент TabbedNotebook. является аналогом многостраничной панели 
PageControl. Только многие одинаковые у этих панелей свойства называются 
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по-разному. Основное свойство — Pages, определяющее число страниц и надписи 
закладок. Свойство ActivePage определяет надпись активной страницы: Свойство 
PageIndex определяет индекс активной страницы (0 — первая страница). Так что 
узнать, какая страница активна, можно или по значению ActivePage, или по 
PageIndex. 

В обработчик события OnChange, происходящего при переключении пользо- 
вателем страницы, передается параметр NewTab, равный индексу новой страни- 
цы, и AllowChange — разрешение переключения. Для запрета переключения 
можно в обработчике задать AllowChange = false. 

Рассмотренный компонент TabbedNotebook является как бы соединением 
двух компонентов: пачки панелей (страниц) Notebook и набора закладок TabSet. 
Эти два компонента могут использоваться и раздельно. Компонент TabSet во мно- 
гом аналогичен рассмотренному ранее 32-разрядному компоненту TabControl. Это 
многопозиционный управляющий элемент, который сам по себе не имеет никакой 
панели. Его основное свойство — Tabs типа TStrings. Задавая строки этого свойст- 
ва вы тем самым определяете число закладок и их надписи. Свойства StartMargin 
и EndMargin определяют поля — расстояния крайних закладок от краев компо- 
нента. Сами закладки всегда направлены вниз. Поэтому компонент TabSet надо 
располагать внизу управляемого им компонента. Свойство AutoScroll определяет 
появление кнопок при большом количестве закладок, которые позволяют пользо- 
вателю прокручивать полосу закладок, как это делается в компонентах 
PageControl и TabControl при MultiLine = false. Индекс выбранной закладки оп- 
ределяется свойством Та тех, значение которого можно устанавливать и можно 
читать в обработчике события OnChange, происходящего при смене пользователем 
закладки и идентичного такому событию в компоненте TabbedNotebook. 


Компонент Notebook является пачкой панелей, имена и количество которых 
определяются свойством Pages, как в компоненте TabbedNotebook. Индекс вы- 
бранной страницы определяется свойством PageIndex. В этом компоненте отсутст- 
вует управляющий элемент — закладки. Так что страницы можно переключать 
какими-то кнопками, переключать их в зависимости от действий пользователя, в 
зависимости от отображаемых данных и т.п. Компоненты Notebook и TabSet мо- 
гут быть, конечно, объединены программно в компонент, аналогичный TabbedNo- 
tebook. Для этого достаточно в обработчик события OnChange компонента TabSet 
вставить оператор 


Notebookl->PageIndex = NewTab; 


Но подобное использование этих компонентов вряд ли целесообразно: уж луч- 
ше использовать непосредственно TabbedNotebook. 


3.7.5 Инструментальные панели — компоненты ToolBar 
и PageScroller 


Как уже говорилось выше, инструментальные панели можно создавать, не 
прибегая к специальным компонентам. Можно поместить на форму простейшую 
панель Panel, разместить на ней быстрые кнопки SpeedButton и панель готова. 
Остается только написать для кнопок соответствующий код. Но специализирован- 
ные компоненты, которые мы рассмотрим в этом разделе, дают, конечно, дополни- 
тельные возможности для построения инструментальных панелей. 

Начнем рассмотрение компонентов, которые используются для построения 
различных инструментальных панелей, с компонента ToolBar. Пример панели, 
построенной на основе этого компонента, приведен на рис. 3.41. 

Если вы поместите компонент ToolBar на форму, то по умолчанию он располо- 
жится вверху, поскольку его свойство Align по умолчанию равно alTop. Если вы 
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Рис. 3.41 
Пример инструментальной панели ToolBar 


хотите, чтобы панель располагалась иначе, установите Align = alNone, после чего 
можете придать панели любую форму и расположить ее в любом месте. 

Занесение компонентов на панель Тоо]Ваг можно, в принципе, осуществлять 
обычным способом — переносом их из палитры компонентов. Но для занесения 
кнопок имеется и более простой вариант. Щелкните на ToolBar правой кнопкой 
мыши и выберите из всплывшего меню команду New Button. На форме появится 
очередная кнопка — объект типа TToolButton. Это не совсем обычная кнопка, так 
как в дальнейшем вы увидите, что внешне она может не походить на кнопку. Ее 
вид и поведение определяется ее свойством Style, которое по умолчанию равно 
tbsButton — кнопка. Другие возможные стили мы рассмотрим позднее. А как 
кнопка этот объект очень похож на кнопку SpeedButton. Только изображение на 
кнопке определяется не свойством Glyph, а свойством ImageIndex. Оно определяет 
индекс изображения, хранящегося во внешнем компоненте ImageList (см. раз- 
дел 3.9.2). Указание на этот компонент может задаваться такими свойствами ком- 
понента ToolBar, как Images, DisabledImages (указывает на список изображений 
кнопок в недоступном состоянии) и HotImages (указывает на список изображений 
кнопок в моменты, когда над ними перемещается курсор мыши). 

Свойство МепаЦет позволяет задать раздел главного или контекстного меню 
(см. разделы 3.6.1 и 3.6.2), который дублируется данной кнопкой. При установке 
этого свойства, если в соответствующем разделе меню было задано изображение и 
установлен текст подсказок (свойство Hint), то это же изображение появится на 
кнопке и тот же текст появится в свойстве Hint кнопки. Передадутся из раздела 
меню в кнопку также значения свойств Enabled (доступность) и Visible (види- 
мость). Правда, все это передастся в кнопку только в момент установки свойства 
Menultem. Если в процессе дальнейшего проектирования вы измените COOTBETCT- 
вующие свойства раздела меню, это не отразится на свойствах кнопки. Но если вы 
сотрете значение Menultem, а потом установите его снова, то в кнопке зафиксиру- 
ются новые значения свойств раздела меню. 

Свойство Wrap, установленное в true, приводит к тому, что после этой кнопки 
ряд кнопок на панели прерывается и следующие кнопки размещаются в следую- 
щем ряду. 

Теперь вернемся к свойству Style, задающему стиль кнопки. Значение Style = 
tbsCheck определяет, что после щелчка пользователя на кнопке она остается в Ha- 
жатом состоянии. Повторный щелчок на кнопке возвращает ее в отжатое состоя- 
ние. Поведение такой кнопки подобно кнопкам SpeedButton и определяется ана- 
логичными свойствами AllowAllUp и Down (см. раздел 3.5.2). Если при этом в не- 
скольких кнопках установлено свойство Grouped = true, то эти кнопки образуют 
группу, из которой только одна кнопка может находиться в нажатом состоянии. 

Значение Style = tbsDropDown соответствует кнопке в виде выпадающего спи- 
ска. Этот стиль удобен для воспроизведения выпадающего меню. Если для подоб- 
ной кнопки задать в качестве свойства МепиЦет головной раздел меню, то в выпа- 
дающем списке автоматически будут появляться разделы выпадающего меню. В 
примере рис. 3.41 стиль thsDropDown имеет четвертая слева кнопка. В ней в каче- 
стве свойства Menultem задан раздел Опции из меню, рассмотренного в разделе 
3.6.1 и представленного на рис. 3.33. При Style = tbsDropDown можно вместо 
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свойства Menultem задать свойство DropDownMenu, определяющее контекстное 
меню (компонент PopupMenu), которое будет отображаться в выпадающем списке. 

Значение Style = tbsSeparator приводит к появлению разделителя, позволяю- 
щего отделить друг от друга кнопки разных функциональных групп. Значение 
Style = tbsDivider приводит к появлению разделителя другого типа — в виде вер- 
тикальной линии. Разделитель можно ввести и из контекстного меню ToolBar, вы- 
брав команду New Separator. 

Свойство кнопки Indeterminate задает ее третье состояние — не нажатая и не 
отпущенная. Это свойство можно устанавливать в true во время выполнения, если 
в данном режиме кнопка не доступна. 

Свойство Marked выделяет кнопку. 

Мы рассмотрели занесение на панель кнопок. Но в инструментальных пане- 
лях нередко используются и выпадающие списки. Например, для задания размера 
шрифта. Не представляет труда перенести на панель Тоо!Ваг такие компоненты, 
как ComboBox (это изображено на рис. 3.41), SpinEdit и др. 

Из общих свойств компонента Тоо!Ваг следует еще отметить ButtonHeight и 
ВиЙоп Width — высота и ширина кнопок в пикселях, и Wrapable — автоматиче- 
ский перенос кнопок в следующий ряд панели, если они не помещаются в преды- 
дущем. Такой перенос осуществляется и во время проектирования, и во время вы- 
полнения при изменении пользователем размеров панели. 

Свойства, определяющие вид панели ToolBar: BorderWidth — ширина бордю- 
ра, EdgeInner и EdgeOuter — стиль изображения внутренней и внешней части па- 
нели (утопленный или выступающий), EdgeBorders — определяет изображение от- 
дельных сторон панели (левой, правой, верхней, нижней). 


Мы рассмотрели построение инструментальной панели на основе компонента 
ToolBar. Но полоса может быть очень длинной и не помещаться в отведенном ей 
месте формы. Примером является палитра компонентов C++Builder. В этих случа- 
ях может помочь компонент PageScroller, обеспечивающий прокрутку панели. 
Собственно говоря, PageScroller может прокручивать любой компонент, не обяза- 
тельно панель ToolBar. Например, он может прокручивать какую-то панель вме- 
сте с размещенными на ней компонентами. В этом отношении он напоминает рас- 
смотренный в разделе 3.7.2 компонент ScrollBox. Но есть и заметные различия ме- 
жду этими двумя компонентами: PageScroller прокручивает только один компо- 
нент и только в одном направлении — горизонтальном или вертикальном. Да и 
оформление управления прокруткой у PageScroller не похоже на полосы прокрут- 
ки в 5сгоЙ Вох. 

Пример применения компонента PageScroller показан на рис. 3.42. Это тот 
же пример, что и на рис. 3.41. В верхней части окна показана та же инструмен- 
тальная панель, что и на рис. 3.41. А ниже показана идентичная панель, но заклю- 
ченная в небольшое окно PageScroller и снабженная кнопкой прокрутки. 


Рис. 3.42 
Пример инструментальной панели и ее прокрутки 
компонентом PageScroller 


Основное свойство компонента PageScroller — Control. Оно указывает компо- 
нент, который должен размещаться и прокручиваться в окне PageScroller. Благо- 
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даря наличию этого свойства вы можете проектировать свою инструментальную 
панель, например, ToolBar, не помещая ее заранее в окно PageScroller и не заду- 
мываясь о ее размере. А после того, как вы спроектировали панель, можно ввести 
на форму компонент PageScroller и установить его свойство Control. В этот мо- 
мент ваша инструментальная панель переместится в окно компонента PageScrol- 
ler и появится, если необходимо, кнопка прокрутки. 

Свойство Margin компонента PageScroller определяет размер полей в пиксе- 
лях, которые оставляются между краем окна PageScroller и прокручиваемым 
компонентом. По умолчанию эти поля равны нулю, но надо задать свойству 
Margin некоторое положительное значение. Иначе края прокручиваемого компо- 
нента могут быть плохо видны. 

Свойство AutoScroll определяет, должна ли прокрутка осуществляться авто- 
матически, как только курсор мыши пройдет над кнопкой прокрутки. Опробуйте 
режим автоматической прокрутки экспериментально. На мой взгляд лучше остав- 
лять значение AutoScroll равным false, поскольку такая автоматическая прокрут- 
ка не очень удобна пользователю. 


3.7.6 Перестраиваемые панели — компоненты CoolBar 
__ и ControlBar 


Перестраиваемые панели являются дальнейшим развитием инструменталь- 
ных панелей. Только в перестраиваемых панелях сами инструментальные панели 
обычно являются компонентами более сложных образований. Примером пере- 
страиваемой панели может служить панель UCP C++Builder 5, включающая в 
себя ряд более мелких панелей быстрых кнопок и палитру компонентов. Пользова- 
тель может настраивать их, изменять местоположение панелей и т.п. 

Начнем рассмотрение с компонента CoolBar. Он позволяет строить перестраи- 
ваемые панели, состоящие из полос (bands). В полосы могут включаться инстру- 
ментальные панели ToolBar и любые другие оконные компоненты: окна редакти- 
рования, панели и т.п. Каждый из этих компонентов автоматически снабжается 
средствами перемещения его пользователем в пределах окна CoolBar. В полосы 
могут вставляться и не оконные компоненты, например, метки. Но они не будут 
перемещаемыми. 

Опробуйте в работе этот компонент. Поместите его на форму. Перенесите на 
него другие компоненты, например, ToolBar и Edit. Когда вы размещаете на 
CoolBar очередной компонент, ему отводится отдельная полоса и он растягивается 
на всю ширину CoolBar. Около каждого компонента появляется слева полоска, за 
которую компонент можно перемещать. Например, взявшись за эту полоску вы 
можете переместить полосу вместе с ее компонентом в тот ряд, где уже имеется 
другой компонент. Тогда они расположатся в ряд один левее другого (см. пример 
на рис. 3.43). 


Рис. 3.43 
Пример перестраиваемой панели на основе 
компонента CoolBar 


Css = пение са 
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Свойства полос вы можете задавать редактором полос. С этим инструментом 
вы уже имели дело в разделах 3.4.2 и 3.7.3 (см. рис. 3.17). Вызвать редактор полос 
можно тремя способами: из Инспектора Объектов кнопкой с многоточием около 
свойства Bands, двойным щелчком на компоненте CoolBar или из контекстного 
меню, выбрав команду Bands Editor. В окне этого редактора вы можете перемещать- 
ся по полосам, добавлять новые полосы или уничтожать существующие. При пере- 
мещении по полосам в окне Инспектора Объектов вы будете видеть свойства полос. 
Свойство Control определяет размещенный на полосе компонент. Свойство Break 
определяет, занимает ли полоса весь соответствующий размер контейнера 
CoolBar, или обрывается. Если вы расположите полосы так, как показано на 
рис. 3.43, то в левых полосах автоматически установится Break = true, а в правых 
— Break = false. 

Свойство Text задает текст, который может появиться в начале соответствую- 
щей полосы. Это свойство можно оставлять пустым. А можно и задать его — над- 
писи «Панель 1», «Панель 2», «Окно 1», «Окно 2» на рис. 3.43 заданы именно 
этим свойством. | 

Вместо свойства Text (или наряду с ним) можно задать свойство ImagelIndex 
— индекс списка изображений ImageList (см. раздел 3.9.2), ссылка на который за- 
дается свойством Images. Указанные таким образом изображения появятся в нача- 
ле соответствующих полос (см. верхние полосы на рис. 3.43). 

Свойства MinHeight и Мш У определяют минимальную высоту и ширину 
полосы при перестроениях пользователем полос панели. 

Свойство FixedSize определяет, фиксирован ли размер данной полосы или OH 
может изменяться пользователем. По умолчанию для всех полос FixedSize = false, 
т.е. все полосы перестраиваются. Но при желании размеры некоторых полос мож- 
но зафиксировать, задав для них FixedSize = true. 

Для компонента CoolBar в целом, помимо обычных для других панелей 
свойств, надо обратить внимание на свойство BandMaximize. Оно определяет дей- 
ствие, которым пользователь может установить максимальный размер полосы, не 
перетаскивая ее границу: bmNone — такое действие не предусмотрено, bmClick — 
щелчком мыши, bmDbIClick — двойным щелчком. Наиболее целесообразно, 
по-видимому, задавать значения bmDbIClick или bmNone, поскольку значение 
bmClick приводит к резкому перестроению полос даже при случайном щелчке 
мыши. 

Свойство FixedOrder, если его установить в true, не разрешит пользователю в 
процессе перемещений полос изменять их последовательность. Вероятно, такое за- 
дание лучше, чем значение по умолчанию, равное false, поскольку чрезмерная 
свобода для пользователя способна его запутать. 

Свойство Vertical указывает вертикальное или горизонтальное расположение 
полос. По умолчанию Vertical = false, что соответствует горизонтальным полосам. 

Запустите свое тестовое приложение, если вы его построили, и опробуйте его в 
работе. Вы увидите, как легко пользователь может перестраивать панель. 


Еще большую свободу перестроений дает пользователю компонент ControlBar. 
Только оформление панели несколько отличается от CoolBar и кроме того в ней 
может широко применяться техника перетаскивания и встраивания Drag&Doc, 
подробно рассмотренная в главе 4 в разделе 4.4.2. Поэтому ограничимся пока 
кратким описанием панели ControlBar. 

Поместите на форму компонент ControlBar и перенесите Ha него несколько 
компонентов, например, инструментальных панелей ToolBar и окон редактирова- 
ния Edit. Вы увидите (см. рис 3.44), что каждый компонент, попадая Ha 
ControlBar, получает полосу захвата, свойственную технологии Drag&Doc. 
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Рис. 3.44 a) 
Перестраиваемая панель на основе компонента ControlBar 
(а) и вынесенное из нее окно редактирования (6) 


Установите у компонентов, размещенных. на ControlBar, свойство DragMo- 
de = dmAutomatic и DragKind = dkDock. Это означает автоматическое выполне- 
ние операций Drag&Doc (см. раздел 4.4.2). 

Свойства компонента ControlBar RowSize и RowSnap определяют процедуру 
встраивания. Свойство RowSize задает размеры полос, в которые могут встраи- 
ваться компоненты, а RowSnap определяет захват полосами встраиваемых компо- 
нентов. Свойство AutoDrag определяет, можно (при значении true), или нельзя 
простым перетаскиванием вынести полосу за пределы ControlBar. 

Запустите приложение и посмотрите на практике широчайшие возможности 
перестроения панелей. A если вы установили свойство AutoDrag в true, то вы мо- 
жете даже вынимать из панели отдельные компоненты и они становятся самостоя- 
тельными окнами (см. рис. 3.44 6). Опробуйте в эксперименте различные значения 
свойств компонента ControlBar, и они станут вам более понятны. А подробнее о 
технике Drag&Doc вы узнаете в разделе 4.4.2. 


3.7.7 Полоса состояния StatusBar 


Компонент StatusBar представляет собой ряд панелей, отображающих полосу 
состояния в стиле Windows. Обычно эта полоса размещается внизу формы. Пример 
полосы состояния вы можете увидеть в разделе 3.2.4 на рис. 3.5. 

Свойство SimplePanel определяет, включает ли полоса состояния одну или 
множество панелей. Если SimplePanel = true, то вся полоса состояния представля- 
ет собой единственную панель, текст которой задается свойством SimpleText. Если 
же SimplePanel = false, то полоса состояния является набором панелей, задавае- 
мых свойством Panels. В этом случае свойство SizeGrip определяет, может ли 
пользователь изменять размеры панелей в процессе выполнения приложения. 

Каждая панель полосы состояния является объектом типа TStatusPanels. 
Свойства панелей вы можете задавать специальным редактором наборов. С этим 
инструментом вы уже имели дело в разделах 3.4.2, 3.7.3, 3.7.6 (см. рис. 3.17). Вы- 
звать редактор можно тремя способами: из Инспектора Объектов кнопкой с много- 
точием около свойства Panels, двойным щелчком на компоненте StatusBar или из 
контекстного меню, выбрав команду Panels Editor. B окне редактора вы можете пе- 
ремещаться по панелям, добавлять новые или уничтожать существующие. При пе- 
ремещении по панелям в окне Инспектора Объектов вы будете видеть их свойства. 

Основное свойство каждой панели — Text, в который заносится отображае- 
мый в панели текст. Его можно занести в процессе проектирования, а затем можно 
изменять программно во время выполнения. Другое существенное свойство пане- 
ли — Width (ширина). 

Программный доступ к текстам отдельных панелей можно осуществлять через 
свойство Panels и его индексированное подсвойство Items. Например, оператор: 
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StatusBarl->Panels->Items[0]->Text = "текст 1"; 


напечатает текст «текст 1» в первой панели. 
Количество панелей полосы состояния можно определит из подсвойства Count 
свойства Panels. Например, следующий оператор очищает тексты всех панелей: 


for (int i = 0; i < StatusBarl->Panels->Count; 1++) 


{ 
StatusBarl->Panels->Items[i]->Text = ""; 


} 


На рис. 3.5 был приведен пример текстового редактора на основе компонента 
RichEdit, содержащий полосу состояния. В ее первой панели отображается номер 
строки и символа, перед которым находится курсор, во второй — отображается, 
модифицирован текст в окне, или нет. В третьей панели отображается подсказка 
о назначении компонента, над которым в данный момент расположен курсор 
мыши. 

Для реализации такой полосы состояния надо в обработчиках событий 
OnKeyDown, OnKeyUp, OnMouseDown и OnMouseUp компонента RichEdit1 и co- 
бытия OnResize формы обеспечить выполнение операторов: 

StatusBarl->Panels->Items[(0]->Text = 

IntToStr((int) RichEditl->CaretPos.y+1l) + 
"; "+IntToStr((int)RichEditl-CaretPos.x+1) ; 
if (RichEdit1l->Modified) 
StatusBarl->Panels->Items[1]->Text = "модиф." 
else StatusBarl->Panels->Items[1]->Text = ""; 


Эти операторы заполняют первые две панели полосы состояния. Занесение в 
строку состояния подсказок описано в разделе 4.1.9. 


3.7.8 Фреймы 


В C++Builder 5 введен новый компонент, который помогает поддерживать 
стилистическое единство приложения. Это Frame — фрейм. Он представляет собой 
нечто среднее между панелью и формой. С формой его роднит то, что он: 


Ш проектируется отдельно, как самостоятельное окно 
Ш имеет свой модуль — файл .cpp 
Ш имеет возможности наследования, причем даже более широкие, чем у формы, 
так как может наследоваться даже внутри одного приложения 
Ш может включаться в Депозитарий и использоваться так же, как и форма, 
включая наследование 
С панелью фрейм роднит то, что он: 
Ш не является самостоятельным окном Windows и может отображаться только 
на форме или другом контейнере 
Ш имеет свойства, методы, события, подобные панели, а не форме 
Таким образом, фрейм — это панель, т.е. некий фрагмент окна приложения, 
но способный переноситься на разные формы, в разные приложения и допускаю- 
щий использование преимуществ наследования. 
Начать проектирование нового фрейма можно командой File | New Frame или 
командой File | New и выбором пиктограммы Frame на странице New окна Депозита- 


рия. В обоих случаях перед вами откроется окно фрейма, подобное окну формы, а 
в Редакторе Кода вы увидите текст заготовки модуля фрейма: 


#include "Unit2.h" 


TFrame2 *Frame2; 
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/* 

Сюда могут помещаться объявления типов, констант, переменных, к которым 
не будет доступа из других модулей. Они будут едины для всех объектов 
фреймов. Тут же должны быть реализации всех объявленных в заголовочном 
файле функций, а также могут быть реализации любых дополнительных, не 
‚объявленных ранее функций 


вл 


// Заготовка конструктора 

__fastcall TFrame2::TFrame2 (TComponent* Owner) 
: TFrame (Owner) 

{ 

} 


Если, щелкнув правой кнопкой мыши в окне Редактора Кода вы выберете в 
контекстном меню раздел Open Source\Header File, то увидите заготовку заголовоч- 
ного файла модуля фрейма: 


// Объявление класса фрейма 
class TFrame2 : public TFrame 


{ 

_ published: // IDE-managed Components. 

/* 

Сюда C++Builder помещает объявления компонентов, размещаемых на фрейме. 
Не добавляйте сюда ничего вручную 

27/4 

private: // User declarations 

/* 

Закрытый раздел класса. Сюда могут помещаться объявления переменных и 
функций, включаемых в класс фрейма, но не доступных для других модулей 
“7 


public: // User declarations 


Открытый раздел класса. Сюда могут помещаться объявления переменных и 

функций, включаемых в класс фрейма и доступных для других модулей 

*/ 

// Объявление конструктора 

__fastcall TFrame2 (TComponent* Омпег); 

}; 

Комментарии в приведенном тексте поясняют, куда и что можно помещать в 
модуле. Те переменные, объявления которых вы поместите в объявление класса, 
будут индивидуальны для каждого объекта фрейма. Объявления имеют обычный 
для класса вид. Например: 


int A; 

Если вы хотите ввести переменную, общую для всех объектов фреймов, ee 
надо объявить со спецификатором static. Например: 

static int А; 


В этом случае надо He забыть инициализировать эту переменную вне объявле- 
ния класса, например, оператором 


int TFrame2::A = 0; 


Здесь для доступа к статической переменной использовано имя класса 
TFrame2 и бинарная операция разрешения области действия «::». Если не сделать 
такой инициализации, то будет выдано сообщение компилятора о неразрешенной 
внешней ссылке и программа не будет скомпилирована. Те, кому не очень понят- 
ны эти операции со статическими элементами-данными класса, могут найти под- 
робные разъяснения всех вопросов, связанных с объявлением классов, в главе 13. 
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На фрейм вы можете так же, как на форму, переносить и размещать любые 
компоненты, устанавливать их свойства, писать обработчики их событий и т.п. 

Давайте создадим чисто тестовый фрейм, чтобы на его примере продемонстри- 
ровать проектирование фрейма, его использование, доступ к различным его эле- 
ментам и наследование свойств. 

Начните новое приложение и выполните команду File | New Frame. Перенесите 
на фрейм групповую панель GroupBox (см. раздел 3.5.3). Перенесите на панель 
метку Label и три кнопки Button. Разместите все эти компоненты примерно так, 
как показано на рис. 3.45, изменив соответственно их надписи (Caption) и назвав 
кнопки соответственно BSetup, Вте, BShow. 


Рис. 3.45 
Пример фрейма а ie 


- > Setup = г 


Давайте введем в наш модуль в разных местах объявления целых перемен- 
ных, а в обработчики событий кнопок введем операторы, манипулирующие ими и 
отображающие результат в метке. Заголовочный файл фрейма должен приобрести 
следующий вид: 


class TFrame2 : public TFrame 

{ 

_ published: // IDE-managed Components 
TGroupBox *GroupBoxl; 
TLabel *Labell; 
TButton *BSetup; 
TButton *ВТпс; 
TButton *BShow; 
void _fastcall BSetupClick(TObject *Sender) ; 
void _fastcall BIncClick(TObject *Sender) ; 
void _fastcall BShowClick(TObject *Sender); 


private: // User declarations 

//Переменная А видна только в данном модуле 
nt. Ах 

public: // User declarations 

//Переменные В и С видны в других модулях через объект фрейма 
int В; 


static ‘int: С; 
__fastcall TFrame2(TComponent* Owner) ; 
}; 
//Инициализация статической переменной 
int TFrame2::C = 1; 


] 
Файл реализации модуля фрейма должен иметь вид: 


TFrame2 *Frame2; 

//Переменная ПВ видна только в данном модуле 
А.О: 

// 
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_ fastcall TFrame2::TFrame2 (TComponent* Owner) 
TFrame (Owner) 


void _fastcall TFrame2::BSetupClick(TObject *Sender) 


A 1; 

B = 1; 

С. ee 

р = 1; 

Labell->Caption = "A="+IntToStr(A)+ " B="+IntToStr (В) + 
* C="*4+IntToStr(C) + * De ?4+intTostr(D) : 

} 

// 


void  fastcall TFrame2::BIncClick(TObject *Sender) 


A += 1; 

В. += 1; 

Cope 1 

D += 1; 

Labell->Caption = "A="+IntToStr(A)+ " B="+IntToStr (В) + 
" C="4IntToStr(C)+ " D="+IntToStr (0); 

} 

// 


void  fastcall TFrame2::BShowClick(TObject *Sender) 


{ 
Labell->Caption = "A="+IntToStr(A)+ " B="+IntToStr (В) + 
*CH"+IntToStr (Cc) +. * De*4+iIntTostr (Dd) ; 


} 
B модуле введены переменные: 


А — введена в закрытый раздел класса; видна только в процедурах данного 
класса в этом модуле; независимые друг от друга переменные А будут содер- 
жаться в каждом объекте фрейма | 

В — введена в открытый раздел класса; в других модулях можно получить до- 
ступ к В через имя объекта фрейма; независимые друг от друга переменные В 
будут содержаться в каждом объекте фрейма 


С — введена в открытый раздел класса как статическая переменная; в других 
модулях можно получить доступ к С через имя класса фрейма с помощью би- 
нарной операции разрешения области действия «::» или через имя любого объ- 
екта фрейма; имеется единственный экземпляр С, независимо от числа объек- 
тов фреймов 

D — введена в реализацию класса; доступна только в данном модуле; имеется 
единственный экземпляр D, независимо от числа объектов фреймов 


Введенные в модуль обработчики щелчков на кнопках обеспечивают сброс 


всех переменных в 1 (процедура TFrame2::BSetupClick), увеличение всех перемен- 
ных Ha 1 (процедура TFrame2::BIncClick), отображение текущего состояния пере- 
менных (процедура TFrame2::BShowClick). 


Теперь давайте разместим несколько экземпляров фрейма на форме. Перейди- 


те в основную форму приложения и выберите в палитре компонентов Frame (пер- 
вая кнопка на странице Standard). Появится диалоговое окно, в котором будет 
спрашиваться, какой фрейм вы хотите разместить на форме. Выберите ваш фрейм 
Frame2 и он появится на форме. Можете отбуксировать его, как обычный компо- 
нент, в нужное место. Повторите эту операцию еще раз и разместите на форме вто- 
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рой фрейм (рис. 3.46). Добавьте внизу формы кнопку Show, а вверху — метку, за- 
дав ее свойство Align равным а!Тор и свойство Alignment равным taCenter. 


Рис. 3.46 
Пример использования фреймов: форма (а) и приложение в 
работе (6) 


©) CRS - OT] 


Вы получили форму, содержащую два объекта — фрейма. Можете изменить 
какие-то свойства объектов. Например, изменить надписи (Caption) групповых па- 
нелей GroupBox (см. рис. 3.46 а). После того, как вы изменили эти свойства, они 
перестают наследоваться из класса фрейма. А остальные свойства продолжают на- 
следоваться. В этом легко убедиться. Перейдите в модуль фрейма (рис. 3.45) и из- 
мените у фрейма стиль шрифта (Font->Style) на жирный. Вы увидите, что в обоих 
объектах главной формы шрифт тоже станет жирным. Верните во фрейме шрифт 
на обычный и он синхронно изменится в объектах. А теперь установите в одном из 
фреймов на форме шрифт жирным. Повторив после этого эксперимент с изменени- 
ем шрифта в исходном фрейме, вы увидите, что теперь шрифт меняется только в 
том объекте формы, в котором вы его не изменяли вручную. Таким образом объек- 
ты наследуют только те свойства, которые не были в них установлены вручную. 

Теперь давайте напишем обработчик щелчка на кнопке главной формы. Преж- 
де всего взгляните на текст заголовочного файла модуля вышей формы (щелкните 
правой кнопкой мыши в окне Редактора Кода и выберите в контекстном меню раз- 
дел Open Source\Header File). Вы увидите, что в нем в описании класса формы поя- 
вились две строки: 


TFrame2 *Frame21; 
TFrame2 *Frame22; 


Это объявления указателей Ha объекты фреймов. Все компоненты, размещен- 
ные на фреймах, напрямую из модуля формы не видны. Доступ к ним можно полу- 


206 Глава 3 


чить только через объекты Егате21 и Егате22. Имена компонентов, размещен- 
ных во фреймах, локальные. Несмотря на то, что во фреймах имеются кнопки с 
именами BShow, вы можете назвать тем же именем кнопку на форме. 
Поместите в обработчик щелчка на этой кнопке оператор 
Labell->Caption = "B(Frame21)="+IntToStr (Frame21->B) + 


", B(Frame22)="+IntToStr (Frame22->B) + 
", C="4IntToStr(TFrame2::C); 


Он отображает в метке Labell значения переменных В объектов фреймов. O6- 
ращение к переменной С осуществлено через имя класса фрейма ТЕгате2::С. К 
ней можно было бы обратиться и через объекты фреймов: Frame21->C или 
Frame22->C. Все три формы обращения дают один и тот же результат. Значения 
переменных А и О отобразить невозможно, поскольку эти переменные недоступны 
из внешних модулей. Если вы попытаетесь отобразить их значения, компилятор 
выдаст сообщение об ошибке. 

Сохраните ваше приложение, оттранслируйте его и выполните. Манипулируя 
кнопками, вы легко сможете убедится (см. рис. 3.46 6), что переменные A и В неза- 
висимы для каждого фрейма, а переменные С и D одинаковы. Точнее оба фрейма 
оперируют с одними и теми же переменными С и В. 

Рассмотренный фрейм не имел никакого практического значения. Давайте по- 
строим более полезный пример. Во многих диалогах при установке различных оп- 
ций фигурирует фрагмент, фрейм которого показан на рис. 3.47. Фрагмент вклю- 
чает в себя панель GroupBox, окно редактирования, в котором пользователь может 
написать имя файла, и кнопку Обзор, которая позволяет выбрать файл в стандарт- 
ном диалоге Windows открытия файла. Если путь к файлу длинный, то полное имя 
файла с путем может не помещаться в окне редактирования. Поэтому полезно для 
него предусмотреть всплывающее окно, которое отображало бы полное имя файла 
вместе с путем и всплывало бы, если пользователь задержал над ним курсор мыши. 


Рис. 3.47 
Фрейм выбора файла 


Давайте построим подобный фрейм и опробуем его в работе. Начните новое 
приложение и выполните команду File | New Frame. Перенесите на фрейм групповую 
панель GroupBox. Перенесите в эту панель окно редактирования Edit, кнопку 
Button, метку, диалог OpenDialog (см. раздел 3.8.2) и компонент Application- 
Events — перехватчик событий приложения (см. раздел 3.9.3). Расположите ком- 
поненты примерно так, как показано на рис. 3.47, 

Задайте в свойстве Filter диалога OpenDialog какой-то фильтр файлов, напри- 
мер, «все файлы*.*». Свойство ShowHint (показать ярлычок подсказки) в компо- 
нентах Edit и Button установите в true. В кнопке Button кроме того можете напи- 
сать текст подсказки Hint, например, «Выбор файла|Выбор файла из каталога». 

В обработчик события OnShowHint компонента ApplicationEvents занесите 
оператор: 

if (HintiIinfo.HintControl == Editi) 

if (Canvas->TextWidth (Editl->Text))\ > Editl->ClientWidth) 
{ 

HintStr = Editl->Text; 
ApplicationEvents1->CancelDispatch(); 

} 
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Этот оператор в момент, когда должен отображаться ярлычок, проверяет, не 
является ли источником этого события (HintInfo.HintControl) окно редактирова- 
ния Editl. Если да, то проверяется, не превыптает ли длина текста длины клиент: 
ской области Editl. Если превышает, то текст ярлычка (HintStr) подменяется тек- 
стом, содержащимся в окне редактирования и принимаются меры (метод 
CancelDispatch), чтобы это событие He обрабатывалось другими компонентами 
ApplicationEvents, которые могут присутствовать в приложении. Пояснение всех 
этих операций см. в разделе 3.9.3. 

Теперь введите в модуль фрейма глобальную переменную FileName типа 
string, в которой будет хранится имя выбранного файла. В обработчик щелчка на 
кнопке введите оператор 

if (OpenDialogl->Execute())) 

{ | 

Editl->Text = OpenDialogl->FileName; 
FileName = OpenDialogl->FileName; 

} 
который вызывает диалог открытия файла и помещает в окно редактирования 
Editl и в переменную FileName имя файла, BHORAEN GHA пользователем, вместе. с 


путем к нему. | 
В обработчик и ОпЕх компонента Edit] поместите оператор 


FileName = Editl->Text; 


заносящий в переменную FileName имя файла, если пользователь не пользовался 
диалогом, а просто написал в окне имя файла. 

Программирование фрейма закончено. Теперь создайте тестовую программу, 
использующую этот фрейм. Предположим, что вам нужно разместить на форме 
два фрагмента, описанных вами во фрейме. Перейдите в основной модуль вашего 
приложения и разместите на форме так, как вы уже делали, два объекта вашего 
фрейма (рис. 3.48 а). 


Рис. 3.48 &7 Фреймы выбора файлов 
Приложение с двумя фреймами выбора файла: его форма afan - 
(a) и приложение во время выполнения (6) 


Pann D:\Program Files\B = Обзор... 
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Теперь вы можете поменять что-то в размещенных на форме объектах фрей- 
мов, изменить надписи групповых панелей, шрифты и т.п. Сохраните ваше прило- 
жение вместе с модулем фрейма, оттранслируйте его и проверьте в работе 
(рис. 3.48 6). 

Вы разработали достаточно полезный фрейм и можете сохранить его в Депози- 
тарии, чтобы в дальнейшем использовать в различных приложениях. Причем, 
если вы что-то измените во фрейме, хранящемся в Депозитарии, то все приложе- 
ния, в которых использован этот фрейм, будут наследовать эти изменения. Благо- 
даря использованию наследования, фрейм позволяет обеспечить единство стили- 
стических решений не только внутри приложения, но и в рамках серии разрабаты- 
ваемых вами приложений. Вам достаточно один раз разработать какие-то часто 
применяемые фреймы, включить их в Депозитарий, а затем вы можете использо- 
вать их многократно во всех своих проектах. Подробности о внесении в Депозита- 
рий, о заимствовании из него форм и фреймов и о наследовании их свойств см. в 
главе 7 в разделе 7.4. 


3.8 Системные диалоги 


3.8.1 Общая характеристика компонентов — диалогов 


В приложениях часто приходится выполнять стандартные действия: откры- 
вать и сохранять файлы, задавать атрибуты шрифтов, выбирать цвета палитры, 
производить контекстный поиск и замену и т.п. 

Разработчики C++Builder позаботились о TOM, чтобы включить в библиотеку 
простые для использования компоненты, реализующие соответствующие диалого- 
вые окна. Они размещены на странице Dialogs. В таблице 3.6 приведен перечень 
этих диалогов. 


ia 3.6. Системные диалоги и их м 


йееог-: | oiaionewe = Oriani: "Юимениыи”: ty 
рамма 


OpenDialog Dialogs Предназначен для создания окна 
| 
| 


«Открыть файл» диалога «Открыть файл». 


Предназначен для создания окна 
диалога «Сохранить файл». 


Dialogs 


«Сохранить файл» 


OpenPictureDialog 
«Открыть рисунок» 


* 


Предназначен для создания окна 
диалога «Открыть рисунок», от- 
крывающего графический файл. 


Dialogs Предназначен для создания окна 
диалога «Сохранить рисунок» — 
сохранение изображения в графи- 
ческом файле. 

Dialogs Предназначен для создания окна 
диалога «Шрифты» — выбор ат- 
рибутов шрифта. 


Dialogs Предназначен для создания окна 
диалога «Цвет» — выбор цвета. 


Dialogs 


| Dialogs 


SavePictureDialog 
«Сохранить рисунок» 


FontDialog 
«Шрифты» 


PrintDialog 
| «Печать» ae 


Предназначен для создания окна 
диалога «Печать». 


Обзор компонентов библиотеки C++Builder 209 


| Пиктог- | Компонент траница | Описание 
рамма 


PrinterSetupDialog Dialogs Предназначен для создания окна 
‹ Установка принте- диалога «Установка принтера». 
ра» 


FindDialog Dialogs Предназначен для создания окна 
«Найти» диалога «Найти» — контекстный 
поиск в тексте. 


ReplaceDialog Dialogs Предназначен для создания окна 
«Заменить» диалога «Заменить» — контекст- 
ная замена фрагментов текста. 
FileListBox Win 3.1 Отображает список всех файлов 
(список файлов) каталога. 
DirectoryListBox Win 3.1 Отображает структуру каталогов 
же (структура каталогов) диска. 
= DriveComboBox Win 3.1 Выпадающий список доступных 
(список дисков) дисков. 


(список фильтров) для поиска файлов. 


CDirectoryOutline Samples Пример компонента, используемо- 
(дерево каталогов) го для отображения структуры ка- 


талогов выбран ного диска. 


FilterComboBox Win 3.1 Выпадающий список фильтров 


Последние пять компонентов в таблице 3.6 являются не законченными диало- 
гами, а их фрагментами, позволяющими строить свои собственные диалоговые 
окна. 

Все диалоги являются невизуальными компонентами, так что место их разме- 
щения на форме не имеет значения. При обращении к этим компонентам вызыва- 
ются стандартные диалоги, вид которых зависит от версии Windows и настройки 
системы. Так что при запуске одного и того же приложения на компьютерах с раз- 
ными системами диалоги будут выглядеть по-разному. Например, при русифици- 
рованной версии Windows все их надписи будут русскими, а при англоязычной 
версии надписи будут на английском языке. 

Основной метод, которым производится обращение к любому диалогу, — 
Ехесще. Эта функция открывает диалоговое окно и, если пользователь произвел в 
нем какой-то выбор, то функция возвращает true. При этом в свойствах компонен- 
та — диалога запоминается выбор пользователя, который можно прочитать и ис- 
пользовать в дальнейших операциях. Если же пользователь в диалоге нажал кноп- 
ку Отмена или клавишу Esc, то функция Execute возвращает false. Поэтому стан- 
дартное обращение к диалогу имеет вид: 


if (<имя компонента — диалога> -> Ехесосе()) 
<оператор, использующиа выбор пользователя>; 


3.8.2 Диалоги открытия и сохранения файлов — компоненты 
OpenDialog, SaveDialog, OpenPictureDialog, 
SavePictureDialog | 

Компоненты OpenDialog — диалог «Открыть файл» и SaveDialog — диалог 


«Сохранить файл как...», пожалуй, используются чаце всего, в большинстве прило- 
жений. Примеры открываемых ими диалоговых окон приведены на рис. 3.49 и 3.50. 
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Рис. 3.49 


Диалоговое окно открытия файла 


Рис. 3.50 


Диалоговое окно сохранения файла 
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Все свойства этих компонентов одинаковы, только их смысл несколько разли- 
чен для открытия и сохранения файлов. Основное свойство, в котором возвращает- 
ся в виде строки выбранный пользователем файл, — FileName. Значение этого 
свойства можно задать и перед обращением к диалогу. Тогда оно появится в диало- 
ге как значение по умолчанию в окне Имя файла (см. рис. 3.49, 3.50). 

Типы искомых файлов, появляющиеся в диалоге в выпадающем списке Тип 
файла (рис. 3.49, 3.50), задаются свойством Filter. В процессе проектирования это 
свойство проще всего задать с помощью редактора фильтров, который вызывается 
нажатием кнопки с многоточием около имени этого свойства в Инспекторе Объек- 
тов. При этом открывается окно редактора, вид которого представлен на рис. 3.51. 
В его левой панели Filter Мате вы записываете тот текст, который увидит пользова- 
тель в выпадающем списке Тип файла диалога. А в правой панели Filter записывают- 
ся разделенные точками с запятой шаблоны фильтра. В примере рис. 3.51 задано 
два фильтра: текстовых файлов с расширениями .txt и .doc и любых файлов с шаб- 


JIOHOM «*,*», 


Puc. 3.51 
Окно редактора фильтров 


Filter Edit 


` [текстовые (“txt doc) “tt: “doc | 
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После выхода из окна редактирования фильтров заданные вами шаблоны поя- 
вятся в свойстве Filter в виде строки вида: 


текстовые (*.txt, *.doc)|*.txt; *.doc|Bce файлы|*.* 


В этой строке тексты и шаблоны разделяются вертикальными линиями. В 
аналогичном виде, если требуется, можно задавать свойство Filter программно во 
время выполнения приложения. 

Свойство FilterIndex определяет номер фильтра, который будет по умолчанию 
показан пользователю в момент открытия диалога. Например, значение 
FilterIndex = 1 задает по умолчанию первый фильтр. 

Свойство InitialDir определяет начальный каталог, который будет открыт в 
момент начала работы пользователя с диалогом. Если значение этого свойства не 
задано, то открывается текущий каталог или тот, который был открыт при послед- 
нем обращении пользователя к соответствующему диалогу в процессе выполнения 
данного приложения. 

Свойство DefaultExt определяет значение расширения файла по умолчанию. 
Если значение этого свойства не задано, пользователь должен указать в диалоге 
полное имя файла с расширением. Если же задать значение DefaultExt, то пользо- 
ватель может писать в диалоге имя без расширения. В этом случае будет принято 
заданное расширение. 

Свойство Title позволяет вам задать заголовок диалогового окна. Если это 
свойство не задано, окно открывается с заголовком, определенным в системе (на- 
пример, «Открытие файла» в окне на рис. 3.49). Но вы можете задать и свой заго- 
JIOBOK, подсказывающий пользователю ожидаемые действия. Например, «Укажи- 
те имя открываемого файла». 

Свойство Options определяет условия выбора файла. Множество опций, KOTO- 
рые вы можете установить программно или во время проектирования, включает: 


а а ный 


ofAllowMultiSelect Позволяет пользователю выбирать несколько файлов 


ofCreatePrompt В случае, если пользователь написал имя несуществу- 
ющего файла, появляется замечание и запрос, надо ли 
создать файл с заданным именем 


ofEnableIncludeNotify Разрешает посылать в диалог сообщения 


ofEnableSizing Разрешает пользователю изменять размер диалогового 
окна 
ofExtensionDifferent Этот флаг, который можно прочитать после выполне- 


ния диалога, показывает, что расширение файла, вы- 
бранного пользователем, отличается от DefaultExt 


ofFileMustExist В случае, если пользователь написал имя несуществу- 
ющего файла, появляется сообщение об ошибке 

ofHideReadOnly Удаляет из диалога индикатор Открыть только для чтения 

ofNoChangeDir После щелчка пользователя на кнопке OK восстанав- 


ливает текущий каталог, независимо от того, какой 
каталог был открыть при поиске файла 


ofNoDereferenceLinks  Запрещает переназначать клавиши быстрого доступа в 
диалоговом окне 


ofNoLongNames Отображаются только He более 8 символов имени и 
трех символов расширения 


ofNoNetworkButton Убирает из диалогового окна кнопку поиска в сети. 
Действует только если флаг ofOldStyleDialog включен 
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ofNoReadOnlyReturn — Если пользователь выбрал файл только для чтения, TO 
генерируется сообщение об ошибке 


ofNoTestFileCreate Запрещает выбор в сети защищенных файлов и не до- 
ступных дисков при сохранении файла 


ofNoValidate Не позволяет писать в именах файлов неразрешенные 
символы, но не мешает выбирать файлы с неразрешен- 
ными символами 


ofOldStyleDialog Создает диалог выбора файла в старом стиле (см. 
рис. 3.52) 
ofOverwritePrompt В случае, если при сохранении файла пользователь на- 


писал имя существующего файла, появляется замечание, 
что файл с таким именем существует, и запрашивается 
желание пользователя переписать существующий файл 


ofPathMustExist Генерирует сообщение об ошибке; если пользователь 
указал в имени файла несуществующий каталог 


ofReadOnly По умолчанию устанавливает индикатор Открыть TO- 
лько для чтения при открытии диалога 


ofShareAware Игнорирует ошибки нарушения условий коллективно- 
го доступа и разрешает, несмотря на них, производить 
выбор файла 


ofShowHelp Отображает в диалоговом окне кнопку Справка 


По умолчанию все перечисленные опции, кроме ofHideReadOnly, выключены. 
Но, как видно из их описания, многие из них полезно включить перед вызовом 
диалогов. | 

Если вы разрешаете с помощью опции ofAllowMultiSelect множественный 
выбор файлов, то список выбранных файлов можно прочитать в свойстве Files 
типа TStrings. 

В приведенной таблице даны опции, используемые в 32-разрядных версиях 
C++Builder. При включении опции ofOldStyleDialog диалоговое окно имеет вид, 
представленный на рис. 3.52. В примере рис. 3.52 диалог открыт с заданным зна- 
чением свойства Title и заданный текст отображается в заголовке окна. Кроме 
того, в этом примере выключена опция ofHideReadOnly, что привело к появлению 
индикатора Только чтение. 

В компонентах диалогов открытия и сохранения файлов предусмотрена BO3- 
можность обработки ряда событий. Такая обработка может потребоваться, если 
рассмотренных опций, несмотря на их количество, не хватает, чтобы установить 


Рис. 3.52 

Диалог в старом стиле при включенной 
опции ofOldStyleDialog и выключенной 
опции ofHideReadOnly. 
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все диктуемые конкретным приложением ограничения на выбор файлов. Событие 
OnCanClose возникает при нормальном закрытии пользователем диалогового окна 
после выбора файла. При отказе пользователя от диалога — нажатии кнопки Отме- 
на, клавиши Esc и т.д. событие OnCanClose не наступает. В обработке события 
OnCanClose вы можете произвести дополнительные проверки выбранного пользо- 
вателем файла и, если по условиям вашей задачи этот выбор недопустим, вы може- 
те известить об этом пользователя и задать значение false передаваемому в обра- 
ботчик параметру CanClose. Это не позволит пользователю закрыть диалоговое 
окно. 

Можно также написать обработчики событий OnFolderChange — изменение 
каталога, OnSelectionChange — изменение имени файла, OnTypeChange — изме- 
нение типа файла. В этих обработчиках вы можете предусмотреть какие-то сооб- 
щения пользователю. 

Теперь приведем пример использования диалогов OpenDialog и SaveDialog. 
Пусть ваше приложение включает окно редактирования КаеВЕЧИТ (cm. раз- 
дел 3.2.4), в которое по команде меню MainMenu (см. раздел 3.6.1) Открыть вы хо- 
тите загружать текстовый файл и после каких-то изменений, сделанных пользова- 
тёлем, — сохранять по команде Сохранить текст в том же файле, а по команде Со- 
хранить как — в файле с другим именем. 

Введите на форму компоненты — диалоги OpenDialog и SaveDialog. Предпо- 
ложим, что вы оставили их имена по умолчанию — OpenDialog1 и SaveDialog1. 
Поскольку после чтения ‘файла вам надо запомнить его имя, чтобы знать под ка- 
ким именем потом его сохранять, вы можете определить для этого имени перемен- 
ную, назвав ее, например, MyFName. Для этого в модуле формы объявите эту гло- 
бальную переменную: 


AnsiString MyFName =""; 


Тогда обработка команды Открыть может сводиться к следующему оператору: 


if (OpenDialogl->Execute() ) 

{ 

MyFName = OpenDialogl->FileName; 
RichEditl->Lines->LoadFromFile (OpenDialog1l->FileName) ; 
} 


Этот оператор вызывает диалог, проверяет, выбрал ли пользователь файл 
(если выбрал, то функция Execute возвращает true), после чего имя выбранного 
файла (OpenDialogl1->FileName) сохраняется в переменной MyFName и файл за- 
гружается в текст RichEdit1 методом LoadFromFile. 

Обработка команды Сохранить как выполняется операторами: 

SaveDialogl->FileName = MyFName; 


if (SaveDialogl->Execute () ) 

{ 

MyFName = SaveDialogl->FileName; 
RichEdit1l->Lines->SaveToFile (SaveDialogl->FileName) ; 


Первый из этих операторов присваивает свойству FileName компонента Save- 
01а1071 запомненное имя файла. Это имя по умолчанию будет предложено пользо- 
вателю при открытии диалога Сохранить как. Следующий оператор открывает диа- 
лог и, если пользователь выбрал в нем файл, запоминает новое имя файла и сохра- 
няет в файле с этим именем текст компонента RichEdit1. 

Обработка команды Сохранить выполняется операторами 

1Е (МуЕМате != "") 

RichEdit1l->Lines->SaveToFile (MyFName) ; 
else 
if (SaveDialog1l->Execute() ) 


{ 
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МуЕМаме = SaveDialogl->FileName; 
RichEdit1->Lines->SaveToFile (SaveDialogl->FileName) ; 
} 


Если имя файла MyFName не равно пустой строке, т.е. известно, то нет необ- 
ходимости обращаться к какому-то диалогу. Текст сохраняется методом ЗауеТоЕ1- 
le. Если же имя файла неизвестно, то текст сохраняется с помощью диалога Save- 
Dialog1 так же, как было рассмотрено выше. 


Мы рассмотрели диалоги открытия и сохранения файлов произвольного типа. 
В библиотеке C++Builder 5 имеются также специализированные диалоги откры- 
тия и сохранения графических файлов: OpenPictureDialog и SavePictureDialog. 
Пример окна, открываемого этими компонентами вы можете увидеть, например, 
на рис. 5.2 в разделе 5.1.1.1 главы 5. От окон, открываемых компонентами 
OpenDialog и SaveDialog (рис. 3.49, 3.50), они отличаются удобной возможностью 
просматривать изображения в процессе выбора файла. 

Свойства компонентов OpenPictureDialog и SavePictureDialog ничем He отли- 
чаются от свойств компонентов OpenDialog и SaveDialog. Единственное отли- 
чие — заданное значение по умолчанию свойства Filter в OpenPictureDialog и 
SavePictureDialog. В этих компонентах заданы следующие фильтры: 


НАЯ 


ея о ао EEE а ОВО О о EL DRE BISBEE, 


АП (*.jpg;* jpeg:*.bmp;*.ico; * emf ;>*.wmf) *.jpg;*.jpeg;*.bmp;*.ico;*.emf;*.wmf 
JPEG Image File (*.jpg) * jpg 

JPEG Image File (*.jpeg) * jpeg 

Bitmaps (*.bmp) * bmp 

Icons (*.ico) * ico 

Enhanced Metafiles (*.emf) * emf 

Metafiles (*.wmf) * wmf 


В этих фильтрах перечислены все типы графических файлов, с которыми MO- 
жет работать диалог. Так что вам остается удалить, если хотите, фильтры тех фай- 
лов, с которыми вы не хотите работать, добавить, может быть, фильтр «Все файлы 
(*.*)» и перевести на русский язык названия типов. 


3.8.3 Фрагменты диалогов — компоненты DriveComboBox, 
DirectoryListBox, FilterComboBox, FileListBox 
и CDirectoryOutline _ 


Помимо законченных диалогов работы с файлами, в C++Builder имеется ряд 
компонентов, представляющих собой фрагменты диалогов: выпадающие списки 
дисков (драйверов) — DriveComboBox и фильтров (масок) файлов — 
FilterComboBox, списки каталогов — DirectoryListBox и файлов — FileListBox, 
дерево каталогов — CDirectoryOutline. Внешний вид этих компонентов вы можете 
увидеть на рис. 3.53. Компоненты работы с файловой системой облегчают вам соз- 
дание собственных диалоговых окон, что нередко требуется. Например, вы можете 
захотеть включить в диалоговое окно отображение каких-то характеристик фай- 
лов (размера, даты создания ит.п.) или оперативный просмотр содержания тексто- 
вых файлов. Тогда вам очень пригодятся готовые компоненты работы с файлами. 
Правда, все они, кроме CDirectoryOutline, расположены на странице Win 3.1 па- 
литры компонентов. Это значит, что они не рекомендуются для 32-разрядных при- 
ложений. Но, во-первых, у вас остается компонент CDirectoryOutline. Кроме того, 
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Рис. 3.53 


Компоненты — фрагменты 


диалогов АИ 
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никто не запрещает вам все-таки использовать и остальные компоненты в любых 
приложениях C++Builder. И, наконец, если уж вы хотите четко следовать реко- 
мендации не использовать первые четыре фрагмента диалогов в 32-разрядных 
приложениях, вы можете разработать свои аналогичные компоненты, используя 
обычный компонент ComboBox. 

Начнем рассмотрение компонентов работы с файловой системой с компонента 
DriveComboBox — выпадающего списка дисков (драйверов). При размещении на 
форме этот компонент автоматически отображает список имеющихся на компью- 
тере дисков. Во время выполнения приложения вы можете прочитать имя выбран- 
ного пользователем диска в свойстве Drive, а строку, содержащуюся в окне спи- 
ска — в свойстве Text. 

Свойство TextCase задает регистр отображения: фе ОррегСазе — в верхнем ре- 
‘гистре, tecLowerCase — в нижнем. 

Связать компонент DriveComboBox со списком каталогов, отображаемых ком- 
понентом DirectoryListBox, можно во время проектирования через свойство 
DirList компонента DriveComboBox. Это свойство может указывать на компонент 
типа DirectoryListBox. Можно обеспечить связь этих двух типов компонентов и 
программно, включив в обработчик события OnChange компонента 
DriveComboBox оператор 


DirectoryListBox1l->Drive = DriveComboBox1->Drive; 


Этот оператор задает имя диска, выбранное пользователем в компоненте 
DriveComboBox1, свойству Drive списка каталогов DirectoryListBoxl1. 

Аналогичным оператором можно обеспечить связь компонента 
DriveComboBox с деревом каталогов и файлов в компоненте CDirectoryOutline: 


CDirectoryOutlinel->Drive = DriveComboBoxl->Drive; 


Рассмотрим теперь выпадающий список фильтров — компонент FilterCombo- 
Вох. Его основное свойство — Filter, которое задается так же, как в описанных pa- 
нее диалогах. К отдельным частям фильтра — тексту и маске, можно получить 
доступ через свойства Text и Mask соответственно. Связь компонента со списком 
файлов типа TFileListBox можно установить, задав свойство FileList. 

Компонент DirectoryListBox отображает список каталогов диска, заданного 
свойством Drive. Значение этого свойства можно установить программно во время 
выполнения. Как уже говорилось выше, связь этого свойства с выбранным пользо- 
вателем диском в компоненте DriveComboBox устанавливается или программно, 
или с помощью свойства DirectoryListBox компонента DriveComboBox. 

Связь списка каталогов с компонентом типа TFileListBox, отображающим 
список файлов, осуществляется с помощью свойства FileList. Можно также ис- 
пользовать результаты выбора пользователем каталога, читая свойство Directory в 
обработчике события OnChange. 
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С компонентом DirectoryListBox можно также связать метку типа Label. В 
этой метке будет отображаться путь к текущему каталогу. Если путь не умещается 
в метке, он автоматически отображается в сокращенном виде (см. рис. 3.53) с по- 
мощью функции MinimizeName. Метка, отображающая каталог, указывается в 
свойстве DirLabel. 

Список файлов содержится в компоненте FileListBox. Его свойства Drive, 
Directory и Mask определяют соответственно диск, каталог и маску файлов. Эти 
свойства можно устанавливать программно или связывая описанным ранее способом 
компонент FileListBox с компонентами DriveComboBox, DirectoryListBox и 
FilterComboBox. Свойство FileType позволяет включать в список не все файлы, a 
только те, которые имеют соответствующие атрибуты. Свойство FileType представля- 
ет собой множество, указывающее типы включаемых файлов. Элементы этого мно- 
жества могут иметь значения: ftReadOnly — только для чтения, ftHidden — неви- 
димые, ftSystem — системные, ftVolumeID — обозначения дисков, ftDirectory — 
каталоги, ftArchive — архивные, ftNormal — не имеющие особых атрибутов. 

Свойство ShowGlyphs разрешает или исключает показ пиктограмм файлов (в 
примере рис. 3.53 это свойство = true). 

Свойство MultiSelect разрешает выбор нескольких файлов. 

Основное свойство, в котором можно прочитать имя выбранного пользовате- 
лем файла — FileName. 

Со списком файлов может быть связано окно редактирования Edit, в котором 
отображается выбранный файл (см. окно над списком файлов на рис. 3.53). На этот 
список указывает устанавливаемое во время проектирования свойство FileEKdit. 


Теперь рассмотрим компонент CDirectoryOutline, содержащий дерево катало- 
гов. В этом компоненте значение диска устанавливается свойством Drive. Теку- 
щий каталог, выбранный пользователем, можно прочитать в свойстве Directory. 
Свойство TextCase определяет стиль отображения имен каталогов: tcLowerCase — 
преобразование к нижнему регистру, tcUpperCase — к верхнему, tcAsIs — без 
преобразования (этот режим использован в примере рис. 3.53). Остальные свойст- 
ва идентичны компоненту OutLine, на основе которого построен данный пример. 
Вы можете найти исходный текст этого примера в каталоге ...\source\samples. 


3.8.4 Диалог выбора шрифта — компонент FontDialog 


Компонент FontDialog вызывает диалоговое окно выбора атрибутов шрифта, 
представленное на рис. 3.54. В нем пользователь может выбрать имя шрифта, его 
стиль (начертание), размер и другие атрибуты. 


Рис. 3.54 Выбор шрифта 
Диалоговое окно выбора атрибутов Е 
шрифта 
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Основное свойство компонента — Font типа TFont (см. разделы 4.1.5 и 16.4), в 
котором вы можете задать при желании начальные установки атрибутов шрифта и 
в котором вы можете прочесть значения атрибутов, выбранные пользователем в 
процессе диалога. 

Свойства MaxFontSize и MinFontSize устанавливают ограничения на макси- 
мальный и минимальный размеры шрифта. Если значения этих свойств равны 0 
(по умолчанию), то никакие ограничения на размер не накладываются. Если же 
значения свойств заданы (обычно это целесообразно делать исходя из размеров 
компонента приложения, для которого выбирается шрифт), то в списке Размер 
диалогового окна (см. рис. 3.54) появляются только размеры, укладывающиеся в 
заданный диапазон. При попытке пользователя задать недопустимый размер ему 
будет выдано предупреждение вида «Размер должен лежать в интервале ...» и вы- 
бор пользователя отменится. Свойства MaxFontSize и MinFontSize действуют 
только при включенной опции fdLimitSize (см. ниже). 

Свойство Device определяет, из какого списка возможных шрифтов будет 
предложен выбор в диалоговом окне: fdScreen — из списка экрана (по умолча- 
нию), fdPrinter — из списка принтера, fdBoth — из обоих. 

Свойство Options содержит множество опций: 


SESE И ЗЕ О ие УИ И АВ ЕР 


fdAnsiOnly Отображать только множество шрифтов символов Windows, 
не отображать шрифтов со специальными символами 


fdApplyButton Отображать в диалоге кнопку Применить независимо от 
того, предусмотрен ли обработчик события OnApply 


fdEffects Отображать в диалоге индикаторы специальных эффектов 
(подчеркивание и др.) и список Цвет 


fdFixedPitchOnly Отображать только шрифты с постоянной шириной символов 


fdForceFontExist Позволять пользователю выбирать шрифты только из спис- 
ка, запрещать ему вводить другие имена 


fdLimitSize Разрешить использовать свойства MaxFontSize и MinFont- 
Size, ограничивающие размеры шрифта 


fdNoFaceSel Открывать диалоговое окно без предварительно установлен- 
ного имени шрифта 


fdNoOEMFonts Удалять из списка шрифтов шрифты OEM 


fdScalableOnly Отображать только масштабируемые шрифты, удалять из 
списка не масштабируемые (шрифты bitmap) 


fdNoSimulations Отображать только шрифты и их начертания, напрямую 
поддерживаемые файлами, не отображая шрифты, в кото- 
рых жирный стиль и курсив синтезируется 


fdNoSizeSel Открывать диалоговое окно без предварительно установлен- 
ного размера шрифта 


fdNoStyleSel Открывать диалоговое окно без предварительно установлен- 
ного начертания шрифта 


fdNoVectorFonts Удалять из списка векторные шрифты (типа Roman или 
Script для Windows 1.0) 


fdShowHelp Отображать в диалоговом окне кнопку Справка 
fdTrueTypeOnly — Предлагать в списке только шрифты TrueType 


fdWysiwyg Предлагать в списке только шрифты, доступные и для экрана, 
и для принтера, удаляя из него аппаратно зависимые шрифты 


\ 
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По умолчанию все эти опции, кроме fdEffects, отключены. 

Если установить опцию fdApplyButton, то при нажатии пользователем кноп- 
ки Применить возникает еле OnApply, в обработчике которого вы можете на- 
писать код, который применит выбранные пользователем атрибуты, не закрывая 
диалогового окна. 

Приведем примеры применения компонента FontDialog. Пусть ваше прило- 
жение включает окно редактирования Мето1, шрифт в котором пользователь мо- 
жет выбирать командой меню Шрифт. Вы ввели в приложение компонент 
FontDialog, имя которого по умолчанию FontDialog1. Тогда обработчик команды 
Шрифт может иметь вид: 

if (FontDialogl->Execute() ) 

Memol->Font->Assign (FontDialogli->Font) ; 

Приведенный оператор вызывает диалог выбора атрибутов шрифта и, если 
пользователь произвел выбор, то значения всех выбранных атрибутов, содержа- 
щиеся в свойстве FontDialogl->Font, присваиваются атрибутам окна редактиро- 
вания, содержащимся в свойстве Memol.Font. Шрифт в окне редактирования не- 
медленно изменится. 

Если вы установите в компоненте FontDialog1 опцию fdApplyButton, то mo- 
жете написать обработчик события OnApply: 


Memol->Font->Assign (FontDialogli->Font) ; 


Тогда пользователь может наблюдать изменения в окне Memol, нажимая в 
диалоговом окне кнопку Применить и не прерывая диалога. Это очень удобно, так 
как позволяет пользователю правильно подобрать атрибуты шрифта. 

Если в качестве окна редактирования в вашем приложении вы используете 
RichEdit, то можете предоставить пользователю выбирать атрибуты шрифта для 
выделенного фрагмента текста или для вновь вводимого текста. Тогда выполнение 
команды меню Шрифт может осуществляться операторами: 


if (FontDialogl->Execute ()) 
RichEdit1l->SelAttributes->Assign(FontDialogl->Font) ; 


Вы можете разрешить пользователю изменять шрифт не только отдельных 
компонентов, но и всех компонентов и надписей на форме. Это осуществляется 
оператором: 


if (FontDialogl->Execute() ) 
Font->Assign (FontDialogl->Font) ; 


В этом операторе свойство Font без ссылки на компонент подразумевает 
шрифт формы. 


3.8.5 Диалог выбора цвета — компонент ColorDialog 


Компонент ColorDialog вызывает диалоговое окно выбора цвета, представлен- 
ное на рис. 3.55. В нем пользователь может выбрать цвет из базовой палитры или, 
нажав кнопку Определить цвет, раскрыть дополнительную панель (на рис. 3.55 
она раскрыта), позволяющую синтезировать цвет, отличный от базовых. Синтези- 
рованный цвет можно добавить кнопкой Добовить в набор в палитру дополнительных 
цветов на левой панели и использовать его в дальнейшем. 

Основное свойство компонента ColorDialog — Color. Это свойство соответству- 
ет тому цвету, который выбрал в диалоге пользователь. Если при вызове диалога 
желательно установить некоторое начальное приближение цвета, это можно сде- 
лать, установив Со]ог предварительно во время проектирования или программно. 

Свойство CustomColors типа TStrings позволяет задать заказные цвета допол- 
нительной палитры. Каждый цвет определяется строкой вида 


<Имя цвета>=<шестнадцатеричное представление цвета>; 
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Рис. 3.55 
Диалоговое окно выбора цвета 


Имена цветов задаются от Со]огА (первый цвет) до Со]огР (шестнадцатый, по- 
следний). Например, строка 


ColorA=808022 


задает первый заказной цвет. Подробнее о задании цветов CM. в справочной части 
книги в главе 16. | 
Свойство Options содержит множество следующих опций: 


ИСКИ д: ИИ ЯК, 


SESE 


cdFullOpen Отображать сразу при открытии диалогового окна панели 
определения заказных цветов 


cdPreventFullOpen Запретить появление в диалоговом окне кнопки Определить 
цвет, так что пользователь не сможет определять новые цвета 


cdShowHelp Добавить в диалоговое окно кнопку Справка 


cdSolidColor Указать Windows использовать сплошной цвет, ближай- 
ший к выбранному (это обедняет палитру) 


cdAnyColor Разрешать пользователю выбирать любые не сплошные 
цвета (такие цвета могут быть не ровными) 


По умолчанию все опции выключены. 

Приведем пример применения компонента ColorDialog. Если вы хотите, что- 
бы пользователь мог задать цвет какого-то объекта, например, цвет фона компо- 
нента Memol, то это можно реализовать оператором 


if (ColorDialogl->Execute() ) 
Memol->Color = ColorDialogl->Color; 


3.8.6 Диалоги печати и установки принтера — 
компоненты PrintDialog и PrinterSetupDialog 


Компонент PrintDialog вызывает диалоговое окно печати, представленное на 
рис. 3.56. В нем пользователь может выбрать принтер и установить его свойства, 
указать число копий и последовательность их печати, печатать в файл или непо- 
средственно на принтер, выбрать печатаемые страницы или печатать только выде- 
ленный фрагмент. 
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Рис. 3.56 
Диалоговое окно настройки 
печати 


Компонент PrintDialog не осуществляет печать. Он только позволяет пользо- 
вателю задать атрибуты печати. А сама печать должна осуществляться программ- 
но с помощью объекта Printer или иным путем (о способах печати см. раздел 4.6). 

Рассмотренные ранее диалоговые компоненты возвращали одно свойство — 
имя файла, цвет, или один объект — Font, содержащий множество свойств. В от- 
личие от них компонент PrintDialog возвращает ряд свойств, характеризующих 
выбранные пользователем установки. Это следующие свойства: 


ПРА АНИ IAEA PIELER EES IISEBERLASII REED AES LIRR TT I NE BE ИИА IGLESIAS 


PrintRange Показывает выбранную пользователем радиокнопку 1 из 3 группы 
Печатать: prAllPages — выбрана кнопка Все страницы, prSelection 
— выбрана кнопка Страницы с ... по ..., prPageNums — выбрана 
кнопка Страницы 


FromPage Показывает установленную пользователем начальную страницу в 
окне Страницы с... по ... 


ToPage Показывает установленную пользователем конечную страницу в 
окне Страницы с ... по ... 


PrintToFile Показывает, выбран ли пользователем индикатор Печать в файл 
Copies Показывает установленное пользователем число копий 


Collate Показывает, выбран ли пользователем индикатор Разобрать 


Перед вызовом диалога желательно определить, сколько страниц в печатае- 
MOM тексте, и задать параметры MaxPage и MinPage — максимальный и мини- 
мальный номера страниц. В противном случае пользователю в диалоговом окне не 
будет доступна кнопка Страницы с... по .... Кроме того следует определить множест- 
во опций в свойстве Options: 


О О а вы 


poDisablePrintToFile Запретить доступ к индикатору Печать в файл. Эта ‹ опция 
работает только при включенной опции poPrintToFile 


poHelp Отображать в диалоговом окне кнопку Cnpaska. Опция 
может не работать для некоторых версий Windows 95/98 


poPageNums Сделать доступной радиокнопку Страницы, позволяющую 
пользователю задавать диапазон печатаемых страниц 
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poPrintToFile | Отображать в диалоговом окне кнопку Печать в файл 


poSelection Сделать доступной кнопку Выделение, позволяющую по- 
льзователю печатать только выделенный текст 


poWarning Выдавать замечания, если пользователь пытается по- 
слать задачу на неустановленный принтер 


Теперь остановимся на компоненте PrinterSetupDialog, вызывающем диалоговое 
окно установки принтера. Это единственный диалоговый компонент, не имеющий ни- 
каких специфических свойств, которые надо было бы устанавливать или читать. Диа- 
лог выполняет операции по установке принтера, на котором будет производиться пе- 
чать, и задании его свойств. Этот диалог не возвращает никаких параметров. 


3.8.7 Диалоги поиска и замены текста — компоненты 
FindDialog и ReplaceDialog 


Компоненты FindDialog и ReplaceDialog, вызывающие диалоги поиска и за- 
мены фрагментов текста (рис. 3.57 и 3.58), очень похожи и имеют одинаковые 
свойства, кроме одного, задающего заменяющий текст в компоненте ReplaceDia- . 
log. Такое сходство не удивительно, поскольку ReplaceDialog — производный 
класс oT FindDialog. 


Puc. 3.57 atch . 
Диалоговое окно поиска фрагмента текста Dosen Een ssnsmae ese] 
; Направление | : | a 
oc Beeps | я * вне я 
Рис. 3.58 


Диалоговое окно замены фрагмента текста ритм 
Найти далее | 
” Заменит re на: [Riche di2 


yee pa ie 8 eee. sa po > и ие Boe | 
олько ЕЕ о a ee 


Компоненты имеют следующие основные свойства: 


Sig Re ata, 


FindText Текст, заданный пользователем ЛЯ 1 поиска или замены. 1. Про. 
граммно может быть установлен как начальное значение, предла- 
гаемое пользователю 


И: У: BOO ое, 


ReplaceText Только в компоненте ReplaceDialog — текст, который должен за- 
менять FindText 


Position Позиция левого верхнего угла диалогового окна, заданная типом 
TPoint — записью, содержащей поля Х (экранная координата по 
горизонтали) и У (экранная координата по вертикали) 


Гей Координата левого края диалогового окна, то же, что Position. X 
Тор Координата верхнего края диалогового окна, то же, что Position. Y 
Options Множество опций 
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Последний параметр Options — может содержать следующие свойства: 


frDisableMatchCase Делает недоступным индикатор С учетом регистра в диа- 
логовом окне 


PERL, oa LEELA ERLE ELE GEILE PEELE LEIS LEELA SLRS ОСЯМ BELLE BEEBE SERRE ее VARESE DE 


frDisableUpDown Делает недоступными в диалоговом окне кнопки Вверх и 
Вниз группы Направление, определяющие направление 
поиска 


frDisableWholeWord Делает недоступным индикатор Только слово целиком в 
диалоговом окне 


frDown Выбирает кнопку Вниз группы Направление при откры- 
| тии диалогового окна. Если эта опция не установлена, то 
выбирается кнопка Вверх 


frFindNext Эта опция включается автоматически, когда пользова- 
тель в диалоговом окне щелкает на кнопке Найти далее, 
и выключается при закрытии диалога 


frHideMatchCase Удаляет индикатор С учетом регистра из диалогового 
окна 

frHideWhole Word Удаляет индикатор Только слово целиком из диалогового 
окна 

frHideUpDown _ Удаляет кнопки Вверх и Вниз из диалогового окна 

frMatchCase Этот флаг включается и выключается, если пользователь 


включает и выключает опцию С учетом регистра в диало- 
говом окне. Можно установить эту опцию по умолчанию 
во время проектирования, чтобы при открытии диалога 
она была включена 


frReplace Применяется только для ReplaceDialog. Этот флаг уста- 
навливается системой, чтобы показать, что текущее (и 
только текущее) найденное значение FindText должно 
быть заменено значением ReplaceText 


frReplaceAll Применяется только для ReplaceDialog. Этот флаг уста- 
навливается системой, чтобы показать, что все найден- 
ные значения FindText должны быть заменены значени- 
ями ReplaceText 


frShowHelp Задает отображение кнопки Справка в диалоговом окне 


frWholeWord Этот флаг включается и выключается, если пользователь 
включает и выключает опцию Только слово целиком в диа- 
логовом окне. Можно установить эту опцию по умолча- 
нию во время проектирования, чтобы при открытии диа- 
лога она была включена 


Сами по себе компоненты FindDialog и ReplaceDialog не осуществляют ни по- 
иска, ни замены. Они только обеспечивают интерфейс с пользователем. А поиск и 
замену надо осуществлять программно. Для этого можно пользоваться событием 
OnFind, происходящим, когда пользователь нажал в диалоге кнопку Найти далее, 
и событием OnReplace, возникающим, если пользователь нажал кнопку Заменить 
или Заменить все. В событии OnReplace узнать, какую именно кнопку нажал поль- 
зователь, можно по значениям флагов frReplace и frReplaceAll. 

Поиск заданного фрагмента в компоненте Вас В ЕЦ легко проводить, исполь- 
зуя его метод FindText, объявленный следующим образом: 
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int _fastcall FindText(const System::AnsiString SearchStr, 
int StartPos, int Length, 
TSearchTypes Options); 


Этот метод ищет в тексте RichEdit фрагмент, заданный параметром 
SearchStr. Поиск идет начиная с позиции StartPos (позиция первого символа тек- 
ста считается нулевой) на протяжении Length символов. Параметр Options явля- 
ется множеством, которое может содержать элементы StWhole Word (поиск только 
целого слова) и stMatchCase (поиск с учетом регистра). Метод возвращает позицию 
найденного вхождения. Если заданный фрагмент не найден, возвращается -1. 

Ниже приведен код, осуществляющий поиск заданного фрагмента в тексте 
компонента RichEdit1. 


void _fastcall TForml::MFindClick(TObject *Sender) 

{ 

/* начальное значение текста поиска — текст, выделенный в Memol */ 
FindDialogl->FindText = Memol->SelText; 
FindDialogl->Execute () ; 

} 

// 


void _fastcall TForml::FindDialoglFind(TObject *Sender) 


{ 
int FoundAt, StartPos, ТоЕпа; 


/* если было выделение, то поиск идет начиная с его 
последнего символа, иначе — с позиции курсора */ 
StartPos = Memol->SelStart; 
if (Memol->SelLength) 
StartPos += Memol->SelLength; 


/* ТоЕпа - длина текста, начиная с первой позиции поиска 
и до конца */ 
ToEnd = Memol->Text.Length() — StartPos; 


/* поиск с учетом или без учета регистра в зависимости от 

установки пользователя */ 
if (FindDialogl->Options.Contains (frMatchCase) ) 

FoundAt = StartPos + 

Memol->Text.SubString(StartPos+l, 

ToEnd) .Pos (FindDialogl->FindText) ; 

else 

FoundAt = StartPos + 

Memol->Text.SubString(StartPostl, 

ToEnd) .LowerCase() .Pos (FindDialogl->FindText.LowerCase() ); 


if (FoundAt != StartPos) // если найдено 
{ 
Memol->SetFocus(); 
Memol->SelStart = FoundAt-l1; 
Memol->SelLength = FindDialogl->FindText.Length (); 
} 
else ShowMessage("Texcr '" + FindDialogl->FindText + 
"' не найден"); 


} 


Функция MFindClick задает в качестве начального значения для поиска 
текст, выделенный в RichEditl, и затем вызывает диалог поиска FindDialog1. 
Функция FindDialog1Find является обработчиком события OnFind компонента 
FindDialog1. Она срабатывает, когда пользователь нажал в диалоге кнопку Найти 
далее. Комментарии в тексте этой функции поясняют этапы поиска. Сначала про- 
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изводится установка области текста (переменные StartPos и ToEnd), в которой 
проводится поиск. Затем устанавливаются атрибуты поиска — формируется мно- 
жество Option в зависимости от установленных пользователем опций. Затем мето- 
дом FindText проводится сам поиск. Если нового вхождения искомого текста не 
найдено (метод FindText вернул -1), то пользователю выдается сообщение об этом с 
помощью функции ShowMessage. 

Приведенный пример относился к поиску в компоненте RichEdit. Для органи- 
зации поиска в тексте компонента Memo удобно использовать метод Pos класса 
AnsiString (см. главу 16 раздел 16.4), который объявлен следующим образом: 


int _ Еазеса11 Pos(const AnsiString& subStr) const; 


Метод возвращает индекс первого символа первого вхождения подстроки 
subStr в строку, к которой применяется этот метод. Индексы начинаются C1. Если 
subStr не содержится в строке, то возвращается 0. 

_ Для организации поиска потребуются еще две функции класса AnsiString: 
SubString и LowerCase. Первая из них определена как: 


AnsiString  fastcall SubString(int index, int count) const; 


Она возвращает подстроку, начинающуюся с символа в позиции index и содер- . 
жащую count символов. 
Функция LowerCase, определенная как 


AnsiString _fastcall LowerCase() const; 


возвращает строку символов $, переведенную в нижний регистр. 

Теперь мы можем рассмотреть пример организации поиска. Пусть в вашем 
приложении имеется компонент Memol и при выборе раздела меню MFind вы xo- 
тите организовать поиск в тексте, содержащемся в Мето1. Для упрощения задачи 
исключим опцию поиска только целых слов и опцию поиска вверх от положения 


курсора. 
Программа, реализующая поиск, может иметь следующий вид: 


void _fastcall TForml::MFindClick(TObject *Sender) 

{ 

/* начальное значение текста поиска — текст, выделенный в Мето1 */ 
FindDialogl->FindText = Memol->SelText; 
FindDialogl->Execute () ; 

} 

// 


void _ fastcall TForml::FindDialoglFind(TObject *Sender) 
{ 
int FoundAt, StartPos, ToEnd; 


/* если было выделение, то поиск идет начиная с его 
последнего симьФла, иначе - с позиции курсора */ 
StartPos = Memol->SelStart; 
if (Memol->SelLength) 
StartPos += Memol->SelLength; 


/* ToEnd — длина текста, начиная с первой позиции поиска 
и до конца */ 
ToEnd = Memol->Text.Length() — StartPos; 


/* поиск с учетом или без учета регистра в зависимости от 
установки пользователя */ 
if (FindDialogl->Options.Contains (frMatchCase) ) 
FoundAt = StartPos + 
Memol->Text.SubString(StartPos+l, 
ToEnd) .Pos (FindDialogl->FindText) ; 
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else 
FoundAt = StartPos + 
Memol->Text.SubString(StartPos+l, 
ToEnd) .LowerCase() .Ро$ (FindDialogl->FindText.LowerCase()); 


if (FoundAt != StartPos) // если найдено 


{ 
Memol->SetFocus(); 
Memol->SelStart = FoundAt-l1; 
Memol->SelLength = FindDialogl->FindText.Length (); 


} 
else ShowMessage("Texctr '" + FindDialogl->FindText + 
"' не найден"); 


} 


Программа аналогична `приведенной ранее для компонента RichEdit и отлича- 
ется только несколькими операторами, осуществляющими непосредственно поиск. 


При реализации команды Заменить приведенные выше процедуры можно оста- 
вить теми же самыми, заменив в них FindDialogl на ReplaceDialogl. Дополни- 
тельно можно написать процедуру обработки события OnReplace компонента 
ReplaceDialog1. Кроме того желательно обеспечить, чтобы при нажатии пользова- 
телем в диалоге клавиши Заменить все программа просматривала бы весь текст и 
проводила все замены без дополнительных вопросов пользователю. Для этого мож- 
но в конце обработчика события OnFind вставить оператор, который в случае, если 
пользователь нажал в диалоге клавишу Заменить все (см. рис. 3.58), вызывал бы об- 
работчик события OnReplace. В итоге текст, обеспечивающий замену в компонен- 
те RichEdit, может иметь вид: 


void _fastcall TForml::ReplaceDialoglFind(TObject *Sender) 
{ 


// Если нажата кнопка "Заменить все", то уход на замену 
if (ReplaceDialogl->Options.Contains (frReplaceAl}l) ) 
ReplaceDialoglReplace (Sender) ; 

} 

// 


void _fastcall TForml::ReplaceDialoglReplace (TObject *Sender) 
{ 
if (RichEditl->SelText != "") // Если есть выделенный текст 
{ 
// Замена выделенного текста 
RichEdit1->SelText = ReplaceDialogl->ReplaceText; 
// Если нажата кнопка "Заменить все", то изменение позиции 
if (ReplaceDialogl->Options.Contains (ЁгВер]1асеА11)) 
RichEditl->SelStart += ReplaceDialogl->ReplaceText. Length () ; 
} 
else if (ReplaceDialogl->Options.Contains (frReplace) ) 
{ 
ShowMessage("Texcr '" + ReplaceDialogl->FindText + 
"' не найден"); 
return; 
} 
// Если нажата кнопка "Заменить все", TO уход на поиск 
if (ReplaceDialogl->Options.Contains (frReplaceAll) ) 
ReplaceDialoglFind (Sender) ; 
} 


В функции ReplaceDialog1Find в конце поиска очередного вхождения иско- 
мого фрагмента в текст проверяется нажатие пользователем кнопки Заменить все. 
Если она нажата, то происходит обращение к функции ReplaceDialog1Replace, в 
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которой осуществляется замена текста, после чего сразу автоматически опять вы- 
зывается функция ReplaceDialog1Find. Таким образом без остановок просматри-: 
ваются и заменяются все вхождения искомого фрагмента в текст. Если же кнопка 
Заменить все не нажата, то программа останавливается и ждет, пока пользователь 
нажмет в диалоге (см. рис. 3.58) кнопку Найти далее или Заменить. Если нажимает- 
ся кнопка Найти далее, то производится следующий вызов ReplaceDialog1Find. А 
при нажатии кнопки Заменить вызывается функция ReplaceDialog1Replace, кото- 
рая заменяет выделенный текст. 

Приведенные коды рассчитаны на компонент RichEdit. Для компонента 
Memo в них просто надо заменить RichEditl на Memol. 


3.9 Компоненты организации управления 
приложением 


3.9.1 Диспетчеризация событий — компоненты, связанные 
с ActionList 


Начиная с C++Builder 4 появился инструментарий, который, не добавляя ни- 
каких принципиально новых возможностей, позволяет систематизировать и упо- 
рядочить разработку объектно-ориентированных приложений. К тому же грамот- 
ное его использование позволяет сэкономить немало времени при проектировании. 

В начале проектирования приложения разработчик должен представить себе 
список тех действий, которые может осуществлять пользователь. Конечно, в про- 
цессе проектирования этот список будет пополняться и изменяться, но некоторое 
начальное приближение очень полезно продумать заранее. Практическая реализа- 
ция составленного вами списка действий может начинаться с переноса на проекти- 
руемую форму невизуального компонента ActionList, расположенного на странице 
библиотеки Standard. Сделав на этом компоненте двойной щелчок, вы попадаете в 
редактор действий (рис. 3.59), позволяющий вводить и упорядочивать действия. 


Рис. 3.59 "Editing FMain->ActionList) 
Окно редактора действий а. 


АСазсаде 
AT ileHoniz... 
ATileVertic... 


Щелчок правой кнопкой мыши или щелчок Ha маленькой кнопочке со стрел- 
кой вниз правее первой быстрой кнопки окна редактирования позволит вам вы- 
брать одну из команд: New Action (новое действие) или New Standard Action (новое 
стандартное действие). Первая из них относится к вводу нового действия любого 
типа. По умолчанию эти действия будут получать имена Actionl, Action2 и т.д. 
Вторая команда открывает окно, в котором вы можете выбрать необходимое вам 
стандартное действие (или сразу несколько действий). После этого в правом окне 
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(Actions) редактора появятся имена выбранных действий, а в левом (Categories) — 
категории действий. 

Каждое действие, которое вы внесли в список — это объект типа TAction для 
нестандартных действий или других производных типов для стандартных. Выбрав 
в окнах редактора ту или иную категорию или [AllActions] (все категории), а в пра- 
вом — конкретное действие, вы можете увидеть в Инспекторе Объектов его свойст- 
ва и события. Вы можете установить свойство Маше (имя) — оно появится в пра- 
вом окне редактора свойств и будет в дальнейшем фигурировать в заголовках обра- 
ботчиков событий. Во избежание путаницы, которая иногда может возникнуть в 
коде программы, избегайте имен действий, совпадающих с именами каких-то 
функций, переменных или констант. Удачным, как мне кажется, выходом являет- 
ся добавление к имени каждого действия символа «А», как вы можете видеть это 
на рис. 3.59. 

Вы можете для каждого действия установить надпись (Caption), которая далее 
будет появляться в инициаторах действия — кнопках, разделах меню ит.д. Може- 
те задать быстрые клавиши (ShortCut), надписи на ярлычках подсказок и в строке 
состояний (Hint), идентификатор темы контекстной справки (HelpContext), свой- 
ства Enabled (доступность), Visible (видимость) и другие обычные для многих ком- 
понентов свойства. 

Можно для каждого или некоторых действий указать свойство Imagelndex, 
которое является индексом (начиная с 0) изображения, соответствующего данному 
действию в отдельном компоненте списка изображений ImageList (см. раз- 
дел 3.9.2). Этот индекс передастся в дальнейшем компонентам, связанным с дан- 
ным событием — разделам меню, кнопкам. Если в свойстве Images компонента 
ActionList указать имя списка, размещенного на форме и заполненного изображе- 
ниями, то эти изображения появятся также в окне редактора действий (рис. 3.59). 

Свойство Category (категория) не имеет отношения к выполнению приложе- 
ния. Задание категории просто позволяет в процессе проектирования сгруппиро- 
вать действия по их назначению. Вы можете для каждого действия выбрать кате- 
горию из выпадающего списка, или написать имя новой категории и отнести к ней 
какие-то действия. Например, на рис. 3.59 видна введенная пользователем катего- 
рия Файлы, к которой отнесены действия, связанные с меню Файл. 

На странице событий Инспектора Объектов для каждого действия определено 
три события: OnExecute, OnUpdate и OnHint. 

Событие ОпЕхесще возникает в момент, когда пользователь инициализировал 
действие, например, щелкнув на компоненте (разделе меню, кнопке), связанном с 
данным действием. Обработчик этого события должен содержать процедуру, реа- 
лизующую данное действие. Например, обработчик события OnExecute действия 
Exit может в простейшем случае иметь вид 


void _fastcall TFMain::AExitExecute(TObject *Sender) 


( 


-С10зе: 
} 


а в более сложных случаях может содержать проверку возможности закрыть при- 
ложение, запросы пользователю и т.д. Одним из преимуществ использования дей- 
ствий является то, что заголовки обработчиков приобретают осмысленный харак- 
тер и код становится более прозрачным. Действительно, гораздо понятнее заголо- 
вок ExitExecute, чем, например, Button7Click или N14Click (попробуйте найти в 
вашем большом приложении, где эта кнопка Button7 или раздел меню N14). В ре- 
зультате вы избавляетесь от необходимости давать осмысленные имена кнопкам и 
разделам меню, т.е. облегчаете свою работу с компонентами. 

Событие OnUpdate периодически возникает в промежутках между действия- 
ми. Возникновение этих событий прекращается только во время реализации собы- 
тия или во время, когда пользователь ничего не делает и компьютер находится в 
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состоянии ожидания действий. Обработчик события OnUpdate может содержать 
какие-то настройки, подготовку ожидаемых дальнейших действий или выполне- 
ние каких-то фоновых операций. 

Событие OnHint возникает в момент, когда на экране отображается ярлычок 
подсказки в результате того, что пользователь задержал курсор мыши над компо- 
нентом, инициализирующим событие. 

Наличие в объекте действия событий OnUpdate и OnHint обогащает ваши воз- 
можности по проектированию приложения. Без этого объекта подобные события 
отсутствуют и их при необходимости приходится моделировать более сложными 
приемами. 

Связь объектов действий с конкретными инициализаторами действий — 
управляющими элементами типа кнопок, разделов меню и т.д., осуществляется 
через свойство Action, имеющееся у всех управляющих элементов. Поместите на 
вашу форму кнопку, и вы увидите в Инспекторе Объектов это свойство. Раскройте 
его выпадающий список и выберите из него действие, которое вами было предва- 
рительно описано. Вы сможете заметить, что после этого в кнопку перенесутся та- 
кие свойства объекта действия, как Caption, Hint и др.., и что в ee событие OnClick 
подставится обработчик, предусмотренный вами для данного действия. Если далее 
вы введете в приложение меню с разделом, соответствующим тому же действию, и 
укажете в нем то же значение свойства Action, то свойства и обработчики событий 
объекта действия будут перенесены и на этот раздел меню. Вам не придется по- 
вторно задавать значение Hint, Caption и др. 

Подобная связь между свойствами объекта действия и свойствами управляю- 
щих элементов выполняется классом TActionLink и его наследниками. Передают- 
ся в компоненты такие свойства действия, как Caption, Checked, Enabled, 
HelpContext, Hint, ImageIndex, ShortCut, Visible. Впрочем, в любом компоненте 
разработчик может изменить переданное в него свойство. Обратной связи 
TActionLink с компонентами нет, так что эти изменения будут локальными и не 
отразятся на других компонентах. Если же требуется изменить свойства всех свя- 
занных с одним действием компонентов, надо изменять свойство объекта дейст- 
вия. Это облегчает программное управление компонентами, связанными с одним и 
тем же действием. Например, если в какой-то момент вам надо сделать недоступ- 
ными (или, наоборот, доступными) два компонента — кнопку Button3 и раз- 
дел меню №5, связанные с одним событием (назовем его объект Do), то при отсутст- 
вии централизованной диспетчеризации событий через ActionList вам пришлось 
бы писать два оператора: 


Button3->Enabled = false; 
N5->Enabled = false; 


а при наличии объекта Do — всего один: 
Do->Enabled = false; 


Дело не только в экономии кода, но и вего прозрачности, понятности его как 
для вас самих, так и для тех, кому придется, может быть, В дальнейшем сопровож- 
дать ваше приложение. 


3.9.2 Список изображений — компонент ImageList 


Компонент ImageList представляет собой набор изображений одинаковых раз- 
меров, на которые можно ссылаться по индексам, начинающимся с 0. Во многих 
рассмотренных ранее компонентах (меню, списках и др.) встречались свойства, 
представляющие собой ссылки на компонент ImageList. Этот компонент позволяет 
организовать эффективное и экономное управления множеством пиктограмм и би- 
товых матриц. Он может включать в себя монохромные битовые матрицы, содер- 
жащие маски для отображения прозрачности рисуемых изображений. 
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Изображения в компонент TImageList могут быть загружены в процессе про- 
ектирования с помощью редактора списков изображений. Окно редактора, пред- 
ставленное на рис. 3.60, вызывается двойным щелчком на компоненте TImageList 
или щелчком правой кнопки мыши и выбором команды контекстного меню 
ImageList Editor. 


Puc. 3.60 
Окно редактора списков изображений 


В окне редактора списков изображений вы можете добавить в списки изобра- 
жения, пользуясь кнопкой Add, удалить изображение из списка кнопкой Delete, 
очистить весь список кнопкой Clear. При добавлении изображения в список откры- 
вается обычное окно открытия файлов изображений, в котором вы можете выбрать 
интересующий вас файл. Только учтите, что размер всех изображений в списке 
должен быть одинаковым. Как правило, это размер, используемый для пикто- 
грамм в меню, списках, кнопках. При добавлении в список изображений для кно- 
пок надо иметь в виду, что они часто содержат не одно, а два и более изображений 
(см. раздел 3.5.1). В этих случаях при попытке добавить изображение задается во- 
mpoc: «Bitmap dimensions Юг... are greater then imagelist dimensions. Separate into ... separate 
bitmaps?» (Размерность изображения ... больше размерности списка. Разделить на 
... отдельных битовых матрицы?). Если вы ответите отрицательно, то все изобра- 
жения уменьшатся в горизонтальном размере и лягут как одно изображение. Ис- 
пользовать его в дальнейшем будет невозможно. Поэтому на заданный вопрос надо 
отвечать положительно. Тогда загружаемая битовая матрица автоматически раз- 
делится на отдельные изображения и потом вы можете удалить те из них, которые 
вам не нужны, кнопкой Delete. 

Как видно из рис. 3.60, каждое загруженное в список изображение получает 
индекс. Именно на эти индексы впоследствии вы можете ссылаться в соответст- 
вующих свойствах разделов меню, списков, кнопок и т.д., когда вам надо загру- 
зить в них то или иное изображение. Изменить последовательность изображений в 
списке вы можете просто перетащив изображение мышью на новое место. 

В редакторе списков изображений вы можете, выделив то или иное изображе- 
ние, установить его свойства: Transparent Color и Fill Color. Ho это можно делать толь- 
ко в том сеансе работы с редактором списков изображений, в котором загружено 
данное изображение. Для изображений, загруженных в предыдущих сеансах, из- 
менение этих свойств невозможно. 

Свойство Transparent Color определяет цвет, который используется в маске для 
прозрачного рисования изображения. По умолчанию это цвет левого нижнего пик- 
селя изображения. Для пиктограмм данное свойство устанавливается в © Мопе, по- 
скольку пиктограммы уже маскированы. 

Свойство Fill Color определяет цвет, используемый для заполнения пустого про- 
странства при перемещении и центрировании изображения. Для пиктограмм дан- 
ное свойство устанавливается в ClNone. 
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Группа радиокнопок Options определяет способ. размещения изображения би- 
товой матрицы с размерами, не соответствующими размерам, принятым в списке: 


\ 
ЗЕРЕН ER ERE AI EOS LE EU ICE TE ERE ETE OT SEES ECE RI TERI IEREES CSUR AAO BREESE IO TIDE LD ВИСЕЛИ РВ НОО Lt EEE NE AMEE: 


Crop Отображается часть изображения, помещающаяся в размер списка, 
начиная с левого верхнего угла 


Stretch Размеры изображения изменяются, становясь равными размерам 
списка. При этом возможны искажения 


Center Изображение центрируется, a если его размер больше размера спис- 
ка, то не помещающиеся области отсекаются 


Теперь рассмотрим основные свойства TImageList: 
| Свойство 
| Height Integer Высота изображений в списке 
| Width Integer Ширина изображений в списке 


| AllocBy Integer Определяет количество изображений, на которое увели- 
РИ: чивается список для добавления новых изображений 


Count Integer Определяет число изображений в списке. Свойство толь- 
| ко для чтения 


= 


Остальные свойства определяют цвета и способы рисования изображения. 


3.9.3 Приложение — компонент ApplicationEvents 
и объект Application 


В каждом приложении автоматически создается объект Application типа 
TApplication — приложение. Этот компонент отсутствует в палитре библиотеки, 
вероятно, только потому, что он всегда один в приложении. Application имеет ряд 
свойств, методов, событий, характеризующих приложение в целом. 

Рассмотрим сначала некоторые свойства Application. Булево свойство Active 
(только для чтения) характеризует активность приложения. Оно равно true, если 
форма приложения находится в фокусе. Если же пользователь переключился на 
работу с другим приложением, свойство Active равно false. 

Свойство ЕхеМаше является строкой, содержащей имя выполняемого файла с 
полным путем к нему. Это свойство удобно использовать, чтобы определить ката- 
лог, из которого запущено приложение и который может содержать другие файлы 
(настройки, документы, базы данных ит.п.), связанные с приложением. Выраже- 
ние ExtractFilePath(Application->ExeName) дает этот каталог. Обычно свойство 
ExeName тождественно функции ParamStr(0), возвращающей нулевой параметр 
командной строки — имя файла с путем. 

Свойство Title определяет строку, которая появляется около пиктограммы 
свернутого приложения. Если это свойство не изменяется во время выполнения, то 
оно равно опции Title, задаваемой во время проектирования на странице Application 
окна опций проекта (команда Project | Options). Свойство может изменяться про- 
граммно, например, изменяя надпись в зависимости от режима работы приложе- 
ния. 
Свойство МашЕогт типа ТЕогш определяет главную форму приложения. Бу- 
лево свойство ShowMainForm определяет, должна ли главная форма быть види- 
мой в момент запуска приложения на выполнение. По умолчанию оно равно true, 
что обеспечивает видимость главной формы в момент начала работы приложения. 


ne 
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Если же установить в головном файле проекта Application->ShowMainForm рав- 
ным false до вызова метода Application->Run() и если при этом свойство Visible 
главной формы тоже равно false, то главная форма в первый момент будет невиди- 
мой. 

Свойство HelpFile указывает файл справки, который используется в приложе- 
нии в данный момент как файл по умолчанию. Если это свойство не изменяется во 
время выполнения, то оно равно опции Help File, задаваемой во время проектиро- 
вания на странице Application окна опций проекта (команда Project | Options). Свойст- 
во можно изменять программно, назначая в зависимости от режима работы прило- 
жения тот или иной файл справки. 

Ряд свойств объекта Application определяет ярлычки подсказок компонентов 
приложения, Свойство Hint содержит текст подсказки Hint того визуального ком- 
понента или раздела меню, над которым в данный момент перемещается курсор 
мыши. Смена этого свойства происходит в момент события OnHint, которое будет 
рассмотрено позднее. Во время этого события текст подсказки переносится из 
свойства Hint компонента, на который переместился курсор мыши, в свойство 
Hint объекта Application. Свойство Application->Hint можно использовать для 
отображения этой подсказки или для установки и отображения в полосе состояния 
текста, характеризующего текущий режим приложения. 

Свойство HintColor типа TColor определяет цвет фона окна ярлычка. По умол- 
чанию это цвет clInfoBk, но его значение можно изменять программно. Свойство 
HintPause определяет задержку появления ярлычка в миллисекундах после пере- 
носа курсора мыши на очередной компонент (по умолчанию 500 миллисекунд или 
половина секунды). Свойство HintHidePause аналогичным образом определяет ин- 
тервал времени, после которого ярлычок становится невидимым (по умолчанию 
2500 миллисекунд или две с половиной секунды). Свойство HintShortPause опре- 
деляет аналогичным образом задержку перед появлением нового ярлычка, если в 
данный момент отображается другой ярлычок (по умолчанию 50 миллисекунд). 
Это свойство позволяет предотвратить неприятное мерцание, если пользователь 
быстро перемещает курсор мыши над разными компонентами. 

Теперь остановимся на некоторых методах объекта Application. Методы 
Initialize — инициализация проекта, и Кап — запуск выполнения приложения, 
включаются в каждый проект автоматически — вы можете это увидеть в головном 
файле проекта, если выполните команду Project | View Source. Там же вы можете 
увидеть применение метода создания форм CreateForm для всех автоматически 
создаваемых форм проекта. Если же в вашем проекте есть форма, которая исклю- 
чена из списка автоматически создаваемых (команда Project | Options и соответст- 
вующая установка на странице Гогт$), то когда эта форма вам потребуется, вы 
должны будете вызвать этот метод: 


void _fastcall CreateForm(System::TMetaClass* InstanceClass, 
void *Reference) ; 


где InstanceClass — класс создаваемой формы, который указывается операцией 
_ @а5$14, а Reference — ссылка на создаваемый объект (его имя). Например: 


Application->CreateForm( classid(TForm2), &Гогм2); 


Метод Terminate завершает выполнение приложения. Если вам надо завер- 
шить приложение из главной формы, то вместо метода Application->Terminate() 
вы можете использовать метод Close главной формы. Но если вам надо закрыть 
приложение из какой-то вторичной формы, например, из диалога, то надо приме- 
нять метод Application->Terminate(). 

Метод Minimize сворачивает приложение, помещая его пиктограмму в полосу 
задач Windows. 

Ряд методов связан с работой со справочными файлами. Выше уже говорилось 
о свойстве HelpFile, указывающем текущий файл справки. Метод HelpContext: 
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bool _ fastcall Не1рСопеехе (Classes::THelpContext Context) ; 


вызывает переход в файл справки Ha тему с идентификатором Context. Это иденти- 
фикатор, который при проектировании справки поставлен в соответствие некото- 
рой теме. Метод HelpJump: 


bool _fastcall HelpJump(const System::AnsiString JumpID); 


выполняет аналогичные действия, HO его параметр JumpID — не идентификатор 
темы, а имя соответствующей темы в файле справки, задаваемое в нем сноской #. 
Метод HelpCommand: 


bool _fastcall HelpCommand(int Command, int Data); 


позволяет выполнить указанную параметром Command команду API WinHelp с 
параметром Data. Метод генерирует событие OnHelp активной формы или прило- 
жения, а затем выполняет указанную команду WinHelp. Полный список команд 
WinHelp вы можете найти в теме WinHelp справочного файла м1т32.Шр, располо- 
женного в каталоге ...\Program Files\Common Files\Borland Shared\MSHelp. При- 
ведем только некоторые из них. Команда HELP_CONTENTS с параметром 0 ото- 
бражает окно Содержание справки. Команда HELP_INDEX с параметром 0 отобра- 
жает окно Указатель справки. Команда HELP_CONTEXT с параметром, равным 
идентификатору темы, отображает тему с заданным идентификатором (это тожде- 
ственно рассмотренному ранее методу HelpContext). Команда HELP_CONTEXT- 
РОРОР с параметром, равным идентификатору темы, делает то же самое, но ото- 
бражает тему во всплывающем окне. 

В классе TApplication имеется еще немало методов, но часть из них использу- 
ется в явном виде очень редко (вы можете посмотреть их во встроенной справке 
C++Builder), а часть будет рассмотрена ниже при обсуждении событий объекта 
Application. Хотелось бы только обратить.внимание читателя на очень полезный 
метод MessageBox, позволяющий вызывать диалоговое окно с указанным текстом, 
указанным заголовком\и русскими надписями на кнопках (в русифицированных 
версиях Windows). Это наиболее удачный полностью рисифицируемый стандарт- 
ный диалог. См. о нем подробнее в главе 15 в разделе 15.7.2.3. 

В классе TApplication определено множество событий, которые очень полезны 
для организации приложения. Ранее для использования этих событий было необ- 
ходимо вводить соответствующие обработчики и указывать на них объекту 
Application специальными операторами. В C++Builder 5 введен компонент 
ApplicationEvents, существенно облегчивший эту задачу. Этот компонент пере- 
хватывает события объекта Application и, следовательно, обработчики этих собы- 
тий теперь можно писать как обработчики событий невизуального компонента 
ApplicationEvents. На каждой форме приложения можно разместить свой компо- 
нент ApplicationEvents. События объекта Application будут передаваться всем 
этим компонентам. Если вы хотите, чтобы событие передавалось прежде всего ка- 
кому-то одному из них, примените к нему метод Activate, который поставит его в 
начало очереди компонентов ApplicationEvents. Если же вы при этом не хотите, 
чтобы другие компоненты ApplicationEvents получали события, примените к при- 
вилегированному компоненту метод CancelDispatch. Тогда после обработки собы- 
тия в данном компоненте другие компоненты ApplicationEvents вообще не будут 
реагировать на эти события. 

Во многие обработчики событий компонента ApplicationEvents передается по 
ссылке параметр Handled. По умолчанию его значение равно false. Если вы обра- 
ботали соответствующее событие и не хотите, чтобы оно далее обрабатывалось дру- 
гими компонентами ApplicationEvents, надо в обработчике установить Handled = 
true. Если же вы оставите Handled = false, то событие будут пытаться обрабаты- 
вать другие компоненты ApplicationEvents (если они есть). Если событие так и ос- 
танется необработанным, то его будет пытаться обработать активный компонент, а 
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если не обработает — то активная форма. Предотвратить обработку события други- 
ми компонентами можно, используя описанный ранее метод CancelDispatch. 

Ниже приведена таблица событий компонента ApplicationEvents с их кратки- 
ми описаниями. 


[Событие | Ommediames ель oye aiuto и | ae Sie 


OnActionExe- |Возникает при выполнении (Execute) некоторого действия, 

| сще объявленного в компоненте ActionList, но не обработанного 
им (не написан соответствующий обработчик). Инициализа- 
ция этого события может быть, например, выполнена методом 
Application->ExecuteAction(<uma действия>). Если событие 
не обработано в ActionList, то оно может быть обработано на 
уровне приложения. В обработчик OnActionExecute передает- 
ся параметр Action — действие и по ссылке передается пара- 
метр Handled (см. выше). 


OnActionUpda- | Возникает при обновлении (Update) некоторого действия, объ- 

фе явленного в компоненте ActionList, но не обработанного им 
(не написан соответствующий обработчик). Если событие не 
обработано в ActionList, то оно может быть обработано на 
уровне приложения. В обработчик OnActionUpdate передает- 
ся параметр Action — действие и по ссылке передается пара- 
метр Handled (см. выше). 


OnActivate Возникает, когда приложение становится активным. Это про- 

| исходит при начале выполнения и в случаях, когда пользова- 
тель, перейдя к другим приложениям, вернулся в данное. 
Если это событие обработано в ApplicationEvents, то предот- 
вратить дальнейшую его обработку можно методом CancelDis- | 
patch. 


OnDeactivate Возникает перед тем моментом, когда приложение перестает 
быть активным (пользователь переключается на другое прило- 
жение). Если событие обработано в ApplicationEvents, то 
предотвратить дальнейпгую его обработку можно методом 
CancelDispatch. 


OnException Возникает, когда в приложении сгенерировано исключение, 
которое нигде не перехвачено. В обработчик передается пара- 
метр Sender — источник исключения, и параметр Е типа Ex- 
ception — объект исключения. Параметр Е помогает опреде- 
лить тип исключения. Например, if (E->ClassNamels( “EZero- | 
Divide” )) ... . В обработчике события OnException вы можете 
предусмотреть нестандартную обработку исключений на уров- 
не приложения, например, русифицировать стандартные сооб- 
щения об исключениях и дать пользователю какие-то реко- 
мендации. Учтите, что введение вами обработчика OnExcepti- 
оп отключит стандартную реакцию приложения на исключи- 
тельные ситуации. 
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} 


Событие Описание 


Возникает при запросе приложением справки. Это событие 
возникает, в частности, при выполнении рассмотренных ранее 
методов приложения HelpContext, HelpJump и HelpCom- 
mand. Обработчик может использоваться для каких-то подго- 
товительных операций, например, для задания файла справки 
(параметр Application->HelpFile). В обработчик передаются 
параметры — Command команда API WinHelp (см. выше опи- 
сание HelpCommand), Data — параметр этой команды и по 
ссылке передается булев параметр CallHelp. Если его устано- 
вить в true, то после завершения обработчика будет вызван 
WinHelp, в противном случае вызова WinHelp не будет. 


Возникает в момент, когда курсор мыши начинает перемеща- 
ться над компонентом или разделом меню, в котором опреде- 

лено свойство Hint. При этом свойство Hint компонента пере- 
носится в свойство Hint приложения (Application->Hint) ив 

обработчике данного события может отображаться, например, 
в строке состояния. | 


Возникает, когда приложение начинает простаивать, ожидая, 
например, действий пользователя. В обработчик передается по 
ссылке булев параметр Done, который по умолчанию равен 
true. Если оставить его без изменения, то по окончании рабо- 
ты обработчика данного. события будет вызвана функция Wa- 
itMessage АРТ Windows, которая займется в период ожидания 
другими приложениями. Если задать Done = false, то эта 
функция вызываться не будет. Это может снизить производи- 
тельность Windows. 


OnMessage Возникает, когда приложение получает сообщение Windows 
(но не переданное функцией SendMessage АРТ Windows). В 
обработчике события OnMessage можно предусмотреть нестан- 
дартную (отличную от определенной в TApplication) обработ- 
ку сообщения. В обработчик передается параметр Msg — по- 
лученное сообщение и по ссылке передается параметр Hand- 
led (см. выше). Учтите, что в Windows передаются тысячи со- 
общений в секунду, так что обработчик OnMessage может се- 
рьезно снизить производительность приложения. 


OnMinimize Возникает при сворачивании приложения. | 
OnRestore Возникает при восстановлении ранее свернутого приложения. 


OnShortCut Возникает при нажатии пользователем клавиши. Событие 
возникает до того, как возникло стандартное событие ОпКеу- 
Down компонента или формы. Обработчик позволяет преду- 
смотреть нестандартную реакцию на нажатие какой-то клави- 
ши. В него передается параметр сообщения Windows Msg, 
поле CharCode которого (Msg.CharCode) содержит виртуаль- 
ный код нажатой клавиши. Передается также по ссылке па- 
раметр Handled. Если задать ему значение true, то стандарт- 
ные события OnKeyDown, OnKeyPress, ОпКеу Ор не наступят. 
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Возникает, когда приложение собирается отобразить ярлычок 
с текстом подсказки Hint. В обработчик передается по ссылке 
параметр HintStr — первая часть свойства Hint компонента, 
ярлычок которого должен отображаться. В обработчике этот 
текст можно изменить. Так же по ссылке передается параметр 
CanShow. Если в обработчике установить его равным false, то 


ярлычок отображаться не будет. Третий параметр, передавае- 
мый по ссылке — HintInfo. Это структура, поля которой (см. 
встроенную справку C++Builder) содержат информацию о яр- 
лычке: его координаты, цвет, задержки появления и т.п. В 
частности, имеется поле HintControl — компонент, сообшение 
которого должно отображаться в ярлычке, и поле HintStr — 
отображаемое сообщение. По умолчанию HintInfo.HintStr — 
первая часть свойства Hint компонента. Но в обработчике это 
значение можно изменить. 


Приведем примеры использования событий компонента ApplicationEvents. 
Обработчик события OnHint: 


void _fastcall TForml::ApplicationEventslHint (TObject *Sender) 
{ 

StatusBarl->SimpleText = Application->Hint; 
} 


отображает в полосе состояния StatusBarl (см. раздел 3.7.7) вторую часть свойст- 
ва Hint любого компонента, в котором определено это свойство и над которым пе- 
ремещается курсор мыши. Отображение происходит независимо от значения свой- 
ства ShowHint компонента. 

Обработчик события OnShowHint: 


void  fastcall TForml: :ApplicationEvents1ShowHint ( 
AnsiString &HintStr, bool &CanShow, 
THintInfo &HintInfo) 


{ 
if (HintInfo.HintControl->ClassNamels ("TEdit") ) 
if (Canvas->TextWidth(Editl->Text) > Editl->ClientWidth) 
{ 
HintStr = Editl->Text; 
ApplicationEvents1->CancelDispatch (); 
} 
} 


проверяет класс источника события и, если это окно редактирования, TO с помо- 
щью функции TextWidth проверяет, не превышает ли длина текста ширины кли- 
ентской области. Если превышает, то текст ярлычка подменяется текстом, содер- 
жащимся в окне редактирования. Такой прием позволяет пользователю, подведя 
курсор мыши к окну редактирования, увидеть во всплывающем окне полный 
текст, который может не быть виден обычным образом, если он длинный и не по- 
мещается целиком в окне редактирования. Только учтите, что событие OnShow- 
Hint будет наступать при перемещении курсора только над теми компонентами, в 
которых свойство ShowHint установлено в true. Если вы хотите запретить отобра- 
жение в ярлычке собственной подсказки Hint в окнах редактирования, содержа- 
щих короткий текст, то приведенный код надо дополнить оператором: 


else CanShow = false; 
Обработчик события OnHelp: 


bool _fastcall TForml::ApplicationEventslHelp ( 
WORD Command, int Data,bool &CallHelp) 
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{ 
if ((Command == HELP CONTEXT) && (Data < 10)) 


{ 
Application->HelpCommand (HELP CONTEXTPOPUP, Data) ; 
CallHelp = false; 

} 


return true; 


} 


обеспечивает отображение всех контекстных справок с номерами идентификато- 
ров тем, меньшими 10, во всплывающем окне, не вызывая при этом WinHelp. Это 
дает возможность отобразить многострочные (в отличие от ярлычков) всплываю- 
щие окна, поясняющие назначение тех или иных элементов приложения. Событие 
OnHelp наступает, если пользователь нажал клавишу Fl в компоненте, для кото- 
рого задано значение свойства HelpContext — идентификатор справки, или если в 
заголовке формы имеется системная кнопка справки и с ее помощью пользователь 
сделал запрос о назначении компонента, для которого задано значение HelpCon- 
text. В последнем случае обработчик события может проанализировать состояние 
приложения и в зависимости от режима работы изменить идентификатор темы 
справки. 
Обработчик события OnShortCut: 


void fastcall TFormlr:ApplicationEvents1ShortCut ( 
cea TWMKey &Msg, bool &Handled) 
{ 
if (Msg.CharCode == 'Q'): 
if (Application->MessageBox ( 
"Действительно хотите завершить работу?", 
"Подтвердите завершение", 
МВ YESNOCANCEL+MB ТСОМОЧЕЗТТОМ) == IDYES) 
Application->Terminate(); 
} 
перехватывает нажатие пользователем клавиш и, если нажата клавиша с CHMBO- 
лом «Сб» (в любом регистре и независимо от установки русского или английского 
языка), то пользователю методом Application->MessageBox предлагается диалого- 
вое окно с запросом о завершении работы. Если пользователь подтверждает завер- 
шение, то приложение закрывается методом Application->Terminate. 


асть Il 


Разработка приложений для Windows 


Глава 4 xe 


Глава 5. 


Глава7 _ 


Г лава 8 


Проектирование графического интерфейса 
пользователя 

Графика и мультимедиа 

Взаимодействие приложения свнешними 
программами 

Повторное использование разработанных 
кодов 
Разработка справочной системы (создание 
файлов .hip) | 


ив 
4 Wee 
\ ahs 

“h 


we 


« 
. 


*. cy 
a 


fs 


“rye ро 
562 f a 
Ys 


к. у + 
rot 
a4 


BG 
‚р 


РА 
why dee 
as % 


s 

$ 
tO. 
> 


Проектирование графического 
интерфейса пользователя 


4.1 Требования к интерфейсу пользователя 
приложений для Windows 


4.1.1 Общие рекомендации по разработке графического 
интерфейса 


Под графическим интерфейсом пользователя (Graphical User Interface — GUI) 
подразумевается тип экранного представления, при котором пользователь может 
выбирать команды, запускать задачи и просматривать списки файлов, указывая 
на пиктограммы или пункты в списках меню, показанных на экране. Действия мо- 
гут, как правило, выполняться с помощью мыши, либо нажатием клавиш на кла- 
виатуре. Типичным примером графического интерфейса пользователя является 
Windows. 

C++Builder предоставляет разработчику приложения широкие возможности 
быстрого и качественного проектирования графического интерфейса пользовате- 
ля — различных окон, кнопок, меню и т.д. Так что разработчик может в полной 
мере проявить свою фантазию. Но полеты фантазии очень полезно ограничивать. 
Есть определенные принципы построения графического интерфейса пользователя, 
и пренебрегающий ими обречен на то, что его приложение будет выглядеть чуже- 
родным объектом в среде Windows. 

_ Для пользователя одним из принципиальных преимуществ работы с Windows 
является то, что большинство имеющихся приложений выглядят и ведут себя 
сходным образом. После того, как вы поработаете с несколькими приложениями, 
вы обнаружите, что можете заранее почти наверняка сказать, где можно найти ту 
или иную функцию в программе, которую только что приобрели, или какие быст- 
рые клавиши надо использовать для выполнения тех или иных операций. 
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Ваше приложение не должно выбиваться из общего стиля Windows ни своим внешним видом 
(шрифтами, цветом, меню), ни организацией диалогов. Фантазию надо обращать на постро- 
ение эффективных и надежных алгоритмов функционирования, а не на экзотическое оформ- 
ление приложения. 

Фирма Microsoft предложила спецификации для разработки программного 
обеспечения Windows, направленные на то, чтобы пользователь не тратил время 
на освоение нюансов пользовательского интерфейса новой программы, чтобы он 
смог как можно скорее продуктивно применять ваше приложение. Эти специфика- 
ции образуют основу программы логотипа Windows, проводящейся Microsoft. Что- 
бы вы могли поставить на свой программный продукт штамп «Разработано для 
Windows», ваша программа должна удовлетворять определенным критериям. 

Конечно, вряд ли вы будете очень озабочены приобретением официального 
права на логотип Windows, если только не разработали сногсшибательную про- 
грамму широкого применения, которую надеетесь успешно продавать на междуна- 
родном рынке. Но прислушаться к рекомендациям по разработке графического 
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интерфейса пользователя в любом случае полезно. Они основаны на психофизиоло- 
гических особенностях человека и существенно облегчат жизнь будущим пользо- 
вателям вашей программы, увеличат производительность их работы. 


4.1.2 Многооконные приложения 


Чаще всего сколько-нибудь сложное приложение не может ограничиться од- 
ним окном. Поэтому прежде всего вам нужно решить вопрос управления окнами. 
Есть две различные модели приложений: с интерфейсом одного документа (SDI) и 
с интерфейсом множества документов (MDI). 

В большинстве случаев следует отдавать предпочтение интерфейсу SDI. Этот 
интерфейс не обязательно предполагает наличие действительно только одного 
окна, как в приложениях Windows, типа «Калькулятор». Такое приложение, как 
«Проводник» Windows, также является SDI приложением, но в нужные моменты 
оно создает вторичные окна для поиска файлов или папок, задания параметров, 
просмотра свойств файлов и других целей. 

С другой стороны, у приложений MDI тоже есть свои преимущества. Хороший 
пример такого приложения — Microsoft Word. В приложении MDI имеется роди- 
тельское (первичное) окно и ряд дочерних окон (называемых также окнами доку- 
ментов). Бывают ситуации, когда выгодно отображать информацию в нескольких 
окнах, которые совместно используют элементы интерфейса (например, меню или 
инструментальные линейки). Окна документов управляются и ограничиваются ро- 
дительским окном. Если вы уменьшаете размер родительского окна, то дочерние 
окна могут исчезать из поля зрения. 

Случаи, когда нужно использовать модель МПТ, довольно редки. Прежде все- 
го, это следует делать только тогда, когда все дочерние окна будут содержать иден- 
тичные объекты — например, текстовые документы или электронные таблицы. Не 
применяйте МПТ, если вы собираетесь работать в приложении с дочерними окнами 
разного типа (например, текстовыми документами и электронными таблицами од- 
новременно). Не применяйте МПТ, если вы хотите управлять тем, какое из дочер- 
них окон должно находиться поверх других, используя свойство «всегда наверху», 
или если вы хотите управлять размерами окон, делать их невидимыми ит. п. Ин- 
терфейс MDI предназначен для очень узкого диапазона приложений, в которых все 
дочерние окна однородны (как это имеет место в Word или Excel). Приспособить 
его к чему-то другому не получится. Наконец, следует заметить, что Microsoft не 
поощряет разработку новых приложений MDI (в основном потому, что для 
Windows было написано слишком много плохих программ этого типа). Подробнее 
о технологии построения приложений МПТ будет рассказано в разделе 4.5.4. 


4.1.3 Стиль окон приложения 


Основным элементом любого приложения является форма — контейнер, в ко- 
тором размещаются другие визуальные и невизуальные компоненты. С точки зре- 
ния пользователя форма — это окно, в котором он работает с приложением. К 
внешнему виду окон в Windows предъявляются определенные требования. К, сча- 
стью, C++Builder автоматически обеспечивает стандартный для Windows вид окон 
вашего приложения. Но вам надо продумать и указать, какие кнопки в полосе сис- 
темного меню должны быть доступны в том или ином окне, должно ли окно допус- 
кать изменение пользователем его размеров, каким должен быть заголовок окна. 
Все эти характеристики окон обеспечиваются установкой и управлением свойства- 
ми формы. 

Свойство BorderStyle определяет общий вид окна и операции с ним, которые 
разрептается выполнять пользователю. Это свойство может принимать следующие 
значения: 


ОР a РИ СЕНЕ 


патеттух 
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bsSizeable Обычный BUN < окна Windows с полосой заголовка, с возможно- 
стью для пользователя изменять размеры окна с помощью 
кнопок в полосе заголовка или с помощью мыши, потянув за 
какой-либо край окна. Это значение BorderStyle задается по 


умолчанию 
bsDialog Неизменяемое по размерам окно. Типичное окно диалогов 
bsSingle Окно, размер которого пользователь не может изменить, потя- 


нув курсором мыши край окна, но может менять кнопками в 
полосе заголовка 


bsToolWindow To же, что bsSingle, но с полосой заголовка меньшего размера 


bsSizeToolWin To же, что bsSizeable, но с полосой заголовка меньшего раз- 
мера и с отсутствием в ней кнопок изменения размера 


bsNone Без полосы заголовка. Окно не только не допускает изменения 
размера, но и не позволяет переместить его по экрану 


Свойство Borderlcons определяет набор кнопок, которые имеются в полосе за- 
головка. Множество кнопок задается элементами: 


ОВО ЧИН НОВО УВ НН БОИ ДРИ оО ал ВЯ р IASG IED 


‘bySistemMenu ` копка системного меню © (для ‘Windows 95 / 98/ 2000 1 и 1 МТэ это. Sie 


кнопка с крестиком, закрывающая окно) 


byMinimize кнопка Свернуть, сворачивает окно до пиктограммы 
byMaximize кнопка Развернуть, разворачивает окно на весь экран 
byHelp кнопка справки 


Следует отметить, что не все кнопки могут появляться при любых значениях 
BorderStyle. 

На рис. 4.1 представлен вид окон форм во время выполнения при некоторых 
сочетаниях свойств BorderStyle и Borderlcons. Для создания диалоговых окон 
обычно используется стиль заголовка bsDialog (формы Form3 и Form4 на рис. 4.1), 
причем в этих окнах можно исключить кнопку системного меню (форма Form4) и 
в этом случае пользователь не может закрыть окно никакими способами, кроме 
как выполнить какие-то предписанные ему действия на этой форме. При стиле 
bsNone пользователь не может изменить ни размер, ни положение окна на экране. 
Формы Form3, Form6 и Еогт8 внешне различаются только размером полосы заго- 
ловка, уменьшенным в двух последних формах. Но между ними есть и принципи- 
альное различие: размер формы Form6 (стиль заголовка bsSizeTool Win) пользова- 


Рис. 4.1 BorderSly bi per eg ча ра ae Border tyle = bsDislog Raed : 
Формы при разных Bosdaricons = (bySisiem : т 
сочетаниях свойств | а ге 
Вогаег Ме и Вогдейсоп$ 
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тель может изменить, потянув курсором мыши за край окна. Для форм Form3 и 
Form8 это невозможно. Обратите также внимание, что в формах Еогтб и Еогт8 
задание кнопок свертывания и развертывания окна никак не влияет на его вид: 
эти кнопки просто не могут появляться в этих стилях полос заголовков окон. 


~~ 
о рош и и с ил b n po грамм | po Ba H и я ИАА АЕ ОЛА NBER ИИД УКАЗА УЕ И УИ ИИС EGE EES 


Без особой необходимости не делайте окна приложения с изменяемыми пользователем раз- 
мерами. При изменении размеров, если не применены специальные приемы, описанные в 
разделе 4.2, нарушается компоновка окна и пользователь ничего не выигрывает от своих 
операций с окном. Окно имеет смысл делать с изменяемыми размерами, только если это по- 
зволяет пользователю изменять полезную площадь каких-то расположенных в нем компонен- 
ТОВ ие и НЫ ори. текстов, рен списков И Т.П. 


PLEO ELLE о В он ии прин ORL LEELA SLEEP ELLE LPS EEE 
~~ 
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Для основного окна приложения с неизменяемыми размерами наиболее подходящий стиль 
— BorderStyle = bsSingle с исключением из числа доступных кнопок кнопки Развернуть (Bor- 
derlcons.byMaximize = false). Это позволит пользователю сворачивать окно, восстанавли- 
вать, но не даст возможности | розвернуть окно на весь уров или изменить ‚Возвр окна. 


ЗНАНИЮ АНУЧИНО ИРИНУ ALLO AISB ILE EE PESLIOESSE IESE RSE ASE S DEORE ESISSSEOPTODLG ЗНАНИЕ ASOD RLEV BESS ESA EA SSEDESN DELIA LIEBE SVEN ABEGEEORE SLIDES VIP НИКИ AAPL GILLIE AL ELBELS DILL КРУНИЧИХНУЯИИКО УКР ODE RII CCIM IIE ICR SOE FFIEC 
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Для вторичных диалоговых окон наиболее подходящий стиль — Rides Spier те Мож- 
но также использовать BorderStyle = bsSingle, одновременно исключая из числа доступных 
кнопок кнопку Развернуть (задавая Borderlcons.byMaximize = false). Это позволит пользова- 
телю сворачивать диалоговое окно, если оно заслоняет на экране что-то нужное ему, вос- 
станавливать окно, но не даст возможности развернуть окно на весь экран или изменить 
размер окна. 


ЗИ ЛИНИИ ИЛА ХАУС ИАН ОИ ИАА RR LR APIO ИТ RIE BBE BEE КАИ STOTT LIN ОЧ ERR LRG PEO ROLE ILLES LE ыыы 


mr peayn режден M eB ЗН te a eae a OE a Dae EEA Bae ees CEE Se aS eT aS SS LO ae AS BUSSES OODLE RT DUST By LEY Sal SR DS Re СИНИМИ ОО ГК LINE NELLIE а 


Избегайте, как правило, стиля ий = bsNone. Невозможность переместить окно мо- 
жет создать пользователю трудности, если окно заслонит на экране что-то интересующее 


пользователя. 
ИНВАЗИИ LEE ПЛК ЗАЗОРОВ ОРИОН 


° у 

Свойство формы WindowState определяет вид, в котором окно первоначально 

предъявляется пользователю при выполнении приложения. Оно может принимать 
значения: 


wsNormal нормальный вид окна (это значение ‘WindowState | исполЬ- 
| зуется по умолчанию) 

wsMinimized окно свернуто 

wsMaximized окно развернуто на весь экран 


Если свойство WindowState имеет значение wsNormal или пользователь, ма- 
нипулируя кнопками в полосе заголовка окна, привел окно в это состояние, то по- 
ложение окна при запуске приложения определяется свойством Position, которое 
может принимать значения: 


О В А а OG В О enon ora ae 


poDesigned Первоначальные размеры и положение окна во › время вы- 
полнения те же, что во время проектирования. Это значе- 
ние принимается по умолчанию, но обычно его следует из- 
менить 


а а LEE ELIE LASSER О ELE IEE GE LEER неа К а 
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poScreenCenter Окно располагается в центре экрана. Размер окна TOT, ко- 
| торый был спроектирован. В мультиэкранных приложени- 
ях (см. раздел 4.5.6), работающих одновременно с множе- 
ством мониторов эта центральная позиция может быть не- 
сколько изменена, чтобы изображение попало точно на 
один монитор, определяемый свойством DefaultMonitor 


poDesktopCenter Окно располагается в центре экрана. Размер окна тот, KO- 
торый был спроектирован. Этот режим не приспосаблива- 
ется к приложениям с множеством мониторов (см. раз- 
дел 4.5.6) 


poDefault Местоположение и размер окна определяет Windows, учи- 
тывая размер и разрешение экрана. При последовательных 
показах окна его положение сдвигается немного вниз и 
вправо 


poDefaultPosOnly Местоположение окна определяет Windows. При последо- 
вательных показах окна его положение сдвигается немно- 
го вниз и вправо. Размер окна — спроектированный 


poDefaultSizeOnly Размер окна определяет Windows, учитывая размер и раз- 
решение экрана. Положение окна — спроектированное 


poMainFormCenter Это значение предусмотрено только начиная с C++Builder 5. 
Окно располагается в центре главной формы. Размер окна 
тот, который был спроектирован. Этот режим не приспо- 
сабливается к приложениям с множеством мониторов (см. 
раздел 4.5.6). Используется только для вторичных форм. 
Для главной формы действует так же, как poScreenCenter 


— . 
Хо Pp о Lu и стил b п ро гр амм ha po Ba H и я ный 


Обычно целесообразно для главной формы приложения задавать значение Position равным 
poScreenCenter или poDefaultPosOnly. И только в сравнительно редких случаях, когда на эк- 
ране при выполнении приложения должно определенным образом располагаться несколько 
окон, имеет смысл оставлять значение PODesigned, принимаемое по умолчанию. 


ЖЕНИ LEE LEE GLISS LOPS НСО LO MA i EN КИАНУ OR NAM ALI NM MMR RN AM RPI IIE LN HII RK 
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Если выбранное значение свойства Position предусматривает выбор размера 
формы самим Windows по умолчанию, то на этот выбор влияют свойства Pixels- 
PerInch и Scaled. По умолчанию первое из них задается равным количеству пиксе- 
лей на дюйм в системе, второе установлено в false. Если задать другое число пиксе- 
лей на дюйм, то свойство Scaled автоматически становится равным true. В этом 
случае при запуске приложения размер формы будет изменяться в соответствии с 
пересчетом заданного числа пикселей на дюйм к реальному числу пикселей на 
дюйм в системе (но только при разрешающем это значении свойства Position). 

Свойство AutoScroll определяет, будут ли на форме в процессе выполнения. 
появляться автоматически полосы прокрутки в случае, если при выбранном поль- 
зователем размере окна не все компоненты помещаются в нем. Если значение 
AutoScroll равно true, то будут. В противном случае при уменьшении размера 
окна пользователь теряет доступ к компонентам, не поместившимся в его поле. 

Свойство Icon задает пиктограмму формы. По умолчанию используется стан- 
дартная пиктограмма C++Builder. Нажав в Инспекторе Объектов кнопку с тремя 
точками в строке свойства Icon, вы попадаете в окно Редактора’ Изображений 
(Picture Editor) (см. рис. 3.29 в разделе 3.5.1 или рис. 5.1 в разделе 5.1.1.1). Щелк- 
нув в нем на кнопке Load (загрузить), вы можете выбрать любой файл с изображе- 


244 | | | Глава 4. 


нием пиктограммы (файл с расширением .1со). С C++Builder поставляется некото- 
poe число пиктограмм, расположенных в каталоге |тадез\!сопз. 

Свойство Icon задает только пиктограмму формы, которая отображается в ле- 
вом верхнем углу окна приложения в его нормальном состоянии. Но если пользо- 
ватель свернет окно, то в полосе задач будет видна другая пиктограмма — пикто- 
грамма приложения. Ту же пиктограмму увидит пользователь, если будет про- 
сматривать средствами Windows содержимое каталога. По умолчанию для нее ис- 
пользуется стандартная пиктограмма C++Builder. При свертывании приложения 
рядом с пиктограммой в полосе задач пользователь будет видеть надпись — по 
умолчанию это имя приложения. Если вы хотите, то можете изменить эту пикто- 
грамму и эту надпись. Для этого вы должны выполнить команду Project | Options и в 
открывшемся окне опций проекта перейти на страницу Application (рис. 4.2). В этом 
окне вы можете задать заголовок (Title), который увидит пользователь в полосе за- 
дач при сворачивании приложения. А кнопка Load Icon позволяет вам выбрать пик- 
тограмму, которая будет видна в полосе задач при сворачивании приложения или 
при просмотре пользователем каталога, в котором расположен выполняемый файл 
приложения. 


Рис 4 2 Project Options 
Страница Application окна опций проекта 


Одно из основных свойств формы — FormStyle, которое может принимать 
значения: 


fsNormal Окно обычного приложения. Это значение FormStyle приня- 
то по умолчанию 

fsMDIForm Родительская форма приложения MDI, т.е. приложения с 
дочерними окнами, используемого при работе с нескольки- 
ми документами одновременно 

fsMDIChild Дочерняя форма приложения MDI 

fsStayOnTop Окно, остающееся всегда поверх остальных окон Windows 


О приложениях MDI подробно будет рассказано в разделе 4.5.4. Так что значе- 
ния fsMDIForm и fsMDIChild мы пока подробнее обсуждать не будем. А значение 
FormStyle = fsStayOnTop делает окно всегда остающимся на экране поверх ос- 
тальных окон не только данного приложения, но и всех других приложений, в ко- 
торые может перейти пользователь. 
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Используйте стиль FormStyle = fsStayOnTop для отображения окон сообщений пользователю 
о каких-то аварийных ситуациях. 

В ряде случаев полезно предоставить пользователю самому решать, сделать ли 
данное окно располагающимся всегда поверх остальных, или нет. Например, ему 
может временно потребоваться перейти в какое-то другое приложение, чтобы по- 
лучить необходимую информацию, и при этом будет хотеться видеть поверх этого 
приложения ваше окно, чтобы сравнивать в этих двух окнах какие-то данные. Та- 
кую возможность легко предоставить пользователю. Введите в меню вашего окна 
раздел Поверх остальных и в обработчик щелчка на этом разделе вставьте операторы 

MStayOnTop->Checked = ! MStayOnTop->Checked; 

if (MStayOnTop->Checked) 


Forml->FormStyle = fsStayOnTop; 
else Forml->FormStyle = fsNormal; 
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В этом коде подразумевается, что объект раздела меню, о котором идет речь, 
назван MStayOnTop. Тогда при выборе пользователем этого раздела меню в нем 
появится индикатор (см. раздел 3.6.1), а окно приобретет статус расположенного 
всегда поверх остальных. При повторном выборе этого раздела индикатор исчезнет 
и окно приобретет обычный статус. 


4.1.4 Цветовое решение приложения 


Цвет является мощным средством воздействия на психику человека. Именно 
поэтому обращаться с ним надо очень осторожно. Неудачное цветовое решение мо- 
жет приводить к быстрому утомлению пользователя, работающего с вашим прило- 
жением, к рассеиванию его внимания, к частым ошибкам. Слишком яркий или 
неподходящий цвет может отвлекать внимание пользователя или вводить его в за- 
блуждение, создавать трудности в работе. А удачно подобранная гамма цветов, ос- 
мысленные цветовые акценты снижают утомляемость, сосредоточивают внимание 
пользователя на выполняемых в данный момент операциях, повышают эффектив- 
ность работы. С помощью цвета вы можете на что-то намекнуть или привлечь вни- 
мание к определенным областям экрана. Цвет может также связываться с различ- 
ными состояниями объектов. 

Надо стремиться использовать ограниченный набор цветов и уделять внима- 
ние их правильному сочетанию. Расположение ярких цветов, таких, как красный, 
на зеленом или черном фоне затрудняет возможность сфокусироваться на них. Не 
рекомендуется использовать дополнительные цвета. Обычно наиболее приемле- 
мым цветом для фона будет нейтральный цвет, например, светло-серый (использу- 
ется в большинстве продуктов Microsoft). Помните также, что яркие цвета кажут- 
ся выступающими из плоскости экрана, в то время как темные как бы отступают 
вглубь. 

Цвет не должен использоваться в качестве основного средства передачи ин- 
формации. Можно использовать различные панели, формы, штриховку и другие 
методики выделения областей экрана. Microsoft даже рекомендует разрабатывать 
приложение сначала в черно-белом варианте, а уже потом добавлять к нему цвет. 

Нельзя также забывать, что восприятие цвета очень индивидуально. А по 
оценке Microsoft девять процентов взрослого населения вообще страдают наруше- 
ниями цветовосприятия. Поэтому не стоит навязывать пользователю свое видение 
цвета, даже если оно безукоризненно. Надо предоставить пользователю возмож- 
ность самостоятельной настройки на наиболее приемлемую для него гамму. К тому 
же не стоит забывать, что может быть кто-то захочет использовать вашу ADORED A Me 
му на машине с монохромным монитором. 
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Посмотрим теперь, как задаются цвета приложения, разрабатываемого в 
C++Builder. Большинство компонентов имеют свойство Color (цвет), который вы 
можете изменять в Инспекторе Объектов при проектировании или программно во 
время выполнения (если хотите, чтобы цвета в различных режимах работы прило- 
жения были разные). Щелкнув на этом свойстве в Инспекторе Объектов, вы може- 
те увидеть в выпадающем списке большой набор предопределенных констант, о0бо- 
значающих цвета. Все их можно разбить на две группы: статические цвета типа 
clBlack — черный, clGreen — зеленый ит.д., и системные цвета типа ClWindow — 
текущий цвет фона окон, clMenuText — текущий цвет текста меню и т.д. Полный 
список всех констант и их описание, а также способ конструирования любого дру- 
гого статического цвета вы можете найти в справочной части книги в главе 16 в 
разделе «Со]ог». 

Статические цвета вы выбираете сами и они будут оставаться неизменными 
при работе приложения на любом компьютере. Это не очень хорошо, поскольку 
пользователь не сможет адаптировать вид вашего приложения к своим потребно- 
стям. При выборе желательной ему цветовой схемы пользователь может руково- 
дствоваться самыми разными соображениями: начиная с практических (напри- 
мер, он может хотеть установить черный фон, чтобы экономить энергию батареи), 
и кончая эстетическими (он может предпочитать, например, шкалу оттенков серо- 
го, потому что не различает цвета). Все это он не может делать, если вы задали в 
приложении статические цвета. Но уж если по каким-то соображениям вам надо 
их задать, старайтесь использовать базовый набор из 16 цветов. Если вы попытае- 
тесь использовать 256 (или, что еще хуже, 16 миллионов) цветов, это может замед- 
лить работу вашего приложения, или оно будет выглядеть плохо на машине поль- 
зователя с 16 цветами. К тому же подумайте (а, как правило, это надо проверить и 
экспериментально), как будет выглядеть ваше приложение на монохромном дис- 
плее. 

Исходя из изложенных соображений, везде, где это имеет смысл, следует ис- 
пользовать для своего приложения палитру системных цветов. Это те цвета, кото- 
рые устанавливает пользователь при настройке Windows. Когда вы создаете новую 
форму или размещаете на ней компоненты, C++Builder автоматически присваива- 
ет им цвета в соответствии со схемой цветов, установленной в Windows. Конечно, 
вы будете менять эти установки по умолчанию. Но если при этом вы используете 
соответствующие константы системных цветов, то, когда пользователь изменит 
цветовую схему оформления экрана Windows, ваше приложение также будет соот- 
ветственно меняться и не будет выпадать из общего стиля других приложений. 


Хороший стиль программирования оао 


Не злоупотребляйте в приложении яркими цветами. Пестрое приложение — обычно признак 
дилетантизма разработчика, утомляет пользователя, рассеивает его внимание. Как прави- 
ло, используйте системные цвета, которые пользователь может перестраивать по своему 
усмотрению. Из статических цветов обычно имеет смысл использовать только CIBlack — чер- 
ный, clWhite — белый и clRed — красный цвет предупреждения об опасности. 

Единству цветового решения отдельных частей экрана способствует также ис- 
пользование свойства ParentColor. Если это свойство установлено в true, то цвет 
компонента соответствует цвету содержащего его контейнера или формы. Это обес- 
печивает единство цветового решения окна и, кроме того, позволяет программно 
изменять цвет сразу группы компонентов, если вы, например, хотите, чтобы их 
цвет зависел от текущего режима работы приложения. Для такого группового из- 
менения достаточно изменить только цвет контейнера. 
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4.1.5 Шрифты текстов 


Шрифт надписей и текстов компонентов C++Builder задается свойством Font, 
имеющим множество подсвойств. Кроме того, в компонентах имеется свойство 
ParentFont. Если это свойство установлено в true, то шрифт данного компонента 
берется из свойство Font его родительского компонента — панели или формы, на 
которой расположен компонент. Использование свойств ParentFont и ParentColor 
‘помогает обеспечить единообразие отображения компонентов в окне приложения. 

По умолчанию для всех компонентов C++Builder задается имя шрифта MS 
Sans Serif и размер — 8. Константа множества символов Charset задается равной 
DEFAULT_CHARSET. Последнее означает, что шрифт выбирается только по его 
имени и размеру. Если описанный шрифт недоступен в системе, то Windows заме- 
нит его другим шрифтом. 

Чаще всего эти установки по умолчанию можно не изменять. Конечно, никто 
не мешает задать для каких-то компонентов другой размер шрифта или атрибуты 
типа полужирный, курсив и т.д. Но изменять имя шрифта для вашего приложе- 
ния надо с определенной осторожностью. Дело в том, что шрифт, установленный 
на вашем компьютере, не обязательно должен иметься и на компьютере пользова- 
теля. Поэтому использование какого-то экзотического шрифта может привести к 
тому, что пользователь, запустив ваше приложение на своем компьютере, увидит 
вместо русского текста абракрдабру на никому не понятном языке. Чтобы избе- 
жать таких казусов, вам придется прикладывать к своему приложению еще и фай- 
лы использованных шрифтов и пояснять пользователю, как он должен установить 
их на своем компьютере, если они там отсутствуют. Или вводить автоматическую 
проверку и установку нужных вам шрифтов в установочную программу вашего 
приложения. 

Использование шрифтов по умолчанию: System или MS Sans Serif, чаще все- 
го позволяет избежать подобных неприятностей. Впрочем, увы, не всегда. Если вы 
используете для надписей русские тексты, то при запуске приложения на компью- 
Tepe с нерусифицированным Windows иногда возможны неприятности. Для подоб- 
ных случаев все-таки полезно приложить файлы использованных шрифтов к ва- 
шей программе. Вы можете при установке вашего приложения узнать, имеется ли 
на компьютере пользователя нужный шрифт, например, с помощью следующего 
кода: 


if (Screen->Fonts->IndexOf ("Arial Cir") == -1) 


В этом коде многоточием обозначены действия, которые надо выполнить, если 
нужного шрифта (в примере — Arial Cir) на компьютере нет. Эти действия могут 
заключаться в копировании файлов шрифта с установочной дискеты или СО КОМ 
на компьютер пользователя. 

Другой выход из положения — ввести в приложение команду выбора шрифта 
пользователем. Это позволит ему выбрать подходящий шрифт из имеющихся в его 
системе. Осуществляется подобный выбор с помощью стандартного диалога, 
оформленного в виде компонента FontDialog (см. раздел 3.8.4 главы 3). Проведен- 
ную пользователем установку можно запоминать в файле „МТ, в реестре или в дру- 
гом файле конфигурации и читать автоматически информацию из этого файла при 
каждом запуске приложения (см. раздел 4.7.2). 

Подробное рассмотрение всех свойств компонентов, связанных со шрифтами, 
примеры их использования и исследования вы найдете в главе 16 в разделе 
«Font». 
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4.1.6 Меню 


4.1.6.1 Требования к меню 


Практически любое приложение должно иметь меню, поскольку именно меню 
дает наиболее удобный доступ к функциям программы. Существует несколько раз- 
личных типов меню: главное меню с выпадающими списками разделов, каскадные 
меню, в которых разделу первичного меню ставится в соответствие список подраз- 
делов, и всплывающие или контекстные меню, появляющиеся, если пользователь 
щелкает правой кнопкой мыши на каком-то компоненте. 

В C++Builder меню создаются компонентами MainMenu — главное меню, и 
РорирМепи — всплывающее меню. Оба компонента расположены на странице 
Standard. Все операции по проектированию меню с помощью этих компонентов 
подробно рассмотрены в разделе 3.6. А в данном разделе мы обсудим требования, 
предъявляемые к меню приложений Windows. 

Основное требование к меню — их стандартизация. Это требование относится 
ко многим аспектам меню: месту размещения заголовков меню и их разделов, фор- 
ме самих заголовков, клавишам быстрого доступа, организации каскадных меню. 
Цель стандартизации — облегчит пользователю работу с приложением. Надо, что- 
бы пользователю не приходилось думать, в каком меню и как ему надо открыть 
или сохранить файл, как ему получить справку, как работать с буфером обмена 
Clipboard и т.д. Для осуществления всех этих операций у пользователя, поработав- 
шего хотя бы с несколькими приложениями Windows, вырабатывается стойкий 
автоматизм действий и недопустимо этот автоматизм ломать. 

Начнем рассмотрение требований с размещения заголовков меню. Типичная 
полоса главного меню приведена на рис. 3.5 в разделе 3.2.4 главы 3. Конечно, со- 
став меню зависит от конкретного приложения. Но размещение общепринятых 
разделов должно быть стандартизированным. Все пользователи уже привыкли, 
что меню Файл размещается слева в полосе главного меню, раздел справки — спра- 
ва, перед ним в приложениях MDI размещается меню Окно и т.д. Главное меню 
должно также снабжаться инструментальной панелью (см. рис. 3.5), быстрые 
кнопки которой дублируют наиболее часто используемые команды меню. На этих 
кнопках надо использовать, по возможности, привычные картинки. В C++Builder 
имеется множество изображений кнопок на все случаи жизни, но, к сожалению, 
они не всегда имеют привычный для пользователя рисунок. | 

По возможности стандартным должно быть и расположение разделов в выпа- 
дающих меню. На рис. 4.3 приведены распространенные варианты меню Файл — 
работа с файлами, Правка — работа с текстами, Окно — управление окнами в при- 
ложении MDI и меню Справка или ? — просмотр справочных данных. Обратите 
внимание, что, например, раздел Выход всегда размещается последним в меню 
Файл, а раздел информации о версии программы О программе... — последним в 
справочном меню. 

Группы функционально связанных разделов отделяются в выпадающих меню 
разделителями. 

Названия разделов меню должны быть привычными пользователю. Если вы 
не знаете, как назвать какой-то раздел, не изобретайте свое имя, а попытайтесь 
найти аналогичный раздел в какой-нибудь русифицированной программе 
Microsoft для Windows. Названия должны быть краткими и понятными. Не ис- 
пользуйте фраз, да и вообще больше двух слов, поскольку это перегружает экран и 
замедляет выбор пользователя. Названия разделов должны начинаться с заглав- 
ной буквы. Применительно к английским названиям разделов существует требова- 
ние, чтобы каждое слово тоже начиналось с заглавной буквы. Но применительно к 
русским названиям это правило не применяется. 


у babe: сизая 
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Рис. 4.3 о) 


Типовые меню 


Названия разделов меню, связанных с вызовом диалоговых окон, должны за- 
канчиваться многоточием, показывающим пользователю, что при выборе этого 
раздела ему предстоит установить в диалоге еще какие-то параметры. 

Разделы, к которым относятся каскадные меню (например, раздел Упорядочить 
на рис. 4.3 в) должны заканчиваться стрелкой, указывающей на наличие дочерне- 
го меню данного раздела. C++Builder ставит эту стрелку автоматически, так что о 
ней вам думать не приходится. Вообще злоупотреблять каскадными меню не сле- 
дует, так как пользователю не так просто до них добираться. Если в дочернем 
меню должно быть много разделов, например, связанных с какими-то опциями и 
настройками, то подумайте, не лучше ли вместо этого дочернего меню предусмот- 
реть диалоговое окно, в котором эти опции будут более обозримыми и доступными. 

В каждом названии раздела должен быть выделен подчеркиванием символ, 
соответствующий клавише быстрого доступа к разделу (клавиша Alt плюс подчерк- 
нутый символ). Хотя вряд ли такими клавишами часто пользуются, но традиция 
указания таких клавиш незыблема. 

Многим разделам могут быть поставлены в соответствие «горячие» клавиши, 
позволяющие обратиться к команде данного раздела, даже не заходя в меню. Ком- 
бинации таких «горячих» клавиш должны быть традиционными. Например, ко- 
манды вырезания, копирования и вставки фрагментов текста практически всегда 
имеют «горячие» клавиши Сн|-Х, Ctrl-C и Сн-У соответственно. Заданные сочетания 
клавиш отображаются в заголовках соответствующих разделов меню (см. рис. 4.3 а 
и 4.3 6). 

Начиная с C++Builder 4 предусмотрена возможность включать в меню пикто- 
граммы, соответствующие некоторым разделам (см. рис. 4.Заи 4.3 6). Это не вхо- 
дит в обязательные требования к меню и использование пиктограмм — дело вкуса. 

Некоторые разделы меню, соответствующие выбору каких-то настроек, могут 
содержать индикаторы, показывающие, выбран или нет данный раздел, и могут 
содержать радиокнопки. Способы создания подобных разделов меню см. в разделе 
3.6.1. 

Не все разделы меню имеют смысл в любой момент работы пользователя с при- 
ложением. Например, если в приложении не открыт ни один документ, то бес- 
смысленно выполнять команды редактирования в меню Провка. Если в тексте до- 
кумента ничего не изменялось, то бессмысленным является раздел этого меню От- 
менить, отменяющий последнюю команду редактирования. Такие меню и отдель- 
ные разделы должны делаться временно недоступными или невидимыми. Это осу- 
ществляется заданием значения false свойствам раздела Enabled или Visible coor- 
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ветственно. Различие между недоступными и невидимыми разделами в том, что 
недоступный раздел виден в меню, но отображается серым цветом, а невидимый 
раздел просто исчезает из меню, причем нижележащие разделы смыкаются, зани- 
мая его место. Выбор того или иного варианта — дело вкуса и удобства работы 
пользователя. Вероятно, целиком меню лучше делать невидимыми, а отдельные 
разделы — недоступными. Например, пока ни один документ не открыт, меню 
Правка можно сделать невидимым, чтобы он не отвлекал внимания пользователя. 
А раздел Отменить этого меню в соответствующих ситуациях лучше делать недос- 
тупным, чтобы пользователь видел, что такой раздел в меню есть и им можно бу- 
дет воспользоваться в случае ошибки редактирования. 

| Вот и все основные требования к главному меню приложения. Проектирова- 
ние меню — не очень быстрый процесс и обидно повторять его снова и снова для 
каждого нового приложения, тем более, что требование стандартизации приводит 
к тому, что одни и те же разделы с одинаковыми свойствами кочуют из приложе- 
ния в приложение. Поэтому можно рекомендовать один раз потратить время, соз- 
дать меню, содержащее большинство разделов, которые могут вам понадобиться в 
различных приложениях, и сохранить это меню как шаблон (в разделе 3.6.1 рас- 
сказано, как это. делается с помощью команды Save As Template в Конструкторе 
Меню). В дальнейшем вы сможете использовать этот шаблон в любом своем прило- 
жении, загружая его командой Insert From Template Конструктора Меню в компонент 
MainMenu. А удалить после этого разделы, не используемые в данном приложе- 
нии, не представляет никакого труда — вы просто выделяете соответствующий 
раздел в Конструкторе Меню и нажимаете клавишу Del. 

Помимо главного меню в приложении обычно должны быть контекстные 
всплывающие меню отдельных компонентов, например, окон редактирования. Эти 
меню обычно дублируют команды главного меню, используемые при работе с дан- 
ным компонентом. В разделе 3.6.2 рассказано, как проектируются всплывающие 
меню с помощью компонента РорирМепи. Всплывающие меню желательно не пе- 
регружать разделами, вводя в них только действительно часто используемые ко- 
манды. 


4.1.6.2 Методика проектирования меню и инструментальной панели 


Теперь обсудим, как можно удовлетворить рассмотренные в разделе 4.1.6.1 тре- 
бования к меню в приложениях C++Builder. Отдельные вопросы, связанные с этим, 
уже рассмотрены в главе 3: разработка меню — раздел 3.6.1, разработка инструмен- 
тальной панели — разделы 3.7.5 и 3.7.6, компоненты организации управления при- 
ложением — раздел 3.9. Ниже все это объединено вместе при рассмотрении основ- 
ных этапов разработки полноценного меню. В качестве примера рассмотрим прило- 
жение, изображенное ранее на рис. 3.5. Его форма приведена на рис. 4.4. 


Рис. 4.4 ? 


Форма приложения, изображенного ранее 
на рис. 3.5 


Проектирование графического интерфейса пользователя 251 


Итак, основные этапы разработки сводятся к следующему: 


Перенесите на форму компонент диспетчеризации действий ActionList (на 
рис. 4.4 он второй слева в верхнем ряду невизуальных компонентов). Приме- 
нение этого компонента не обязательно. Но, привыкнув к работе с ним, вы 
увидите, что его применение экономит вам много времени и делает код более 
прозрачным и простым в сопровождении. 


Перенесите на форму компонент ImageList — список изображений для разде- 
лов меню и быстрых кнопок инструментальной панели (на рис. 4.4 он первый 
слева в верхнем ряду). 


С помощью редактора списка изображений, вызываемого двойным щелчком 
на ImageList, заполните список изображениями, символизирующими OCHOB- 
ные команды будущего меню (см. раздел 3.9.2 главы 3). 


Перенесите на форму компоненты стандартных диалогов типа «Открыть 


файл» (компонент OpenFileDialog), «Сохранить файл как» (компонент Save- 
FileDialog) и др. На рис. 4.4 диалоги — все компоненты нижнего ряда. Пере- 
несите также другие компоненты, к которым будут относиться действия. На-. 
пример, на рис. 4.4 на форме расположено многострочное окно редактирова- 
ния Richkdit. 


Компонент диспетчеризации действий ActionList свяжите со списком изобра- 
жений, установив его свойство Images равным ImageListl — имени компо- 
нента ImageList. 


Двойным щелчком на компоненте ActionList вызовите редактор действий и 
занесите в нем все действия, соответствующие будущим разделам меню (см. 
рис. 3.59 в разделе 3.9.1 главы 3). 


После занесения в список очередного действия выделите его в правом окне 
рис. 3.59 и на странице свойств окна Редактора Кода задайте его свойства. 


`Прежде всего задайте Name (имя) — желательно осмысленное, связанное с 


введенным действием. Только не задавайте имена, которые могут оказаться 
тождественными именам каких-то функций, переменных и т.д. Чтобы не воз- 
никало подобных казусов, можно рекомендовать добавлять ко всем именам в 
начале символ «А», как это сделано на рис. 3.59. Вы должны также устано- 
вить свойство Caption — надпись, которая далее будет появляться в кнопках, 
разделах меню и т.д. При этом надо следовать всем изложенным в разделе 
4.1.6.1 требованиям: выделение подчеркнутого символа, многоточия в конце 
разделов, вызывающих диалоговые окна и т.д. Вы можете также задать свой- 
ства: ShortCut — быстрые клавиши (если они должны назначаться для данно- 
го действия), Hint — надписи на ярлычках подсказок и в строке состояний 
(см. подробнее в разделе 4.1.9), HelpContext — идентификатор темы контекст- 
ной справки (если для данного действия предусмотрена справка), Imageln- 
dex — индекс изображения в ImageList, соответствующего данному действию. 
Можете также, при необходимости, задать свойства Enabled — доступность, 
Checked — занесение индикатора выделения и др. 


Для каждого действия на странице событий Инспектора Объектов определено 
событие OnExecute. В обработчике этого события вам надо описать операции, 
соответствующие данному действию. Например, для действия AExit (выход из 
программы) обработчик может иметь вид 


void _fastcall TFMain::AExitExecute(TObject *Sender) 


{ 
Close (); 


} 
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Обратите внимание, что заголовок процедуры (AExitExecute) получается oc- 
мысленным — он указывает на характер действия. Такое название процедуры, ко- 
нечно, много понятнее, чем ButtondClick или N1Click — имена, получающиеся 
без использования компонента ActionList. 


9. После завершения списка действий перенесите на форму компонент MainMe- 
пи — главное меню (на рис. 4.4 третий компонент слева в верхнем ряду). Уста- 
новите его свойство Images равным ImageListl — имени компонента Image- 
List. Вызовите двойным щелчком на МашМепи редактор меню (см. раз- 
дел 3.6.1). Вы можете не задавать для вводимых вами разделов меню никаких 
свойств. Достаточно, выделив очередную пунктирную рамку в редакторе 
меню, задать в Инспекторе Объектов для очередного раздела свойство Action. 

‚Для этого достаточно щелкнуть в строке правее этого свойства и из выпадаю- 
щего списка, в котором имеются все введенные вами действия, выбрать нуж- 
ное. Вы увидите, что при этом автоматически заполнятся все свойства данного 
раздела меню: появится надпись, изображение (если оно предусмотрено), тек- 
сты подсказок в свойстве Hint ит.д. На странице событий Инспектора Объек- 
тов вы увидите, что в событие OnClick (щелчок) уже занесена ссылка на ранее 
написанный вами для этого действия обработчик. Таким образом, применение 
компонента ActionList существенно упростило разработку меню. 


10. Перенесите на форму компонент инструментальной панели ToolBar. Щелкая 
на нем правой кнопкой мыши выбирайте команды New Button (новая кнопка) 
или New Separator (новый разделитель). Для каждой новой кнопки так же, как 
ранее для разделов меню, устанавливайте свойство Action. Все остальные 
свойства перенесутся в кнопку автоматически. 


11. Если необходимо обеспечить в приложении контекстные всплывающие меню, 
то перенесите на.форму один или несколько (по числу различных контекстных 
меню) компонентов РорирМепи — на рис. 4.4 это второй справа компонент в 
верхнем ряду. Свяжите их с компонентом ImageList, задав свойство Images. 
Далее, сделав двойной щелчок на РорирМепи, вы попадете в тот же редактор 
меню, что и в случае MainMenu. Вы можете проектировать всплывающее 
меню так же, как главное. Но, поскольку всплывающее меню обычно дублиру- 
ет какие-то разделы уже сформированного главного меню, то можно обойтись 
копированием соответствующих разделов. Техника подобного копирования 
рассмотрена в разделе 3.6.2. 


12. Когда контекстное меню сформировано, для привязки его к необходимому 
компоненту выделите этот компонент на форме и в инспекторе объектов задай- 
те его свойство РорирМепа равным имени компонента соответствующего Ро- 
pupMenu. 


13. Можете добавить Ha форму панель состояния StatusBar (на рис. 4.4. внизу) и 
компонент ApplicationEvents (на рис. 4.4 он правый в верхнем ряду). Эти 
компоненты могут обеспечить отображение в панели состояния развернутых 
подсказок (см раздел 4.1.8). 


Вот в общих чертах последовательность операций при проектировании меню и 
инструментальной панели с использованием компонентов ActionList, ImageList, 
MainMenu, РорирМепи и ToolBar. Как видите, это не очень быстрый процесс и 
обидно повторять его снова и снова для каждого нового приложения, тем более, 
что требование стандартизации приводит к тому, что одни и те же разделы с одина- 
ковыми свойствами кочуют из приложения в приложение. Поэтому можно реко- 
мендовать один раз потратить время, создать меню, содержащее большинство раз- 
делов, которые могут вам понадобиться в различных приложениях, и затем сохра- 
нить его в качестве шаблона. Вопросы создания шаблонов рассмотрены в главе 7 в 
разделе 7.2. 
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4.1.7 Компоновка форм 


Каждое окно, которое вы вводите в свое приложение, должно быть тщательно 
продумано и скомпоновано. Удачная компоновка может стимулировать эффектив- 
ную работу пользователя, а неудачная — рассеивать внимание, отвлекать, застав- 
лять тратить лишнее время на поиск нужной кнопки или индикатора. 

Управляющие элементы и функционально связанные с ними компоненты эк- 
рана должны быть зрительно объединены в группы, заголовки которых коротко и 
четко поясняют их назначение. Такое объединение позволяют осуществлять раз- 
личные панели, рассмотренные в разделе 3.7. Можно рекомендовать, как правило, 
размещать компоненты не непосредственно на форме, а на таких панелях. Но и 
внутри панелей надо продумывать размещение компонентов как с точки зрения эс- 
тетики, так и сточки зрения визуального отражения взаимоотношений элементов. 
Например, если имеется кнопка, которая разворачивает окно списка, то эти два 
компонента должны быть визуально связаны между собой: размещены на одной 
панели и в непосредственной близости друг от друга. Если же ваш экран представ-. 
ляет собой случайные скопления кнопок, то именно так он и будет воспринимать- 
ся. И вследующий раз пользователь не захочет пользоваться вашей программой. 

Каждое окно должно иметь некоторую центральную тему, которой подчиняется 
его композиция. Пользователь должен понимать, для чего предназначено данное 
окно и что в нем наиболее важно. При этом недопустимо перегружать окно большим 
числом органов управления, ввода и отображения информации. В окне должно ото- 
бражаться главное, а все детали и дополнительную информацию можно отнести на 
вспомогательные окна. Для этого полезно вводить в окно кнопки с надписью Боль- 
ше..., многоточие в которой показывает, что при нажатии этой кнопки откроется 
вспомогательное окно с дополнительной информацией. Помогают также разгрузить 
окно многостраничные компоненты с закладками, рассмотренные в разделе 3.7.4. 
Они дают возможность пользователю легко переключаться между разными по тема- 
тике страницами, на каждой из которых имеется необходимый минимум информа- 
ции. Примеры удачной организации окон вы можете посмотреть в C++Builder, вы- 
полнив команду Tools | Environment Options и полистав страницы окна опций. 

Еще один принцип, которого надо придерживаться при проектировании 
окон — стилистическое единство всех окон в приложении. Недопустимо, чтобы 
сходные по функциям органы управления в разных окнах назывались по-разному 
или размещались в разных местах окон. Все это мешает работе с приложением, от- 
влекает пользователя, заставляет его думать не о сущности работы, а о том, как 
приспособиться к тому или иному окну. Появившийся в C++Builder 5 компонент 
Frame — фрейм (см. раздел 3.7.8) позволяет один раз разработать некий повто- 
ряющийся фрагмент окна, поместить его в Депозитарий (см. главу 7 раздел 7.4), а 
затем использовать его в разных формах и приложениях. 

Стилистическому единству окон приложения способствует имеющаяся в 
C++Builder возможность создания иерархии форм. Эта возможность рассмотрена в 
разделе 7.4. Приступая к большому проекту полезно сначала создать иерархиче- 
скую последовательность форм, а затем уже, используя эту иерархию, проектиро- 
вать конкретные окна. Кроме всего прочего, это позволяет сэкономить немало вре- 
мени при разработке, потому что внесение каких-то усовершенствований в одну 
форму автоматически ведет к тиражированию этих изменений в других формах. 

Единство стилистических решений важно не только внутри приложения, HO и 
в рамках серии разрабатываемых вами приложений. Это нетрудно обеспечить с по- 
мощью имеющихся в C++Builder многочисленных способов повторного использо- 
вания кодов (см. главу 7). Вам достаточно один раз разработать какие-то часто 
применяемые формы — ввода пароля, запроса или предупреждения пользователя 
ит.п., включить их в депозитарий, а затем вы можете использовать их многократ- 
но во всех своих проектах. 
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4.1.8 Последовательность фокусировки элементов 


При проектировании приложения важно правильно определить последова- 
тельность табуляции оконных компонентов. Под этим понимается последователь- 
ность, в которой переключается фокус с компонента на компонент, когда пользо- 
ватель нажимает клавишу табуляции Tab. Это важно, поскольку в ряде случаев 
пользователю удобнее работать не с мышью, а с клавиатурой. Пусть, например, 
вводя данные о каком-то сотруднике пользователь должен в отдельных окнах ре- 
дактирования указать фамилию, имя и отчество. Конечно, набрав фамилию ему 
удобнее нажать клавишу Tab и набирать имя, а потом опять, нажав Tab, набирать 
отчество, чем каждый раз отрываться от клавиатуры, хватать мышь и переклю- 
чаться в новое окно редактирования. 

Свойство формы ActiveControl, установленное в процессе проектирования, оп- 
ределяет, какой из размещенных на форме компонентов будет в фокусе в первый 
момент при выполнении приложения. В процессе выполнения это свойство изменя- 
ется и показывает тот компонент, который в данный момент находится в фокусе. 

Последовательность табуляции задается свойствами TabOrder компонентов. 
Первоначальная последовательность табуляции определяется просто той последо- 
вательностью, в которой размещались управляющие элементы на форме. Первому 
элементу присваивается значение TabOrder, равное 0, второму 1 ит.д. Значение 
TabOrder, равное нулю, означает, что при первом появлении формы на экране в 
фокусе будет именно этот компонент (если не задано свойство формы ActiveCont- 
rol). Если на форме имеются панели, фреймы и иные контейнеры, включающие в 
себя другие компоненты, то последовательность табуляции составляется независи- 
мо для каждого компонента-контейнера. Например, для формы будет последова- 
тельность, включающая некоторую панель как один компонент. А уже внутри 
этой панели будет своя последовательность табуляции, определяющая последова- 
тельность получения фокуса ее дочерними оконными компонентами. 

Каждый управляющий элемент имеет уникальный номер TabOrder внутри 
своего родительского компонента. Поэтому изменение значения TabOrder како- 
го-то элемента на значение, уже существующее у другого элемента, приведет к 
тому, что значения TabOrder всех последующих элементов автоматически изме- 
нятся, чтобы не допустить дублирования. Если задать элементу значение TabOr- 
der, большее, чем число элементов в родительском компоненте, он просто станет 
последним в последовательности табуляции. 

Из-за того, что при изменении TabOrder одного компонента могут меняться 
TabOrder других компонентов, устанавливать эти свойства поочередно в отдель- 
ных компонентах трудно. Поэтому в среде проектирования C++Builder 5 имеется 
специальная команда Edit | Tab Order, позволяющая в режиме диалога задать после- 
довательность табуляции всех элементов. 

Значение свойства TabOrder играет роль только, если другое свойство компо- 
нента — TabStop установлено в true и если компонент имеет родителя. Например, 
для формы свойство TabOrder имеет смысл только в случае, если для формы задан 
родитель в виде другой формы. Установка TabStop в false приводит к тому, что 
компонент выпадает из последовательности табуляции и ему невозможно передать 
фокус клавишей Tab (однако предать фокус мышью, конечно, можно). 

Имеется и программная возможность переключения фокуса — это метод 
SetFocus. Например, если вы хотите переключить в какой-то момент фокус на 
окно Edit2, вы можете сделать это оператором: 


Edit2->SetFocus(); 


Выше говорилось, что в приложении с несколькими окнами редактирования, 
в которые пользователь должен поочередно вводить какие-то данные, ему удобно 
переключаться между окнами клавишей табуляции. Но еще удобнее пользовате- 
лю, закончившему ввод в одном окне, нажать клавишу Enter и автоматически пе- 
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рейти к другому окну. Это можно сделать, обрабатывая событие нажатия клавиши 
OnKeyDown (см. о событиях при нажатии клавиш в разделе 4.3.2). Например, 
если после ввода данных в окно Edit] пользователю надо переключаться в окно 
Edit2, то обработчик события OnKeyDown окна Editl можно сделать следующим: 
void  fastcall TForml::EditlKeyDown (TObject *Sender, 
WORD &Key, TShiftState Shift) 


{ 
if (Key == VK RETURN) Edit2->SetFocus(); 
} 


Единственный оператор этого обработчика проверяет, не является JIM клави- 
‚ ша, нажатая пользователем, клавишей Enter. Если это клавиша Enter, то фокус пе- 
редается окну Edit2 методом SetFocus. 

Можно подобные операторы ввести во все окна, обеспечивая требуемую после- 
довательность действий пользователя (впрочем, свобода действий пользователя от 
этого не ограничивается, поскольку он всегда может вернуться вручную к нужно- 
му окну). Однако можно сделать все это более компактно, используя один обработ- 
чик для различных окон редактирования и кнопок. Для этого может использо- 
ваться метод FindNextControl, возвращающий дочерний компонент, следующий в 
последовательности табуляции. Если компонент, имеющий в данный момент фо- 
кус, является последним в последовательности табуляции, то возвращается пер- 
вый компонент этой последовательности. Метод определен следующим образом: 

TWinControl* fastcall FindNextControli ( 

TWinControl* CurControl, 


bool GoForward, bool CheckTabStop, 
bool CheckParent) ; 


Он находит и возвращает следующий за указанным в параметре CurControl 
дочерний оконный компонент в соответствии с последовательностью табуляции. 

Параметр GoForward определяет направление поиска. Если'он равен true, то 
поиск проводится вперед и возвращается компонент, следующий за CurControl. 
Если же параметр GoForward равен false, то возвращается предшествующий ком- 
понент. 

Параметры CheckTabStop и CheckParent определяют условия поиска. Если 
CheckTabStop равен true, то просматриваются только компоненты, в которых 
свойство TabStop установлено в true. При CheckTabStop равном false значение 
TabStop не принимается во внимание. Если параметр CheckParent равен true, то 
просматриваются только компоненты, в свойстве Parent которых указан данный 
оконный элемент, т.е. просматриваются только прямые потомки. ‘Если 
CheckParent равен false, то просматриваются все, даже косвенные потомки данно- 
го элемента. 

Таким образом, для решения поставленной нами задачи — автоматической пе- 
редачи фокуса при нажатии клавиши Enter, вы можете написать единый обработ- 
чик событий OnKeyDown всех интересующих вас оконных компонентов, содержа- 
щий оператор: 

if (Key == VK RETURN) FindNextControl ( 

(TWinControl *)Sender, true, true, false)->SetFocus(); 


Этот оператор обеспечивает передачу фокуса очередному компоненту. Для 
кнопок аналогичный оператор можно вставить в обработчик события OnClick: 


FindNextControl ((TWinControl *)Sender, true, true, false)->SetFocus(); 


В приведенных кодах используется параметр Sender, передаваемый BO все об- 
работчики событий и соответствующий тому компоненту, в котором произошло со- 
бытие. Этот параметр имеет тип TObject. А поскольку функция FindNextControl 
требует параметр объекта типа TWinControl, необходимо явным образом привести 
тип TObject к производному от него типу TWinControl с помощью операции 
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(TWinControl *)Sender (см. подробнее о работе с параметром Sender в разделе 
1.5.6.2 главы 1). 


4.1.9 Подсказки и контекстно-зависимые справки 


Приложение должно предельно облегчать работу пользователя, снабжая его 
системой подсказок, помогающих сориентироваться в приложении. Эта система 
включает в себя: 


Ш ЯЛрлычки, которые всплывают, когда пользователь задержит курсор мыши 
над каким-то элементом окна приложения. В частности, такими ярлычками 
обязательно должны снабжаться быстрые кнопки инструментальных панелей, 
поскольку нанесенные на них пиктограммы часто не настолько выразительны, 
чтобы пользователь без дополнительной подсказки мог понять их назначение. 


и Кнопка справки в полосе заголовка окна, позволяющая пользователю посмот- 
реть во всплывающих окнах назначение различных элементов окна. 


Ш Более развернутые подсказки в панели состояния или в другом отведенном 
под это месте экрана, которые появляются при перемещении курсора мыши в 
ту или иную область окна приложения. 


Ш Встроенную систему контекстно-зависимой оперативной справки, вызывае- 
мую по клавише Г]. 


Ш Раздел меню Спровка, позволяющий пользователю открыть стандартный файл 
справки Windows .Шр, содержащий в виде гипертекста развернутую информа- 
цию по интересующим пользователя вопросам. 


Тексты ярлычков и подсказок панели состояния устанавливаются для любых 
визуальных компонентов в свойстве Hint в виде строки текста, состоящей из двух 
частей, разделенных символом вертикальной черты ‘|. Первая часть, обычно 
‚ очень краткая, предназначена для отображения в ярлычке; вторая более разверну- 
тая подсказка предназначена для отображения в панели состояния или ином за- 
данном месте экрана. Например, в кнопке, соответствующей команде открытия 
файла, в свойстве Hint может быть задан текст: 


Открыть | Открытие текстового файла 


Как частный случай, в свойстве Hint может быть задана только первая часть 
подсказки без символа ‘|’. 

Для того, чтобы первая часть подсказки появлялась во всплывающем ярлыч- 
ке, когда пользователь задержит курсор мыши над данным компонентом, надо 
сделать следующее: i 


1. Указать тексты свойства Hint для всех компонентов, для которых вы хотите 
обеспечить ярлычок подсказки. 


2. Установить свойства ShowHint (показать подсказку) этих компонентов в true 
или установить в true свойство ParentShowHint (отобразить свойсто Show- 
Hint родителя) и установить в true свойство ShowHint контейнера, содержа- 
щего данные компоненты. 


Конечно, вы можете устанавливать свойства в true или false программно, 
включая и отключая подсказки в различных режимах работы приложения. 

При ShowHint, установленном в true, окно подсказки будет всплывать, даже 
если компонент в данный момент недоступен (свойство Enabled = false). 

Если вы не задали значение свойства компонента Hint, но установили в true 
свойство ShowHint или установили в true свойство ParentShowHint, а в родитель- 
ском компоненте ShowHint = true, то в окне подсказки будет отображаться текст 
Hint из родительского компонента. 

Правда, все описанное выше справедливо при значении свойства ShowHint 
приложения Application равном true (это значение задано по умолчанию). Если 
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установить Application.ShowHint в false, то окна подсказки не будут появляться 
независимо от значений ShowHint в любых компонентах. 

Свойства Hint компонентов можно также использовать для отображения тек- 
стов заключенных в них сообщений в какой-то метке или панели с помощью функ- 
ций GetShortHint и GetLongHint, первая из которых возвращает первую часть со- 
общения, а вторая — вторую (если второй части нет, то возвращается первая 
часть). Например, эти функции можно использовать в обработчиках событий 
OnMouseMove, соответствующих прохождению курсора мыпти над данным компо- 
нентом. Так обработчик 

void fastcall TForml::ButtonlMouseMove (TObject *Sender, 

TShiftState Shift, int X, int Y) 

{ 

TControl *Send = (TControl *)Sender; 
Panell->Caption GetShortHint (Send->Hint) ; 
Panel2->Caption = GetLongHint (Send->Hint) ; 
} 


отобразит в панели Panell первую, а в панели Panel2 — вторую часть свойства 
Hint всех компонентов, над которыми будет перемещаться купсор, если в этих 
компонентах в событии OnMouseMove указан этот обработчик LabellMouseMove. 
Причем это не зависит от значения их свойства ShowHint. 

Еще один пример. Пусть вы хотите, чтобы при нажатии некоторой кнопки 
Ви Йоп1 вашего приложения в панели Panell высвечивалась подсказка пользова- 
телю, например, «Укажите имя файла», а сама кнопка имела всплывающий ярлы- 
чок подсказки с текстом «Ввод». Тогда вы можете задать свойству Hint этой кноп- 
ки значение «ВводУкажите имя файла», задать значение true свойству ShowHint, 
а в обработчик события нажатия этой кнопки вставить оператор 


Panell->Caption = GetLongHint (Buttonl->Hint) ; 


Если же вы не хотите отображать ярлычок подсказки для кнопки, TO можете 
ограничиться значением Hint, равным «Укажите имя файла», а приведенный 
выше оператор оставить неизменным или заменить на эквивалентный ему в дан- 
ном случае оператор 


Panell->Caption = GetShortHint (Buttonl->Hint) ; 


или даже просто на оператор 
Panell->Caption = Buttonl->Hint; 


Перед тем моментом, когда должен отобразиться ярлычок какого-нибудь KOM- 
понента, возникает событие приложения OnShowHint. В обработчике этого собы- 
тия можно организовать какие-то дополнительные действия, например, изменить 
отображаемый текст. Особенно легко работать с событиями приложения в 
C++Builder 5, в котором имеется компонент ApplicationEvents, перехватываю- 
щий все эти события (см. подробнее в разделе 3.9.3). В обработчик его события 
OnShowHint можно поместить те операторы, которые надо выполнить перед ото- 
бражением ярлычка. Заголовок этого обработчика имеет вид: 

void _fastcall TForml::ApplicationEvents1ShowHint ( 


AnsiString &HintStr, bool &CanShow, 
THintInfo &HintInfo) 


Здесь передаваемый по ссылке параметр HintStr — отображаемый в ярлычке 
текст. В обработчике этот текст можно изменить. Так же по ссылке передается па- 
раметр CanShow. Если в обработчике установить его равным false, то ярлычок ото- 
бражаться не будет. Третий параметр, передаваемый по ссылке — HintInfo. Это 
структура, поля которой содержат информацию о ярлычке: его координаты, цвет, 
задержки появления и т.п. В частности, имеется поле HintControl — компонент, 
сообщение которого должно отображаться в ярлычке, и поле HintStr — отобра- 
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жаемое сообщение. По умолчанию HintInfo.HintStr — первая часть свойства Hint 
компонента. Но в обработчике это значение можно изменить. В разделах 3.7.8 и 
3.9.3 приведены примеры использования обработчика события OnShowHint для 
отображения в ярлычке длинных текстов, содержащихся в окнах редактирования. 

Имеется еще один способ отображения второй части сообщения, записанного в 
Hint, в строке состояния или какой-то области экрана в моменты, когда курсор 
мыши проходит над компонентом — это использование обработки события прило- 
жения OnHint. Это событие не того компонента, над которым проходит курсор 
мыши, а именно приложения — объекта Application. В C++Builder 5 это событие 
также перехватывается компонентом ApplicationEvents. Если обработчик этого 
события определен, то в момент прохождения курсора над компонентом, в кото- 
ром задано свойство Hint, вторая часть сообщения компонента заносится в свойст- 
во Hint объекта Application. Если свойство Hint компонента содержит только 
одну часть, то в свойство Hint объекта Application заносится эта первая часть. 

Если ваше приложение содержит инструментальную панель с быстрыми кноп- 
ками, то, как правило, эти кнопки должны снабжаться не только всплывающими 
ярлычками, но и развернутыми подсказками в панели состояния (см. пример па- 
нели на рис. 4.4 и 3.5). Если у вас есть подобный пример, вы можете опробовать на 
нем методику отображения подсказок в панели состояния. А можете взять ка- 
кой-нибудь более простой пример. Для реализации подсказок в панели состояния 
надо перенести на форму панель состояния — компонент StatusBar со страницы 
Win32 (см. раздел 3.7.7) и компонент ApplicationEvents. Если вам нужна односек- 
ционная панель, установите свойство SimplePanel панели StatusBar в true. Если 
вы хотите использовать многосекционную панель, то в приведенном ниже операто- 
ре надо заменить свойство SimpleText ссылкой на панель, в которой вы хотите 
отображать подсказку. 

Напишите какие-нибудь тексты в свойствах Hint компонентов, размещенных 
на вашей форме. А в обработчик события OnHint компонента ApplicationEvents 
вставьте оператор 


StatusBarl->SimpleText = Application->Hint; 


Запустите приложение на выполнение. Вы увидите, что тексты подсказок OTO- 
бражаются в панели состояния, когда курсор мыши перемещается над тем или 
иным окном редактирования. Причем это не мешает появляться ярлычкам, ото- 
бражающим тексты окон. 

Более подробные пояснения пользователю может дать контекстно-зависимая 
справка, встроенная в приложение. Она позволяет пользователю нажать в любой 
момент клавишу F] и получить развернутую информацию о том компоненте в 
окне, который в данный момент находится в фокусе. Для того, чтобы это осущест- 
вить, надо разработать для своего приложения файл справки „Вер. Как это сде- 
лать, подробно описано в главе 8. Затем надо в компонентах, для которых вы хоти- 
те обеспечить контекстно-зависимую справку, установить в свойстве HelpContext 
номер контекстной справки, соответствующей данному компоненту. Если 
HelpContext компонента равен нулю, то данный компонент наследует это свойство 
от своего родительского компонента. Например, для всех компонентов, размещен- 
ных на некоторой панели можно задать HelpContext = 0, а для самой панели за- 
дать отличное от нуля значение HelpContext, соответствующее теме, описываю- 
щей назначение всех компонентов панели. 

Для того, чтобы все это работало, надо выполнить команду Project | Options и в 
окне Project Options (опции проекта) на странице Application (приложение) устано- 
вить значение опции Help Не, равное имени подготовленного файла .Шр. Это приве- 
дет к тому, что в головном файле проекта появится оператор вида: 


Application->HelpFile = "<имя файла>.51р"; 
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В этом операторе используется метод HelpFile, определяющий файл справки, 
к которому обращается проект. Этот метод и подобный оператор можно использо- 
вать в приложении в любом обработчике события, если в какие-то моменты требу- 
ется сменить используемый файл справки. 

Если предполагается, что файл справки будет расположен в том же каталоге, 
где находится само приложение; то имя файла и в окне Опции проекта, и в приве- 
денном выше операторе надо задавать без указания пути. Иначе приложение, ра- 
ботающее на вашем компьютере, перестанет работать на компьютере пользовате- 
ля, у которого каталоги не совпадают с вашими. 

Для того, чтобы приложение в свойствах HelpContext могло ссылаться Ha Ka- 
кой-то номер контекстной справки, в файле проекта справки „.Вр} в разделе [MAP] 
надо поместить таблицу соответствия использованных значений HelpContext и 
тем файла .Шр. Все необходимые для этого операции подробно рассмотрены в гла- 
ве 8. 

В заключение поговорим о традиционном разделе меню Справка, позволяю- 
щем пользователю открыть файл справки .hlp и получить развернутую информа- 
цию по всем вопросам, связанным с данным приложением. В обработчик события 
при выборе данного раздела меню или при нажатии соответствующих кнопок по- 
мощи вставляются операторы вида 


Application->HelpContext (<номер темы>); 


Задаваемые в этих операторах номера тем аналогичны используемым при за- 
дании свойств HelpContext. Это номер той темы, которая первой отобразится при 
открытии окна справки. А в дальнейшем пользователь, как обычно, может перей- 
ти, работая с программой справки, к любой интересующей его теме. 

Имеется еще несколько методов объекта Application, обеспечивающих работу 
со справочными файлами. Все они подробно рассмотрены в разделе 3.9.3. 

Еще один механизм подсказок, связанный с файлом справок „р — кнопка 
справки, присутствующая в заголовках многих современных окон Windows. На- 
жав ее, пользователь может подвести курсор мыши, изменивший свою форму на 
вопросительный знак, к какому-то компоненту, щелкнуть и во всплывшем окне 
появится развернутая подсказка, поясняющая назначение данного компонента. 
Для того, чтобы ввести такую возможность в свое приложение, надо установить в 
true подсвойство byHelp свойства BorderIcons вашей формы. Однако, не для всех 
форм это вызовет появление в заголовке окна кнопки справки. Кнопка появится 
только в случае, если свойство BorderStyle формы установлено в bsDialog. Ника- 
кого программирования работа с кнопкой справки не требует. Все будет выпол- 
няться автоматически. Достаточно предусмотреть в файле .Шр соответствующие 
темы и сделать на них ссылки в свойствах HelpContext компонентов. Эти темы бу- 
дут появляться ‘при соответствующих действиях пользователя во всплывающих 
окнах. 


4.2 Проектирование окон с изменяемыми 
размерами 


4.2.1 Выравнивание компонентов — свойство Align 


Если проектируется окно, размеры которого пользователь может изменять во 
время выполнения приложения, то необходимо принять меры, чтобы компоненты 
в окне при этом тоже изменяли свои размеры или местоположение, равномерно 
распределяясь по площади окна и не оставляя пустых мест. 

Пусть, например, вы проектируете форму, окно которой содержит панель 
Рапе!1, на которой будут размещаться какие-то управляющие компоненты и спи- 
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сок ListBoxl1, панель Panel2, в середине которой будет размещаться некоторая 
надпись в метке StaticTextl, и компонент Memol, в котором будут редактировать- 
ся тексты (рис. 4.5 а). Если, разместив все это на форме, вы не примете мер для того, 
чтобы при изменении размеров окна компоненты изменялись, то при том размере 
формы, который вы проектировали, все будет выглядеть нормально (рис. 4.5 а). Но 
если пользователь растянет размеры формы, надеясь увеличить площадь редактиро- 
вания и длину списка, то приложение приобретет нелепый вид, показанный на 
рис. 4.56. Увеличение формы просто приводит к увеличению на ней пустого места. 


Рис. 4.5 
Результаты 
изменения 
размеров окна при 
неправильном 
проектировании 


Чтобы избежать таких неприятностей, у многих компонентов и, в частности, у 
панелей, есть свойство Align — выравнивание. По умолчанию оно равно alNone, 
что означает, что никакое выравнивание не осуществляется. Но его можно задать 
равным alTop, или alBottom, или аШей, или alRight, что будет означать, что ком- 
понент должен занимать всю верхнюю, или нижнюю, или левую, или правую 
часть клиентской области компонента-контейнера. Под клиентской областью по- 
нимается вся свободная площадь формы или другого контейнера, в которой могут 
размещаться включенные в этот контейнер компоненты. Можно также задать 
свойству Align компонента значение alClient, что приводит к заполнению компо- 
нентом всей свободной клиентской области. Во всех этих случаях размеры компо- 
нента будут автоматически изменяться при изменении размеров контейнера. 

В приведенном выше примере логично для панели Рапе]2 задать значение 
Align, равным alTop, чтобы ширина панели автоматически менялась с изменени- 
ем ширины окна. Панель займет всю верхнюю часть формы, а ее высота будет та- 
кой, какую вы установите. Для панели Panell следует задать значение Align, рав- 
ным alLeft, так как увеличение ее ширины не имеет смысла, а увеличение высоты 
позволяет увидеть большую часть списка ListBox1. Компонент Рапе!1 займет всю 
левую часть клиентской области, оставшейся свободной после размещения Panel2. 
Для компонента Мето1 следует задать значение Align, равным alClient, что по- 
зволит компоненту увеличиваться и в высоту, и в ширину; увеличивая площадь 
редактирования. При этом компонент Memol займет всю площадь клиентской об- 
ласти, оставшуюся после размещения Panell и Panel2. В результате во время вы- 
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полнения при изменении пользователем размеров окна приложение будет иметь 
вид, представленный на рисунке 4.6. 

Задавать компонентам соответствующие значения свойства Align в приведен- 
ном примере надо именно в указанной выше последовательности: alTop для 
Panel2, alLeft для Panell, alClient для Memol. Если, например, начать с задания 
alClient для Мето1, то компонент Memol займет всю площадь формы и остальные 
компоненты вообще не будут видны. 

Значения свойства Align имеют определенный приоритет: значения а! Тор и 
alBottom имеют более высокий приоритет, чем значения alLeft и alRight. Поэто- 
му не любые варианты размещения и выравнивания панелей можно реализовать 
непосредственно. Например, пусть вы хотите создать форму, вид которой приведен 
на рис. 4.7 a. Причем вам надо, чтобы при изменении размеров окна панель Panell 
продолжала занимать всю левую часть формы (т.е. надо задать Align = alLeft), 
Panel3 занимала бы всю нижнюю часть площади, свободной от Panell (т.е. для 
Panel3 надо задать Align = а!Во вот), а Panel2 занимала бы всю оставшуюся часть 
клиентской области (т.е. для Panel2 надо задать Align = alClient). Напрямую все 
это сделать невозможно. Если вы задали для Panell значение alLeft, а затем для 
Рапе!3 задаете значение alBottom, то в силу приоритета alBottom панель Panel3d 
займет всю нижнюю часть формы, вытеснив оттуда Panell. 


Puc. 4.7 а) 6) 


Проектирование с 
учетом приоритетов 
значений Align 


В подобных случаях приходится вводить дополнительные панели-контейне- 
ры. В приведенном примере на форме сначала надо разместить Panell и дополни- 
тельную панель Panel4, как показано на рис. 4.7 6. Для Panell задается alLeft, a 
для Panel4 задается alClient. Затем панели Panel2 и Panel3 размещаются на 
Panel4 и для них задаются значения: alBottom для Panel3 (поскольку клиентской 
областью для Рапе!3 является область панели Panel4, то Panel3 займет нижнюю 
часть правой половины экрана) и значение alClient для Panel2. В результате полу- 
чим нужное выравнивание всех панелей. 


1 


4.2.2 Изменение местоположения и размеров компонентов 


Заданием значений Align задачу планировки окна с изменяющимися размера- 
ми еще нельзя считать решенной. Вернемся к ранее рассмотренному примеру. 
Рис. 4.6 показал, что в нем при изменении размеров окна метка StaticTextl, oc- 
тающаяся на месте, перестает быть в середине панели, а размер списка ListBox] не 
изменяется. 

Чтобы устранить эти недостатки, можно воспользоваться свойствами компо- 
нента, определяющими его привязку, местоположение и размеры. 

Оконные компоненты имеют свойство Anchors — привязку к родительскому 
компоненту при изменении размеров последнего. Это свойство представляет собой 
множество, которое может содержать следующие элементы: 
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akTop Верхний край компонента привязан к верхнему краю родитель- 
ского компонента 

akLeft Левый край компонента привязан к левому краю родительского 
компонента 

akRight Правый край компонента привязан к правому краю родительского 
компонента 


akBottom — Нижний край компонента привязан к нижнему краю родительско- 
го компонента 


Если в множестве Anchors присутствуют привязки к противоположным сторо- 
нам родительского компонента, то при изменении размеров родительского компо- 
нента происходит растяжение или сжатие дочернего компонента, поскольку рас- 
стояния от сторон родительского компонента выдерживаются. Сжатие может про- 
исходить вплоть до полного исчезновения изображения данного компонента. По- 
этому необходимо ограничивать диапазон допустимого изменения размеров. Спо- 
собы такого ограничения будут рассмотрены в разделе 4.2.4. 

По умолчанию привязка осуществляется к левому и верхнему краям роди- 
тельского компонента. Т.е. по умолчанию свойство Anchors равно [akLeft,akTop]. 
Если задать в свойстве Anchors привязку к противоположным сторонам родитель- 
ского компонента, то при изменении размеров родительского компонента будут 
меняться размеры и данного компонента. Если для списка ListBoxl в нашем при- 
мере задать свойство Anchors равным [akLeft,akTop,akBottom], то при изменении 
высоты панели, содержащей этот список, будут поддерживаться постоянными рас- 
стояния верхнего и нижнего краев списка соответственно от верхнего и нижнего 
краев панели. Таким образом, увеличивая высоту окна пользователь может увели- 
чивать число строк, видимых в списке без прокрутки. Если задать свойство 
Anchors равное [akLeft,akTop, akRight] для метки StaticTextl, то при изменении 
ширины содержащей ее панели будут поддерживаться постоянными расстояния 
левого и правого краев метки от соответствующих краев панели. Метка будет оста- 
ваться в центре панели, но ее размер будет изменяться. Вариант нашего примера с 
заданными описанным способом свойствами Anchors для ListBoxl1 и StaticTextl, 
приведен на рис. 4.8. Как видно из него, теперь приложение сохраняет нормаль- 
ный вид и при увеличении пользователем размеров окна. А в списке ListBoxl при 
увеличении размера даже исчезла полоса прокрутки, т.к. весь текст уместился на 
экране. 

Для того, чтобы это нормально работало, надо еще в обработчик события 
OnResize формы или панели, содержащей метку StaticTextl, вставить оператор 


StaticTextl->Repaint (); 
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Этот оператор обращается к методу Repaint, который перерисовывает метку. 
Если этого не сделать, то, как вы легко можете проверить, при изменении разме- 
ров окна в метке появится надпись на новом месте, но не исчезнет и прежняя над- 
пись, т.е. получится сдвоенная надпись, что, конечно, недопустимо. 


В приведенном примере неоправданно изменился размер метки StaticTextl. 
Такое поведение компонента не всегда желательно. В подобных случаях надо пере- 
ходить к программному изменению местоположения компонента. 

Местоположение компонента задается свойствами Left и Top, характеризую- 
щими координаты левого верхнего угла компонента. При этом началом координат 
считается левый верхний угол клиентской области компонента-контейнера. Гори- 
зонтальная координата отсчитывается вправо от этой точки, а вертикальная — 
вниз. 

Размеры компонента определяются свойствами Width — ширина и Height — 
высота. Есть еще одно свойство BoundsRect, характеризующее одновременно и ме- 
стоположение, и размеры компонента, но оно менее удобно и используется редко. 

Имеется еще два свойства, определяющие размер клиентской области компо- 
нента-контейнера: ClientWidth и ClientHeight. Для некоторых компонентов они 
совпадают со свойствами Width и Height. Но могут и отличаться от них. Напри- 
мер, в форме ClientHeight меньше, чем Height, за счет бордюра, полосы заголовка, 
меню и полосы горизонтальной прокрутки, если она имеется. 

Поскольку нам надо изменять местоположение и размеры компонентов при 
изменении размеров формы, то соответствующие операторы следует размещать в 
обработчиках событий OnResize формы или соответствующей панели. Эти события 
возникают при любом изменении пользователем размеров окна приложения или 
размеров панели. В нашем примере оператор обработки этих событий может иметь 
ВИД: 

StaticTextl->Left = Panel2->Left + 

(Panel2->ClientWidth — StaticTextl->Width) / 2; 


Этот оператор сдвигает левый край компонента StaticTextl так, чтобы метка 
всегда размещалась в середине панели Panel2. Только чтобы это нормально рабо- 
тало, над убрать привязку метки к правому краю панели, которая была введена 
нами ранее. Иначе размер метки все-таки будет меняться. 


4.2.3 Панели с перестраиваемыми границами 


В ряде случаев описанного автоматического изменения размеров различных 
панелей оказывается недостаточно для создания удобного пространства для дейст- 
вий пользователя. Даже при увеличении окна на весь экран какая-то панель при- 
ложения может оказаться перегруженной информацией, а другая относительно 
пустой. В этих случаях полезно предоставить пользователю возможность переме- 
щать границы, разделяющие различные панели, изменяя их относительные разме- 
ры. Пример такой возможности можно увидеть в программе Windows «Провод- 
ник». 

В библиотеке C++Builder 5 на странице Additional имеется специальный компо- 
нент — Splitter, который позволяет легко осуществить это. При работе с ним надо 
соблюдать определенную последовательность проектирования. Если вы хотите ус- 
тановить Splitter между двумя панелями, первая из которых будет выровнена к 
какому-то краю клиентской области, а вторая займет всю клиентскую область, то 
сначала надо выровнять первую панель, например, влево. Затем надо перенести на 
форму Splitter и выровнять его в Ty же сторону (тоже влево). Splitter прижмется к 
соответствующему краю первой панели. После этого можно задать выравнивание 
второй панели на всю оставшуюся площадь клиентской области. В результате 
Splitter окажется зажатым между двумя панелями и при запуске приложения OH | 
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позволит пользователю изменять положение соответствующей границы между 
этими панелями. 

Подобные разделители Splitter можно разместить между всеми панелями 
приложения, дав пользователю полную свободу изменять топологию окна, с кото- 
рым он работает. 

Компонент Splitter имеет событие OnMoved, которое наступает после конца 
перемещения границы. В обработчике этого события надо предусмотреть, если не- 
обходимо, упорядочение размещения компонентов на панелях, размеры которых 
изменились: переместить какие-то метки, изменить размеры компонентов и т.д. 

Свойство ResizeStyle компонента Splitter определяет поведение разделителя 
при перемещении его пользователем. Поэкспериментируйте с ним, чтобы увидеть 
различие в режимах перемещения разделителя. По умолчанию свойство Splitter 
равно rsPattern. Это означает, что пока пользователь тянет курсором мыши грани- 
цу, сам разделитель не перемещается и панели тоже остаются прежних размеров. 
Перемещается только шаблон линии, указывая место намечаемого перемещения 
границы. Лишь после того, как пользователь отпустит кнопку мыши, разделитель 
переместится и панели изменят свои размеры. Практически такая же картина на- 
блюдается, если установить ResizeStyle = rsLine. При ResizeStyle = rsUpdate в 
процессе перетаскивания границы пользователем разделитель тоже перемещается 
и размеры панелей все время меняются. Это, может быть, удобно, если пользова- 
тель хочет установить размер панели таким, чтобы на ней была видна какая-то 
конкретная область. Но так как процесс перетаскивания в этом случае сопровож- 
дается постоянной перерисовкой панелей, наблюдается неприятное мерцание изо- 
бражения. Так что этот режим можно рекомендовать только в очень редких случа- 
ях. Если установить ResizeStyle = rsNone, то в процессе перетаскивания границы 
не перемещается ни сама граница, ни изображающая ее линия. Вряд ли это удобно 
пользователю, так что я не могу представить случая, когда было бы выгодно ис- 
пользовать этот режим. 

Свойство MinSize компонента Splitter устанавливает минимальный размер в 
пикселях обеих панелей, между которыми зажат разделитель. Задание такого ми- 
зимального размера необходимо, чтобы при перемещениях границы панель не 
сжалась бы до нулевого размера или до такой величины, при которой на ней исчез- 
ли бы какие-то необходимые для работы элементы управления. К сожалению, в 
версиях C++Builder, младше C++Builder 5, свойство MinSize не всегда срабатыва- 
ет верно. В C++Builder 5 введено новое свойство компонента Splitter — AutoSnap. 
Если оно установлено в true (по умолчанию), TO при перемещении границы воз- 
можны те же неприятности, что в младших версиях C++Builder. Но если устано- 
вить AutoSnap в true, то перемещение границы панелей сверх пределов, при кото- 
рых размер одной из панелей станет меньше MinSize, просто блокируется. Так что 
можно рекомендовать всегда устанавливать AutoSnap в true. 

Впрочем, и это не решает всех задач, связанных с перемещением границ пане- 
лей. Дело в том, что свойство MinSize относится к обеим панелям, граница между 
которыми перемещается, а в ряде случаев желательно раздельно установить раз- 
личные минимальные размеры одной и другой панели. Это проще сделать, задав в 
панелях соответствующие значения свойства Constraints, о котором будет расска- 
зано в следующем разделе. 


4.2.4 Ограничение пределов изменения размеров окон 
и компонентов 


Все рассмотренные ранее методы изменения размеров панелей и компонентов 
на них имеют общий недостаток: при чрезмерном уменьшении пользователем раз- 
меров окна какие-то компоненты могут исчезать из поля зрения. Иногда к некра- 
сивым с точки зрения эстетики результатам приводит и чрезмерное увеличение 


Проектирование графического интерфейса пользователя 265 


размеров окна. Хотелось бы иметь средства, ограничивающие пользователя в его 
манипуляциях с окном и не позволяющие ему чрезмерно уменьшать и увеличи- 
вать размеры. 

Таикм средством является свойство Constraints, присущее всем компонентам 
и позволяющее задавать ограничения на допустимые изменения размеров. Свойст- 
во имеет четыре основных подсвойства: MaxHeight, MaxWidth, МшНе и 
Min УВ — соответственно максимальная высота и ширина и минимальная вы- 
сота и ширина. По умолчанию значения всех этих подсвойств равны 0, что означа- 
ет отсутствие ограничений. Но задание любому из этих свойств положительного 
значения приводит к соответствующему ограничению размера заданным числом 
пикселей. 

Чтобы какие-то компоненты не исчезали из поля зрения, можно задать им ог- 
раничения минимальной высоты и длины. Таким образом можно поддерживать 
нормальные пропорции отдельных частей окна. Можно задать ограничения на ми- 
нимальные и максимальные размеры формы, т.е. всего окна. Например, если вы 
зададите для формы значения MaxHeight = 500 и MaxWidth = 500, то пользова- 
тель не сможет сделать окно большим, чем квадрат 500 x 500. Причем это ограни- 
чение будет действовать даже если пользователь нажмет системную кнопку, разво- 
рачивающую окно на весь экран. Окно развернется, но его размеры не превысят за- 
данных. Это иногда полезно делать, чтобы развернутое окно не заслонило какие-то 
другие нужные пользователю окна. 


4.2.5 Масштабирование компонентов 


Говоря о размерах компонентов следует упомянуть еще об одной возможности 
их изменения — о методе ScaleBy. Он определен как: 


void _fastcall ScaleBy(int М, int 0); 


где М и О — множитель и делитель, определяющие изменение масштаба компо- 
нента. Масштабируются такие свойства компонента, как Width и Height, опреде- 
ляющие его размер. Свойства Тор и Left остаются неизменными. Масштабируется 
также размер шрифта, если только в компоненте не установлено ParentFon = true. 
В последнем случае шрифт наследуется от родительского компонента и поэтому не 
изменяется. 

Если компонент является контейнером, содержащим другие компоненты, то 
его дочерние компоненты также масштабируются. Причем у них изменяются не 
только Width и Height, но также пропорционально изменяются Тор и Left, опре- 
деляющие их местоположение. Если во всех дочерних компонентах установлено 
ParentFont = true, а в компоненте-контейнере ParentFont = false, то пропорцио- 
нально изменяются и шрифты всех компонентов (но, конечно, не непрерывно, a 
скачками, доступными тому или иному типу шрифта). 

Параметры М и О определяют соответственно множитель и делитель масшта- 
ба. Например, чтобы уменьшить размеры на 10% от начального значения, можно 
задать М равным 9, а О равным 10 (9/10). Если же вы хотите увеличить размер на 
1/3, то можно задать М=133 и D=100 (133/100) или М=4 и О=3 (4/3). 

Приведем примеры. Оператор 


Editl->ScaleBy (11,10); 


масштабирует окно редактирования Editl. В любом случае при выполнении этого 
оператора длина окна (свойство Width) увеличивается на 10%, что обеспечивает 
возможность наблюдать и редактировать в нем более длинный текст. Высота окна 
(свойство Height) будет изменяться пропорционально, только если свойство ком- 
понента AutoSize равно false. В противном случае высота определяется только 
размером шрифта и при постоянном шрифте будет неизменной. А размер шрифта 
будет меняться, только если свойство компонента ParentFont равно false, т.к. ина- 
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че шрифт определяется родительским компонентом. Таким образом. при AutoSize 
= true и ParentFont = true изменяется только длина окна редактирования. 
Оператор 


Рапе11->5са1еВу (11,10); 


увеличивает размер панели, а также координаты и размер всех ее компонентов. 
Если в панели ParentFont = false, то шрифты во всех компонентах также увеличи- 
ваются независимо от значений их свойства ParentFont. Причем они увеличива- 
ются и в неоконных компонентах, например, в метках. Если же в панели Parent- 
Font = true, то шрифты увеличиваются только в компонентах, в которых Parent- 
Font = false. | 

Приведенный выше оператор изменяет масштаб сразу группы компонентов, 
но при этом сдвигает их позиции, поскольку действует на свойства Тор и Left. 
Можно избежать этого, обращаясь по отдельности к каждому дочернему оконному 
компоненту панели с помощью, например, такого оператора: 

for (int i= 0; i < Panell->ControlCount; i++) 


if (Panell->Controls[i])->InheritsFrom( .classid(TWinControl) ) ) 
((TWinControl *) Panell->Controls[i])->ScaleBy (11,10); 


При этом надо иметь в виду, что непосредственно применять ScaleBy можно 
только к оконным компонентам, являющимся наследниками класса TWinControl. 
Поэтому в приведенном операторе сначала проверяется, является ли компонент 
наследником TWinControl. Для этого к компоненту применяется функция 
InheritsFrom, возвращающая true, если класс объекта наследует классу, переда- 
ваемому в функцию как параметр. В данном случае в качестве параметра в функ- 
цию передается класс TWinControl, который преобразуется в нужную форму с по- 
мощью ключевого слова __Classid. 

Если установлено, что компонент является оконным (его класс наследует 
TWinControl), то к нему применяется функция ScaleBy, для чего используется яв- 
ное приведение его типа к TWinControl: (TWinControl *). 

Приведенный код масштабирует только оконные компоненты. Неоконные 
компоненты, например, метки, масштабироваться не будут. 

Подробнее функции и подходы, использованные в приведенном коде, рассмот- 
рены в главе 1 в разделе 1.6.6.2. 


4.3 Обработка событий клавиатуры и мыши 


Все действия пользователя при взаимодействии с приложением сводятся к пе- 
ремещению мыши, нажатию кнопок мыши и нажатию клавиш клавиатуры. Рас- 
смотрим обработку в приложении событий, связанных с этими манипуляциями 
пользователя. 


4.3.1 События мыши 


4.3.1.1 Последовательность событий 


В компонентах C++Builder определен ряд событий, связанных с мышью. Это 
события: 


Событие 


OnClick Щелчок мыши на компоненте и некоторые другие действия 
пользователя. 


OnDbIClick Двойной щелчок мыши на компоненте. 
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OnMouseDown Нажатие клавиши мыши над компонентом. Возможно распо- 


знавание нажатой кнопки и координат курсора мыши. 


OnMouseMove —Перемещении курсора мыши над компонентом. Возможно 


распознавание нажатой кнопки и координат курсора мыши. 


OnMouseUp Отпускание ранее нажатой кнопки мыши над компонентом. 
Возможно распознавание нажатой кнопки и координат курсо- 
ра мыши. 

OnStartDrag Начало процесса «перетаскивания» объекта. Возможно распо- 


знавание перетаскиваемого объекта. 


OnDragOver Перемещение «перетаскиваемого» объекта над компонентом. 


Возможно распознавание перетаскиваемого объекта и коорди- 
нат курсора мыши. 


OnDragDrop Отпускание ранее нажатой кнопки мыши после «перетаскива- 


ния» объекта. Возможно распознавание перетаскиваемого 
объекта и координат курсора мыши. 


OnEndDrag Еще одно событие при отпускании ранее нажатой кнопки 


мыши после «перетаскивания» объекта. Возможно распозна- 
вание перетаскиваемого объекта и координат курсора мыши. 


ОпЕщег Событие в момент получения элементом фокуса в результате 


манипуляции мышью, нажатия клавиши табуляции или про- 
граммной передачи фокуса. 


OnExit Событие в момент потери элементом фокуса в результате Ma- 


нипуляции мышью, нажатия клавиши табуляции или про- 
граммной передачи фокуса. 


ай 


Как видно из приведенной таблицы, эти события охватывают все мыслимые 


манипуляции с мышью и даже дублируют многие из них. Наиболее широко ис- 
пользуется событие OnClick. Обычно оно наступает, если пользователь щелкнул на 
компоненте, т.е. нажал и отпустил кнопку мыши, когда указатель мыши находил- 
ся на компоненте. Но это событие происходит также и при некоторых других дей- 
ствиях пользователя. Оно наступает, если: 


Пользователь выбрал элемент в сетке, дереве, списке, выпадающем списке, 
нажав клавишу со стрелкой. 


Пользователь нажал клавишу пробела, когда кнопка или индикатор были в 
фокусе. 


Пользователь нажал клавишу Enter, а активная форма имеет кнопку по умол- 
чанию, указанную свойством Default. 


Пользователь нажал клавишу Esc, а активная форма имеет кнопку прерыва- 
ния, указанную свойством Cancel. 


Пользователь нажал клавиши быстрого доступа к кнопке или индикатору. На- 
пример, если свойство Caption индикатора записано как «&Полужирный» и 
символ II’ подчеркнут, то нажатие пользователем комбинации клавиш А!+П 
вызовет событие OnClick в этом индикаторе. 


Приложение установило в true свойство Checked радиокнопки RadioButton. 
Приложение изменило свойство Checked индикатора CheckBox. 

Вызван метод Click элемента меню. 

Для формы событие OnClick наступает, если пользователь щелкнул на пустом 


месте формы или на недоступном компоненте. 
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Обилие событий, связанных с мышью, а также фактическое дублирование не- 
которых из них требуют четкого представления о последовательности отдельных 
событий, наступающих при том или ином действии пользователя. Рассмотрим эти 
последовательности. 

В момент запуска приложения из рассматриваемых нами событий наступает 
только событие ОпЕщег в компоненте, на который передается фокус. Это событие 
не связано с какими-то действиями пользователя, так что не будем на нем останав- 
ливаться. 

Теперь рассмотрим простейшее действие пользователя: переключение с помо- 
щью мыши фокуса с одного элемента на другой. Последовательность событий в 
этом случае приведена в таблице 4.1. 


Таблица 4.1. Последовательность событий мыши при переключении фокуса 


Действие пользователя Событие 


| Перемещение курсора мыши в преде- Множество событий OnMouseMove в 
| лах первого компонента первом компоненте 


| 
| 
| Перемещение курсора мыши в преде- Множество событий OnMouseMove в 
| лах формы форме | 
Перемещение курсора мыши в преде- Множество событий OnMouseMove во | 
| лах второго компонента втором компоненте 
| 

| 

| 

| 


| Нажатие кнопки мыши OnExit в первом компоненте 
| OnEnter во втором компоненте 


OnMouseDown во втором компоненте 


| Отпускание кнопки мыши OnClick во втором компоненте | 
а OnMouseUp во втором компоненте __| 


События OnMouseMove происходят постоянно в процессе перемещения курсо- 
ра мыши и даже просто при его дрожании, неизбежном, если пользователь не сни- 
мает руки с мыши. Это надо учитывать и пользоваться этим событием очень осто- 
рожно, поскольку оно, в отличие от других, происходит многократно. 

Как видно из приведенной таблицы, каждое действие пользователя, связанное 
с нажатием или отпусканием кнопки мыши приводит к серии последовательно на- 
ступающих событий. В обработчиках событий OnMouseDown и OnMouseUp можно 
распознать, какая кнопка мыши нажата и в какой точке компонента находится в 
данный момент курсор мыши. 

Рассмотренная в таблице 4.1 последовательность событий имеет место, если во 
втором компоненте свойство DragMode (см. раздел 4.4) равно dmManual (ручное 
начало процесса перетаскивания), как это установлено по умолчанию. Если же это 
свойство равно dmAutomatic (автоматическое начало процесса перетаскивания), 
то все рассмотренные события, связанные с манипуляцией мышью, заменяются 
следующими: 


OnMouseDown Заменяется на OnStartDrag 


OnMouseMove Заменяется Ha событие OnDragOver того компонента, над 
которым перемещается курсор мыши 


OnMouseUp Заменяется Ha событие OnDragDrop компонента, над KOTO- 
рым завешается перетаскивание (если компонент может вос- 
принять информацию от перетаскиваемого объекта), и по- 
следующее событие OnEndDrag компонента, который пере- 
таскивался | 
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События OnExit и OnEnter вообще не возникают, поскольку переключения 
фокуса не происходит. Не наступает также событие OnClick. 

В дальнейшем в данном разделе события, связанные с перетаскиванием, рас- 
сматриваться не будут. Подробное описание этих событий см. в разделе 4.4. 

Если в примере, приведенном в таблице 4.1, щелчок делается на объекте, ко- 
торый уже находится в этот момент в фокусе, то не происходят события OnExit и 
OnEnter. В этом случае при нажатии кнопки наступает только событие 
OnMouseDown, а при отпускании кнопки — события OnClick и OnMouseUp. 

Теперь рассмотрим последовательность событий при двойном щелчке на ком- 
поненте. Она приведена в таблице 4.2. Распознавать нажатую кнопку мыши 
по-прежнему можно только в событиях OnMouseDown и OnMouseUp. Если же 
надо распознать именно двойной щелчок какой-то определенной кнопкой мыши, 
то можно, например, ввести некую переменную, являющуюся флагом двойного 
щелчка, устанавливать этот флаг в обработчике события OnDbIClick, а в обработ- 
чиках событий OnMouseDown или OnMouseUp проверять этот флаг и, если он ус- 
тановлен, то сбрасывать его и выполнять запланированные действия. 


Таблица 4.2. Последовательность событий мыши при двойном щелчке на 
компоненте 


OnMouseDown. Возможно распознавание 
нажатой кнопки и координат курсора 
мыши 


OnClick 
OnMouseUp. Возможно распознавание Ha- 


жатой кнопки и координат курсора мыши 


ОпрЫсСПсКк | 
OnMouseDown. Возможно распознавание на- 
жатой кнопки и координат курсора мыши 


4.3.1.2 Распознавание источника события, нажатых кнопок и клавиш, 
координат курсора 


Во все обработчики событий, связанных с манипуляциями мыши (как и во все 
другие обработчики) передается параметр Sender типа указателя на TObject. Этот 
параметр содержит указатель на компонент, в котором произошло событие. Он не 
требуется, если пишется обработчик события для одного конкретного компонента. 
Однако часто один обработчик применяется для нескольких компонентов. При 
этом какие-то операции могут быть общими для любых источников события, а ка- 
кие-то требовать специфических действий. Тогда Sender можно использовать для 
распознания источника события. Правда, поскольку тип TObject не имеет ника- 
ких полезных для пользователя свойств и методов, то объект Sender следует рас- 
сматривать как объект одного из производных от TObject типов. 

Операции, связанные с обработкой параметра Sender, подробно рассмотрены в 
главе 1 в разделе 1.6.6.2. Там показано, как можно распознать объект, на который 
указывает Sender, по имени, узнать его класс, определить, является ли этот класс 
наследником какого-то другого определенного класса. 

Помимо параметра Sender в обработчики событий GubionacDiwn u OnMouse- 
Up передаются параметры, позволяющие распознать нажатую кнопку, нажатые 
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при этом вспомогательные клавиши, а также определить координаты курсора 
мыши. Заголовок обработчика события OnMouseDown или OnMouseUp может 
иметь, например, следующий вид: 


void _fastcall TForml::Edit1lMouseDown (TObject *Sender, 
TMouseButton Button, TShiftState Shift, int X, int У) 


Помимо уже рассмотренного нами параметра Sender в обработчик передаются 
параметры Button, Shift, X и У. 

Параметр Button типа TMouseButton определяет нажатую в этот момент 
кнопку мыши. Tun TMouseButton — перечислимый тип, определяемый следую- 
щим образом: 

} 


enum TMouseButton { mbLeft, mbRight, mbMiddle }; 


Значение mbLeft соответствует нажатию левой кнопки мыши, значение 
mbRight — правой, а значение mbMiddle — средней. Например, если вы хотите, 
чтобы обработчик реагировал на нажатие только левой кнопки, вы можете его пер- 
вым оператором написать: 


if (Button != mbLeft) return; 


Torga, если значение Button не равно mbLeft, т.е. нажата He левая кнопка, 
выполнение обработчика прервется. 

Параметр Shift типа TShiftState определяет, какие вспомогательные клави- 
ши на клавиатуре нажаты в момент нажатия кнопки мыши. Тип TShiftState — 
множество, определенное следующим образом: 

enum Classes 1 { ssShift, ssAlt, ssCtrl, ssLeft, ssRight, 


ssMiddle, ssDouble }; 
typedef Set<Classes 1, ssShift, ssDouble> TShiftState; 


Элементы этого множества соответствуют нажатию клавиш Shift (ssShift), Alt 
(ssAlt), Ctrl (ssCtrl), а также кнопок: левой (ssLeft), правой (ssRight), средней 
(ssMiddle). Информация о нажатых кнопках в параметрах Button и Shift имеет 
различный смысл. Параметр Button соответствует кнопке, нажимаемой в данный 
момент, а параметр Shift содержит информацию о том, какие кнопки были нажа- 
ты, включая и Te, которые были нажаты ранее. Например, если пользователь на- 
жмет левую кнопку мыши, а затем, не отпуская ее, нажмет правую, то после пер- 
вого нажатия множество Shift будет равно [ssLeft], а после второго — [ssLeft, 
ssRight]. Если до этого пользователь нажал и не отпустил какие-то вспомогатель- 
ные клавиши, то информация о них также будет присутствовать в множестве 
Shift. 

Поскольку Shift является множеством, проверять наличие в нем TeX или 
иных элементов надо методом Contains (см. раздел 13.6 в главе 13). Например, 
если вы хотите прореагировать на событие, заключающееся в нажатии левой кноп- 
ки мыши при нажатой клавише Alt, можно использовать оператор: 


if. ((Button == mbLeft) && (Shift.Contains(ssAlt) ) ) 


В приведенной структуре if первое условие (Button == mbLeft) можно заме- 
нить эквивалентным ему условием, проверяющим параметр Shift: 


if (Shift.Contains(ssLeft) && (Shift.Contains(ssAlt) )) 


Аналогичные параметры Button и Shift передаются и в обработчик события 
OnMouseUp. Отличие только в том, что параметр Button соответствует не нажи- 
‚маемой в данный момент, а отпускаемой кнопке. Параметр Shift передается также 
в обработчик события OnMouseMove, так что и в этом обработчике можно опреде- 
лить, какие клавиши и кнопки нажаты. 
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Во все события, связанные с мышью, передаются также координаты курсора 
Xu Y. Эти параметры определяют координаты курсора в клиентской области ком- 
понента. Благодаря этому можно обеспечить различную реакцию в зависимости от 
того, в какой части клиентской области расположен курсор. 


4.3.2 События клавиатуры 


4.3.2.1 Последовательность событий 


В оконных компонентах C++Builder определены три события, связанные с 
клавиатурой. Это события: 


OnKeyDown Событие наступает при нажатии пользователем любой клави- 
| ши. Можно распознать нажатые клавиши, включая функцио- 
нальные, и кнопки мыши, но нельзя распознать символ нажа- 


той клавиши 


OnKeyPress Событие наступает при нажатии пользователем клавиши сим- 
вола. Можно распознать только нажатую клавишу символа, 
различить символ в верхнем и нижнем регистре, различить 
символы кириллицы и латинские, но нельзя распознать функ- 


циональные клавиши и кнопки 


OnKeyUp Событие наступает при отпускании пользователем любой кла- 
виши. Можно распознать нажатые клавиши, включая функци- 
ональные, и кнопки мыши, но нельзя распознать символ отпу- 


скаемой клавиши 


Кроме того, при нажатии пользователем клавиши табуляции фокус может пе- 
реключаться с элемента на элемент, что вызывает описанные в разделе 4.3.1.1 со- 
бытия OnEnter и OnExit. 

Важно четко представлять последовательность событий, происходящих при 
нажатии пользователем клавиши или комбинации клавиш. Пусть, например, 
пользователь нажал клавишу ЭВ (перевел ввод в верхний регистр), а затем нажал 
клавишу символа 'н’. Последовательность событий для этого случая приведена в 
таблице 4.3. В таблице указано, что именно можно распознать при каждом собы- 
тии. Подробнее это будет рассмотрено ниже, а пока отметим, что различить символ 
в верхнем и нижнем регистрах и различить латинский символ и символ кирилли- 
цы можно только в обработчике события OnKeyPress. Действительно, хотя в собы- 
тии OnKeyDown при нажатии клавиши 'н’можно определить, что при этом одно- 
временно нажата и клавиша Shift, этого еще мало, чтобы утверждать, что символ 
относится к верхнему регистру. Ведь если перед этим была включена клавиша 
CapsLock, то при нажатой клавише 5В! символ окажется в нижнем регистре. А ин- 
формация о том, включена или выключена клавиша CapsLock, в обработчик собы- 
тия OnKeyDown не передается. 
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Таблица 4.3. Последовательность событий клавиатуры при нажатии 
клавиш Shift-H 


ое PRS PR RR a EE осень Ире MSR < I PRT ЗО РС ИЗ 
| Действие пользователя |Событие | 


| Нажатие клавиши Shift OnKeyDown. Возможно распознавание нажатой кла- 
виши Shift 


| Нажатие клавиши «H» OnKeyDown. Возможно распознавание нажатой кла- 

| виши Shift, нажатой клавиши «H», HO отличить Bep- 
хний регистр OT нижнего и латинский символ OT 
русского невозможно 


OnKeyPress. Возможно распознавание символа с 
учетом регистра и языка, но невозможно распозна- 
вание нажатой клавиши Shift 


| Отпускание клавиши «H» |ОпКеуОр. Возможно распознавание нажатой клави- 

| ши Shift, отпущенной клавиши «н», но отличить | 
верхний регистр от нижнего и латинский символ OT 
русского невозможно 


| Отпускание клавиши Shift |OnKeyUp. Возможно распознавание отпущенной 
| клавиши Shift 


Следует отметить, что событие OnKeyPress заведомо наступает, если нажима- 
ется только клавиша символа или клавиша символа при нажатой клавише Shift. 
Если же клавиша символа нажимается одновременно с какой-то из вспомогатель- 
ных клавиш, то событие OnKeyPress может не наступить (произойдут только со- 
бытия OnKeyDown при нажатии и OnKeyUp при отпускании) или, если и насту- 
пит, то укажет на неверный символ. Например, при нажатой клавише Alt событие 
OnKeyPress при нажатии символьной клавиши не наступает. А при нажатой кла- 
више СШ событие OnKeyPress при нажатии символьной клавиши наступает, HO 
символ не распознается. 

В заключение надо остановиться на вопросе, куда поступают события клавиа- 
туры. У формы имеется свойство KeyPreview. Оно влияет на обработку событий, 
поступающих от клавиатуры (в число этих событий не входит нажатие клавиш со 
стрелками, клавиш табуляции и т.п.). По умолчанию свойство KeyPreview равно 
false и события клавиатуры поступают на обработчики, предусмотренные в актив- 
ном в данный момент компоненте. Но если задать значение KeyPreview равным 
true, то сначала эти события будут поступать на обработчики формы, если таковые 
предусмотрены, и только потом поступят на обработчики активного компонента. 

Имеется также событие OnShortCut приложения (Application), которое воз- 
никает при нажатии пользователем клавиши. Событие возникает до того, как воз- 
никло стандартное событие OnKeyDown компонента или формы. Это событие, как 
и все события приложенния, перехватывает введенный в C++Builder 5 компонент 
ApplicationEvents. Обработчик этого события позволяет предусмотреть нестан- 
дартную реакцию на нажатие какой-то клавиши. В него передается параметр сооб- 
щения Windows Msg, поле CharCode которого (Msg.CharCode) содержит виртуаль- 
ный код нажатой клавиши. Передается также по ссылке параметр Handled. Если 
задать ему значение true, то стандартные события OnKeyDown, ОпКеуРгез$, 
ОпКеу Ор не наступят. В разделе 3.9.3 приведен пример использования обработчи- 
ка события OnShortCut. 
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4.3.2.2 Распознавание нажатых клавиш 


Заголовок обработчика события OnKeyDown может иметь, например, следую- 
щий вид: 
void _fastcall TForml::EditlKeyDown(TObject *Sender, 
| WORD &Key, TShiftState Shift) 


Параметр Sender, указывающий на источник события, уже обсуждался выше 
при описании событий мыши (см. раздел 4.3.1.2). Там же рассматривался и пара- 
метр Shift, представляющий собой множество элементов, отражающих нажатые в 
это время функциональные клавиши. Только в обработчике события OnKeyDown 
множество возможных элементов параметра Shift сокращено до ssShift (нажата 
клавиша Shift), ssAlt (нажата клавиша А!) и ssCtrl (нажата клавиша Ctrl). Инфор- 
мация о нажатых кнопках мыши отсутствует. 

Основной параметр, которого не было раньше — это параметр Кеу. Обратите 
внимание, что он передается по ссылке, т.е. может изменяться в обработчике собы- 
тия. Кроме того, обратите внимание, что это целое число, а не символ. 

Параметр Кеу определяет нажатую в момент события клавишу клавиатуры. 
Для не алфавитно-цифровых клавиш используются виртуальные коды API 
Windows. Полная таблица этих кодов приведена в справочной части книги в главе 
15 в разделе 15.1.1. Ниже в таблице 4.4 приведены для дальнейшего обсуждения 
только несколько строк из нее, соответствующих наиболее распространенным кла- 
вишам. 


Таблица 4.4. Некоторые коды клавиш 


Десятичное | Шестнадцатерич- | Символическое Сравнение по 
число ное числ имя символу 


Клавиша 


Параметр Кеу является целым числом, определяющим клавищу, а не символ. 
Например, один и тот же код соответствует прописному и строчному символам «У» 
и «у». Если, как это обычно бывает, в.русской клавиатуре этой клавише соответст- 
вуют символы кириллицы «Н» и «н», то их код будет тем же самым. Различить про- 
писные и строчные символы или символы латинские и кириллицы невозможно. 

Проверять нажатую клавишу можно, сравнивая Кеу с целым десятичным ко- 
дом клавиши, приведенном во втором столбце таблицы 4.4. Например, реакцию на 
нажатие пользователем клавиши Enter можно оформить оператором: 


if (Key == 13) ... ; 
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` Можно сравнивать Key uc шестнадцатеричным эквивалентом кода, приведен- 
ным в третьем столбце таблицы 4.4. Например, приведенный выше оператор мож- 
но записать в виде: 


if (Key == 0х0) ... ; 


Для клавиш, которым не соответствуют символы, введены также именован- 
ные константы, которые облегчают написание программы, поскольку не требуют 
помнить численные коды клавиш. Например, приведенный выше оператор можно 
записать в виде: 


if (Key == VK RETURN) ... ; 


Для клавиш символов и цифр можно производить проверку сравнением с де- 
сятичным или шестнадцатеричным кодом, но это не очень удобно, так как трудно 
помнить коды различных символов. Другой путь — воспользоваться тем, что коды 
латинских символов в верхнем регистре совпадают с виртуальными кодами, ис- 
пользуемыми в параметре Кеу. Поэтому, например, если вы хотите распознать 
клавишу, соответствующую символу «У», вы можете написать: 


АТИ чм ПУ’) ен. { 


В этом операторе можно использовать только латинские символы в верхнем 
регистре. Если вы напишете ‘у’или захотите написать русские символы, соответ- 
ствующие этой клавише — ‘H' uuu ‘'н', то оператор на сработает. 

‚Помните также, что оператор будет действовать на все символы, относящиеся 
к указанной клавише: «У», «у», «Н» и «н». Иногда это хорошо, а иногда плохо. 
Например, если вы задали пользователю какой-то вопрос, на который он должен 
ответить У (да) или М (нет), то подобный оператор избавляет пользователя от необ- 
ходимости следить, в каком регистре он вводит символ и какой язык — англий- 
ский или русский включен в данный момент. Ему достаточно просто нажать кла- 
вищшу, на которой написано «У». Однако, если пользователь более привык к симво- 
лам кириллицы, то могут возникнуть неприятности, поскольку нажимая клавишу 
с латинской буквой «У» и русской буквой «Н» он может думать, что отвечает не 
положительно (Уез — да), а отрицательно (Нет). 

Приведем еще один пример — автоматическую передачу фокуса очередному 
оконному компоненту при нажатии пользователем клавиши Enter. Это можно сде- 
лать, включив в общий обработчик событий OnKeyDown всех оконных компонен- 
тов оператор: 

if (Key == VK_RETURN) 

FindNextControl((TWinControl *)Sender, true, true, 
false) ->SetFocus (); 


Этот оператор с помощью метода FindNextControl ищет очередной компонент 
в последовательности табуляции и передает ему фокус. Подробнее этот пример и 
метод FindNextControl рассмотрен в разделе 4.1.8. 

В заключение приведем пример распознавания комбинации клавиш. Пусть вы 
хотите, например, распознать комбинацию Alt-X. Для этого вы можете написать 
оператор: 

if((Key == 'Х') && Shift.Contains(ssAlt)) ... ; 


Мы рассмотрели распознавание клавиш при событии OnKeyDown. Заголовок 
обработчика события ОпКеуОр имеет такой же вид, так что все сказанное в равной 
степени относится и к событиям при отпускании клавиш. 


Теперь перейдем к рассмотрению события OnKeyPress. Заголовок обработчи- 
ка этого события имеет вид: 


void _fastcall TForml::EditlKeyPress(TObject *Sender, 
char &Key) 
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В этот обработчик, Kak и вописанные выше, передается параметр Key, опреде- 
ляющий нажатую клавишу символа. Но обратите внимание, что тип этого пара- 
метра не целое число, как в предыдущих случаях, a char — символ, В данном слу- 
чае в обработчик передается не виртуальный код клавиши, а символ, по которому 
можно определить, прописная это буква, или строчная, русская, или латинская. 
Поэтому описанных выше сложностей с распознаванием символов не возникает. 

Пусть, например, вы задали пользователю вопрос, на который он должен отве- 
тить символами «Д» или «д» (да), или символами «Н» или «н» (нет). Тогда распо- 
знать положительный ответ в обработчике события OnKeyPress можно оператором: 


if ((Key == "Д') Ч р (Key ==: 'д'))... 


Приведенный оператор реагирует только на положительный ответ пользовате- 
ля, не реагируя на отрицательный или ошибочный ответ. Реакцию на все возмож- 
ные ответы обеспечивает структура множественного выбора switch (см. раз- 
дел 12.8.1.2 в главе 12): 


Switch (Key) 
{ 


ease ‘д’ 

т: eke А. 
break; 

case 'Н': 

case ‘ноты 
break; 


default: Beep(); 
} 


Здесь предусмотрена реакция на положительный и отрицательный ответ, а 
также звуковой сигнал при ошибочном ответе. 

Посмотрев на приведенный ранее заголовок обработчика, вы можете увидеть, 
что параметр Кеу передается по ссылке. Это позволяет в обработчике изменять 
Key, изменяя соответственно его стандартную обработку в компоненте, поскольку 
ваш обработчик события срабатывает раньше стандартного обработчика компонен- 
та. Пусть, например, вы хотите иметь на форме окно редактирования ЕЧИТ, в ко- 
тором пользователь должен вводить только целые числа без знака. Вы можете 
обеспечить безошибочный ввод, подменяя все недопустимые символы нулевым с 
помощью, например, следующего кода: 

set, <char,. ‘0, ‘3. > Digs 

Dig << 8 OM KS Die hh << 35 044 SAI <<. 5! 

<A Ge Saat. SER. oe SOs 
if ( ! Dig.Contains (Key) ) 
{ Key = 0; Beep();} 

При нажатии пользователем любой клавиши, кроме клавиш с цифрами, сим- 
волы подменяются нулевым символом и просто не появляются в окне редактирова- 
ния, как вы можете убедиться, сделав приложение с этим простым примером. 
Функция Веер воспроизводит при нажатии пользователем ошибочной клавиши 
звуковой сигнал. 


4.4 Перетаскивание объектов 


4.4.1 Перетаскивание информации об объектах — 
технология Drag&Drop 


Процесс перетаскивания с помощью мыши информации из одного объекта в 
другой (Drag&Drop), коротко называемый перетаскиванием, очень широко ис- 
пользуется в Windows. Например, вы можете перемещать файлы между папками, 
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перемещать сами папки, включая их в другие папки, и т.д. Посмотрим, как осу- 
ществляется подобное перетаскивание информации об объектах в C++Builder. 

Все свойства, методы и события, связанные с процессом перетаскивания, оп- 
ределены в классе TControl, являющемся прародителем всех визуальных компо- 
нентов C++Builder. Поэтому они являются общими для всех компонентов. 

Начало процесса перетаскивания определяется свойством Ога Моде, которое 
может устанавливаться в процессе проектирования или программно равным 
dmManual или dmAutomatic. Значение dmAutomatic (автоматическое) определя- 
ет автоматическое начало процесса перетаскивания при нажатии пользователем 
кнопки мыши над компонентом. Имейте в виду, что в этом случае событие 
OnMouseDown, связанное с нажатием пользователем кнопки мыши, для этого 
компонента вообще не наступает. Значение же dmManual (ручное) говорит о том, 
что начало процесса перетаскивания должен определять программист. Для этого 
он должен в соответствующий момент вызвать метод BeginDrag. Например, он мо- 
жет поместить вызов этой функции в обработчик события OnMouseDown, насту- 
пающего в момент нажатия кнопки мыши. В этом обработчике он может прове- 
рить предварительно какие-то условия (режим работы приложения, нажатие тех 
или иных кнопок мыши и вспомогательных клавиш) и при выполнении этих усло- 
BUM вызвать BeginDrag. 

Пусть, например, процесс перетаскивания должен начаться, если пользова- 
тель нажал левую кнопку мыши и клавишу АЦ над списком 11$ Вох1. Тогда свой- 
ство DragMode этого компонента надо установить в dmManual, а его обработчик 
события OnMouseDown может иметь вид: 

void _fastcall TForml::ListBoxlMouseDown(TObject *Sender, 

TMouseButton Button, TShiftState Shift, int X, int Y) 


{ 
if ((Button == mbLeft) && Shift.Contains(ssAlt) ) 
ListBoxl->BeginDrag(false,5); 
} 


Параметр Button обработчика события OnMouseDown показывает, какая 
кнопка мыши была нажата, а параметр Shift является множеством, содержащим 
обозначения нажатых в этот момент кнопок мыши и вспомогательных клавиш 
клавиатуры (см. раздел 4.3.1.2). Приведенный выше оператор проверяет, нажаты 
ли левая кнопка мыши и клавиша Alt. Если нажаты, то вызывается метод Begin- 
Drag данного компонента. 

В предыдущем примере в функцию BeginDrag переданы значения параметров 
false и 5. Первый из них означает, что процесс перетаскивания начнется не сразу, 
а только после того, как пользователь сдвинет мышь с нажатой при этом кнопкой 
на некоторое число пикселей, а второй параметр указывает величину перемеще- 
ния — 5. Это позволяет отличить простой щелчок мыши от начала перетаскива- 
ния. Если же передать в BeginDrag значение true и любое число, то перетаскива- 
ние начнется немедленно. 

Когда начался процесс перетаскивания, обычный вид курсора изменяется. 
Пока он перемещается над формой или компонентами, которые не могут принять 
информацию, он обычно имеет тип crNoDrop: @. Если же он перемещается над 
компонентом, готовым принять информацию из перетаскиваемого объекта, то 
приобретает вид, определяемый свойством перетаскиваемого объекта DragCursor. 
По умолчанию это свойство равно crDrag, что соответствует изображению и . Надо 
подчеркнуть, что вид курсора определяется свойством DragCursor перетаскивае- 
мого объекта, а не того объекта, над которым перемещается курсор. 

В процессе перетаскивания компоненты, над которыми перемещается курсор, 
могут сообщать о готовности принять информацию от перетаскиваемого объекта. 
Для этого в компоненте должен быть предусмотрен обработчик события 
OnDragOver, наступающего при перемещении над данным компонентом курсора, 
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перетаскивающего некоторый объект. В этом обработчике надо проверить, может 
ли данный компонент принять информацию перетаскиваемого объекта, и если не 
может, задать значение false передаваемому в обработчик параметру Accept. По 
умолчанию этот параметр равен true, что означает возможность принять перетас- 
киваемый объект. Обработчик для списка 11$Вох1 может иметь, например, сле- 
дующий вид: 

void _fastcall TForml::ListBoxlDragOver(TObject *Sender, 

TObject *Source, int X, int Y, TDragState State, bool &Accept) 
{ 


if (Sender != Source) 
Accept = Source->ClassNamels ("TListBox") ; 
else Accept = false; 


} 


В нем сначала проверяется, не являются ли данный компонент (Sender) и пе- 
ретаскиваемый объект (Source) одним и тем же объектом. Это сделано, чтобы избе- 
жать перетаскивания информации внутри одного и того же списка. Если источник 
и приемник являются одним и тем же объектом, то срабатывает else и параметр 
Accept становится равным false, запрещая прием информации. Если же это раз- 
ные объекты, TO Accept делается равным true, если источником является какой-то 
другой список (компонент класса TListBox), и равным false, если источник явля- 
ется объектом любого другого типа. Таким образом компонент ListBox1 сообщает, 
что готов принять информацию из любого другого списка. 

Значение параметра Accept, задаваемое в обработчике события OnDragOver, 
определяет вид курсора, перемещающегося при перетаскивании над данным ком- 
понентом. Если в компоненте не описан обработчик события OnDragOver, то счи- 
тается, что данный компонент не может принять информацию перетаскиваемого 
объекта. 

Процедура приема информации от перетаскиваемого объекта записывается в 
обработчике события OnDragDrop принимающего компонента. Это событие насту- 
пает, если после перетаскивания пользователь отпустил кнопку мыши над данным. 
компонентом. В обработчик этого события передаются параметры Source (объ- 
ект-источник) и Х и У координаты курсора. Если продолжить начатый выше при- 
мер перетаскивания информации из одного списка в другой, то обработчик собы- 
тия OnDragDrop может иметь вид: 

void _fastcall TForml::ListBox1lDragDrop(TObject *Sender, 

TObject *Source, int X, int Y) 

{ 

TListBox *S = (TListBox *) Source; 
( (TListBox* ) Sender) ->Items->Add ( 
S->Items->Strings[S->ItemIndex]); 

} 

В этом обработчике первый оператор создает указатель $ на объект класса. 
TListBox, и передает в него ссылку на объект Source, воспринимаемый как объект 
TListBox. Это сделано просто для того, чтобы не повторять несколько раз в следую- 
щем операторе приведение типа Source к указателю на объект класса TListBox. А 
такое приведение типа необходимо по следующей причине. Параметр Source объ- 
явлен как указатель на объект класса TObject. Но в этом классе отсутствуют свой- 
ства Items и ItemIndex. Они имеются только в классе TListBox. Поэтому прежде, 
чем обратиться к этим свойствам, надо произвести соответствующее приведение 
типа Source. Подробнее это изложено в разделе 1.5.6.2 главы 1. 

Второй оператор обработчика заносит методом Add выделенную строку спи- 
ска-источника $ в список-приемник Sender. В этом переносе информации из одно- 
го списка в другой и заключается в нашем примере Drag&Drop. | 

В приведенном обработчике можно было бы обойтись и без создания указателя 
5. В этом случае обработчик имел бы следующий вид: 
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void _fastcall TForml::ListBoxlDragDrop(TObject *Sender, 
TObject *Source, int X, int Y) 
{ 
((TListBox*) Sender) ->Items->Add(((TListBox *) Source) -> 
Items->Strings[((TListBox *) Source) ->ItemIndex]); 
} 


После завершения или прерывания перетаскивания наступает событие 
OnEndDrag, в обработчике которого можно предусмотреть какие-то дополнитель- 
ные действия. Имеется также связанное с перетаскиванием событие OnStartDrag, 
которое позволяет произвести какие-то операции в начала перетаскивания. Это со- 
бытие полезно при автоматическом начале перетаскивания, когда иным способом 
этот момент нельзя зафиксировать. 

Теперь, объединив приведенные выше фрагменты обработки перетаскивания, 
просуммируем, что надо сделать, если вы имеете в приложении несколько списков 
ListBox и хотите обеспечить возможность копирования строк каждого из этих спи- 
CKOB в любой другой. 

’ Это потребует двух операций: 


@ Выделите мышью все списки приложения как одну группу, перейдите в Инс- 
пекторе Объектов на страницу событий, сделайте двойной щелчок около стро- 
ки события OnDragOver и напишите в Редакторе Кода приведенный выше об- 
работчик события OnDragOver. | 


Ш Аналогичным образом напишите общий для всех списков приведенный выше 
обработчик события OnDragDrop. 


И это все! Для обеспечения возможности перетаскивания вам потребовалось 
написать всего два оператора. Если вы хотите начинать перетаскивание только 
при выполнении какого-то дополнительного условия, например, при нажатии кла- 
виши Alt, то вам потребуется сделать еще один шаг: 


Ш Задайте для всех списков значение свойства DragMode, равное dmManual. На- 
пишите для этих списков приведенный выше общий обработчик события Оп- 
MouseDown. 


Теперь вы можете создать форму с несколькими списками, занести в них ин- 
формацию, написать эти обработчики и проверить все это на практике. На рис. 4.9 
приведен пример, демонстрирующий различные аспекты перетаскивания. Этот и 
другие примеры имеются на диске, прилагаемом к книге. Можете попробовать для 
тренировки сами создать аналогичный пример, позволяющий перетаскивать стро- 
ки и метки из одного списка в другой и из списков в окно редактирования Мето. В 
примере демонстрируются разные способы перетаскивания: автоматическое, руч- 


Рис. 4.9 ь I Lei И мор . 
Пример приложения, использующего Drag&Drop 
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ное, только при определенной нажатой клавише, перетаскивание строк без удале- 
ния из списка-источника (т.е. копирование) и с удалением (перемещение). Думаю, © 
что изложенного выше достаточно, чтоб вы сами смогли создать подобный пример. 


4.4.2 Перетаскивание и встраивание объектов — Drag&Doc. 
Плавающие окна 


Начиная с C++Builder 4 реализована технология перетаскивание и встраива- 
ние оконных объектов — Drag&Doc. Вы можете познакомится с результатами этой 
технологии, работая с Интегрированной Средой Разработки C++Builder 5. Она. 
предоставляет пользователю полную свободу в перестройке интерфейса. Отдель- 
ные окна могут объединяться вместе, создавать многостраничное окно с закладка- 
ми, затем опять разъединяться и т.д. Посмотрим, как подобный подход можно 
реализовать в своем приложении. 

У оконных компонентов введено свойство DockSite, которое по умолчанию 
равно false, но если его установить в true, то компонент становится контейнером: 
приемником, способным принимать переносимые в него компоненты — клиенты. 
Еще одно свойство приемника — UseDockManager. Если оно равно true (это при- 
нято по умолчанию), то процессом встраивания клиента автоматически управляет 
диспетчер встраивания, соответствующий тому компоненту, который является 
приемником. Если же задать UseDockManager равным false, то встраивание кли- 
ентов ложится на плечи программиста. 

В компонентах — потенциальных клиентах надо установить свойство 
DragKind в dkDock. Кроме того, если вы хотите, чтобы процесс перетаскивания 
начинался автоматически, TO, так же, как и в технологии Drag&Drop, надо устано- 
вить свойство DragMode в dmAutomatic. Если оставить значение DragMode рав- 
ным dmManual по умолчанию, то управление процессом Drag&Doc осуществляет- 
ся так же, как описывалось ранее для процесса Drag&Drop. 

Посмотрим, к чему все это может привести. Давайте построим тестовое прило- 
жение, в котором осуществим Drag&Doc, не написав ни одной строчки кода. 

Начните новое приложение. Перенесите на форму 6 панелей, расположив их 
примерно так, как показано на рис. 4.10 а). В панели Panell установите свойство 
DockSite в true. Эта панель сможет служить у вас приемником. В панелях Panel2 
— Panel6 установите DragKind в dkDock и DragMode в dmAutomatic. Запустите 
приложение. Попробуйте перетаскивать мышью панели Panel2 — Pnel6. Вы уви- 
дите (рис. 4.10 6), что панель Panell может принимать другие панели, размещая 
их внутри себя, причем способ встраивания зависит от того, в какой части прием- 
ника вы завершаете буксировку клиента. Между размещенными клиентами име- 
ются разделители, которые ‘позволяют вам перемещать буксировкой границы меж- 
ду клиентами, изменяя их относительные размеры. Вы можете также видеть, что 
даже независимо от наличия или отсутствия в приложении приемника, при щелч- 
ке на комгонентах-клиентах они превращаются в самостоятельные плавающие 
окна (панели Paneld и Panel6 на рис. 4.10 6), которые можно перемещать, выходя 
даже за пределы родительской формы, можно изменять их размеры, можно закры- 
вать их, после чего соответствующие компоненты исчезают. Причем все это дос- 
тигнуто только заданием соответствующих свойств, без единого написанного вами 
оператора. 

Приемниксм может быть и сама форма. Укажите для формы вашего приложе- 
ния DockSite рёвным true и выполните приложение опять. Поведение перетаски- 
ваемых панелей несколько изменится. При щелчке на компонентах-клиентах они 
по-прежнему превращаются в плавающие окна, которые можно перемещать, изме- 
нять их размеры и! т.п. Но при повторном щелчке они опять становятся обычными 
панелями, сохрания при этом измененное местоположение и размеры. Объясняет- 
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Рис. 4.10 
Демонстрация техники Drag&Doc: форма (a) и окно 
приложения во время выполнения (6) 


ся это тем, что повторный щелчок воспринимается в этом случае как встраивание 
клиента в приемник — форму. 

Теперь посмотрим, как можно управлять из компонента-приемника всеми 
этими процессами. 

У приемника имеется свойство DockClients, объявленное как 


TControl* DockClients[int Index] 


которое позволяет получить доступ к каждому клиенту, перенесенному в прием- 
ник. Свойство DockClientCount содержит число клиентов. Оба свойства — Do- 
ckClients и DockClientCount только для чтения. 

‘Определены соответствующие события, которые позволяют приемнику управ- 
лять процессом встраивания. Они генерируются только в том случае, если в компо- 
ненте установлено DockSite = true. 

Первое из этих событий — OnGetSiteInfo, возникающее в момент начала пере- 
таскивания и повторяющееся непрерывно в процессе перетаскивания. Заголовок 
соответствующего обработчика имеет вид: 

void _fastcall TForml::PanellGetSiteInfo(TObject *Sender, 


TControl *DockClient, TRect &InfluenceRect, 
TPoint &MousePos, bool &CanDock) 


В качестве параметров в обработчик передается DockClient — перетаскивае- 
мый объект, InfluenceRect — прямоугольник рамки перетаскиваемого объекта, 
который можно изменять, MousePos — положение курсора мыши и CanDock — 
разрешение перетаскивания. Если в обработчике указать CanDock = false, это бу- 
дет означать, что приемник отказывается принимать компонент. Например, вы 
можете написать в обработчике события OnGetSiteInfo панели Panell оператор: 


CanDock = DockClient != Panel6; 


Тогда Panell будет принимать любой компонент, кроме Panel6. 

Еще одно событие — OnDockOver, возникающее и повторяющееся, когда ком- 
понент-клиент перемещается над компонентом-приемником, точнее, когда в поле 
приемника войдет курсор мыши, буксирующий клиента. Это событие аналогично 
событию OnDragOver в технологии Drag&Drop. Заголовок соответствующего обра- 
ботчика имеет вид: 
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void _fastcall TForml::PanellDockOver(TObject *Sender, 
TDragDockObject *Source, int X, int Y, 
TDragState State, bool &Accept) 


В этом обработчике вы можете, как и в описанном выше, проверить, хотите ли 
вы, чтобы данный оконный компонент принял перетаскиваемый компонент, опре- 
деляемый параметром Source. Если принимать не надо, то задается значение 
Accept = false. 

Например, прием контейнером Panell любой панели, кроме Panel6, обеспечи- 
вается оператором: 


Accept = Source->Control != Рапе16; 


Параметр Accept будет равен true — значению по умолчанию, только если пе- 
ретаскивается не Panel6. Впрочем, того же самого результата вы достигали ранее в 
обработчике события ОпСбе Це шфо. 

Объект перетаскивания Source типа TDragDockObject имеет свойство 
DockRect типа TRect, описывающее перемещаемую рамку. Вы можете управлять 
ею. Например, если вы хотите, чтобы ваша Paneld вела себя наподобие панели 
Microsoft Office, которая может прижиматься к одной из сторон окна или переме- 
щаться в середине окна в виде квадратной панели, вы можете, установив предва- 
рительно в приемнике (в форме вашего приложения или в панели Panell) 
DockSite равным true, написать обработчик события OnDockOver в виде: 

int x = ClientOrigin.x; 

int y = ClientOrigin.y; 

if (Source->Control == Рапе15) 

{ 

if (Source->DockRect.Left <= x) 
Source->DockRect = Rect (x,y, x+25, y+ClientHeight) ; 
else if (Source->DockRect.Right >= x+ClientWidth) 
Source->DockRect = Rect (x+ClientWidth-25, 
у, XtClientWidth, y+ClientHeight) ; 
else if (Source->DockRect.Top <= y) 
Source->DockRect = Rect (x, y,x+ClientWidth, y+25) ; 
else if (Source->DockRect.Bottom >= y+ClientHeight) 
Source->DockRect = Rect (x, y+ClientHeight-25, 
x+ClientWidth, y+ClientHeight) ; 
else Source->DockRect = Rect (Source->DockRect.Left, 
Source->DockRect.Top, 
Source->DockRect.Left+100, 
Source->DockRect.Top+100) ; 
} 


В этом кодехиу — это не параметры Х и У, передаваемые в обработчик через 
заголовок процедуры, а координаты левого верхнего угла клиентской области фор- 
мы. A Client Width и ClientHeight — это ширина и высота ее клиентской области. 

Если в процессе буксировки панели Paneld ее координаты выходят за пределы 
клиентской области приемника, то панель вытягивается вдоль соответствующего 
края приемника, а ее ширина равна 25. При перемещении панели внутри окна она 
представляется квадратом со стороной 100. 

Это будет нормально срабатывать, если для приемника, например, для панели 
Panell, установить UseDockManager равным false. В противном случае сначала 
сработает диспетчер встраивания, .растянув рамку клиента, а затем наступит собы- 
тие OnDockOver, так что его обработчик будет иметь дело с уже измененной рам- 
кой, что приведет к ошибке встраивания. Поэтому надо отключить диспетчер 
встраивания для клиента Paneld, не отключая его для остальных клиентов. Это 
легко сделать, включив в обработчик события OnGetSiteInfo оператор 


Panell->UseDockManager = DockClient != Panel5; 
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Этот оператор задаст значение UseDockManager равным true для всех потен- 
циальных клиентов, кроме Panel5d. 

Еще одно событие, возникающее в компоненте-приемнике — OnDockDrop. 
Это событие возникает в момент окончания перетаскивания клиента над приемни- 
ком. Оно аналогично событию OnDragDrop в технологии Drag&Drop. Заголовок 
соответствующего обработчика имеет вид: 


void .fastcall TForml::FormDragDrop(TObject *Sender, 
TObject *Source, int X, int Y) 


Этот обработчик позволяет разместить клиента Source тем или иным образом 
в зависимости от его имени, типа, местоположения — координат X’'u У. Например, 
в этот момент можно что-то изменить в надписях приемника, сигнализируя поль- 
зователя о приеме клиента и числе клиентов. 

Событие, возникающее в компоненте-приемнике в момент, когда пользователь 
перетаскивает клиента из приемника — OnUnDock. Заголовок соответствующего 
обработчика имеет вид: 


void _ Еаз®са11 TForml::FormUnDock(TObject *Sender, 
TControl *Client, TWinControl *NewTarget, bool é&Allow) 


В обработчик передаются как параметры Client — компонент, который был 
клиентом, NewTarget — новый приемник, в который пользователь перетаскивает 
клиента, и Allow — параметр, определяющий, можно ли перетащить клиента. На- 
пример, если в вашем тестовом приложении вы поместите в обработчик события 
OnUnDock панели Рапе!1 оператор: 


Allow = Client != Panel2; 


TO, выполняя приложение, обнаружите, что Panel2, попав клиентом в Panell, уже 
не может оттуда выбраться, так как ей это запрещено. 

Теперь, когда мы познакомились с основными возможностями технологии 
Drag&Doc, давайте построим что-нибудь более полезное, чем просто игра панеля- 
ми. Но сначала сохраните ваше тестовое приложение, поскольку оно еще нам по- 
требуется. 

Давайте построим многооконный редактор текстов, имеющий хранилище, в 
которое можно помещать документы на хранение и затем извлекать из него нуж- 
ные документы. 

Начните новый проект и выполните следующие пункты. 


Ш Назовите форму (свойство Name) Етат. 


Ш Разместите на форме компонент MainMenu и задайте в нем всего один 
пункт — Новый, подразумевая под этим создание нового документа. 


Ш Поместите на форму панель, задайте ее свойство Caption равным Хранилище 
документов и задайте Align = а! Тор. 


Ш Поместите на форму компонент PageControl и задайте Align = alClient, чтобы 
он занимал вся площадь окна, кроме полосы, занятой панелью Хранилище до- 
кументов (рис. 4.11 а). Задайте в нем свойство DockSite равным true. Этот 
компонент будет служить приемником документов. 


Ш Добавьте в проект еще одну форму, выполнив команду File | New Form. Назовите 
ее FDoc (свойство Name). Задайте ее свойство Visible равным true. Установите 
ее свойство DragKind равным dkDock, а свойство DragMode равным dmAuto- 
matic. Эта форма будет служить клиентом компонента TPageControl на форме 
Fmain. | 


Ш Поместите на форму FDoc компонент Memo, задав для него Align = alClient, 
чтобы он занял всю форму (рис. 4.11 6). Сотрите в нем текст (свойство Lines). 


Ш Выполните команду Project | Options и перенесите форму FDoc из окна Auto-crea- 
te forms в окно Available forms, поскольку она должна создаваться не автоматиче- 
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Рис. 4.11 

Формы для 
приложения, 
использующего 
технику Drag&Doc 


ски, а при выборе пользователем раздела меню Новый (если эта операция непо- 
нятна, см. раздел 4.5.1 рис. 4.14). 


Ш Сохраните проект, назвав модуль с первой формой Оташ, а со второй — 
UDoc. | 


Мы создали необходимые нам формы. Осталось написать несколько операто- 
ров, чтобы это все работало. 


Ш Выполните для модуля Umain команду File | Include Unit Hdr и подключите с ее 


помощью заголовочный файл UDoc.h, чтобы можно было ссылаться на модуль 
UDoc. 


Ш Введите глобальную переменную LDoc tuna TList. Она представляет собой 
список, в котором будут храниться указатели на создаваемые пользователем _ 
формы документов. 


TList * Гос; 


Ш В обработчик события OnCreate формы Fmain запишите оператор 
LDoc = new TList(); 


Этот оператор создает список LDoc. 
Ш В обработчик события OnDestroy формы Fmain запишите оператор 


delete Ldoc; 


Этот оператор освобождает память при закрытии приложения. 


Ш Осталось написать обработчик щелчка на разделе меню Новый. Он может иметь 
следующий вид: 


TFDoc * New = new TFDoc(this); 
LDoc->Add (New) ; 
New->Caption = "Документ "+IntToStr(LDoc->Count) ; 


В этом обработчике вводится переменная New tuna TFDoc, соответствующего 
типу формы FDoc. Первый оператор обработчика динамически размещает новую 
форму FDoc и присваивает указатель на Hee переменной New. Следующий опера- 
тор добавляет указатель на эту. форму в список LDoc. А последний оператор задает 
заголовок окна формы FDoc, равным «Документ ...», где многоточие заменяется 
на номер, соответствующий числу строк в списке LDoc. 

Теперь ваше приложение полностью готово. Сохраните его и попробуйте в ра- 
боте (рис. 4.12). При щелчке на Новый создается новая форма документа, в кото- 
ром вы можете писать текст. Документы можно помещать в хранилище, в котором 


‘ ‘ ae FS 


~ 5 — 
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каждому документу автоматически отводится новая страница. Вы можете рабо- 
тать с документом непосредственно в хранилище, а можете изъять его оттуда, пре- 
вратив опять в отдельное окно. 


Рис. 4.12 |7 Миогооконный редактор 0 
Приложение, использующее технику 
Drag&Doc, во время выполнения 


: Это текст Докоманто 1. 


Jn Документ 4 


Для того, чтобы сделать из вашего приложения законченный продукт, нужна 
еще, конечно, некоторая техническая работа. Надо бы добавить разделы меню, по- 
зволяющие открыть заданный пользователем файл и прочитать его в новый доку- 
мент, позволяющие сохранить документ в файле, надо бы ввести при закрытии 
приложения или документа запрос пользователю о необходимости сохранить изме- 
ненный документ и т.п. Для всех этих операций вам пригодится созданный вами 
список LDoc, который в приведенном упрощенном примере практически не ис- 
пользовался. Но мы не будем этим заниматься, так как все эти манипуляции под- 
робно рассмотрены в разделе 3.8.2 главы 3. А для того, чтобы почувствовать мощь 
технологии Drag&Drop, достаточно и сделанного вами примера. Причем, заметьте, 
что для его реализации вам пришлось написать всего несколько операторов. 

В заключение рассмотрим еще некоторые свойства и методы, управляющие 
встраиванием и работой с плавающими окнами. | 

У оконных компонентов есть свойство Floating (только для чтения), которое 
показывает, является компонент свободно плавающим окном, или размещен в 
другом оконном компоненте-приемнике. 

При переводе ранее размещенного компонента в состояние плавающего окна и 
при встраивании плавающего окна можно использовать свойства, в которых запо- 
минаются размеры компонента в предыдущем состоянии: 


UndockHeight Высота компонента, которая 


отображался плавающим окном 
Undock Width Ширина компонента, которая была в последний раз, когда 


OH отображался плавающим окном 


TBDockHeight Высота компонента, когда он в последний раз размещался в 
контейнере вертикально 


LRDock Width Ширина компонента, когда OH в последний раз размещался в 
контейнере горизонтально 


Пользуясь этими свойствами можно восстанавливать при необходимости пред- 
шествующие размеры компонента. В частности, по умолчанию после перевода 
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компонента из размещенного состояния в состояние плавающего окна его размеры 
восстанавливаются исходя из свойств UndockHeight и UndockWidth. 

Имеется метод ManualFloat, который переводит размещенный компонент в 
состояние плавающего окна. Он объявлен следующим образом: 


bool _fastcall ManualFloat (const Windows::TRect &ScreenPos) ; 


Параметр функции ScreenPos определяет положение и размер компонента по- 
сле его перевода в состояние плавающего окна. 

Например, вы можете открыть свой тестовое приложение (рис. 4.10) и ввести в 
него кнопку, которая будет переводить в состояние плавающего окна, например, ~ 
панель Panel3. Текст обработчика щелчка на такой кнопке может быть следую- 
щим: 

TRect TempRect; 

TPoint P; 

Р = Panel3->ClientToScreen(Point(0, 0)); 

TempRect.Left = P.x; 

TempRect.Top = P.y; 

P = Panel3->ClientToScreen (Point (Panel3->UndockWidth, 

Panel3->UndockHeight) ); 

TempRect.Right = P.x; 

TempRect.Bottom = P.y; 

Panel3->ManualFloat (TempRect) ;. 


В этом коде вводится переменная TempRect, в которой формируется прямо- 
угольник, определяющий размер и местоположение генерируемого плавающего 
окна. Этот прямоугольник восстанавливает размер панели Panel3, бывший у нее в 
последний раз, когда она отображалась плавающим окном. Левый верхний угол 
прямоугольника совпадает с текущим положением панели. Для правильного раз- 
мещения окна координаты с помощью метода ClientToScreen переводятся в коор- 
динаты экрана. Последний оператор методом ManualFloat генерирует плавающее 
окно. 


И последний метод, который мы рассмотрим — ManualDock, размещающий 
компонент в указанном приемнике. Его описание: 


bool _ fastcall ManualDock(TWinControl* NewDockSite, 
TControl* DropControl, TAlign ControlSide) ; 


Параметр NewDockSite определяет приемник, в котором должен размещаться 
клиент. Второй параметр DropControl определяет другой компонент в приемнике 
NewDockSite, который должен разместить данного клиента. Как правило, этот па- 
раметр задается равным nil. Параметр ControlSide определяет выравнивание кли- 
ента внутри приемника. Если это единственный клиент в приемнике, то значение 
этого параметра безразлично. Но если там уже есть клиенты, то задание, напри- 
мер, ControlSide = alLeft приведет к перестановке, если только данный клиент не 
самый левый в приемнике. 

Можете ввести в свое тестовое приложение кнопку, снабдив ее обработчиком: 


Panel4->ManualDock (Panell,NULL, а1ТеЕЁ*); 


Этот обработчик будет размещать Pnalel2 в Panell, выравнивая ee по левому 
краю приемника, если в нем расположены еще какие-нибудь клиенты. 

Имеется, однако, особенность, не оговоренная в документации: метод 
ManualDock срабатывает только в случае, если компонент-клиент был ранее в CO- 
стоянии плавающего окна. Так что вам придется предварительно один раз перевес- 
ти Panel2 в это состояние или щелчком на панели, или с помощью кнопки, соот- 
ветствующей ранее рассмотренному методу ManualFloat. Другой способ обойти 
эту трудность автоматически — ввести соответствующий метод ManualFloat в об- 
работчик события формы OnCreate. 
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И еще одно нестандартное использование методов ManualFloat и Manual- 
Dock. Пусть, например, вы хотите иметь форму, содержащую несколько панелей, 
которые пользователь мог бы перемещать, не переводя их в состояние плавающего 
‚окна и не изменяя размеров. Тогда вы можете в форме установить DockSite = true, 
сделать в панелях соответствующие установки свойств DragKind в dkDock и 
DragMode в dmAutomatic, а в событии формы OnCreate выполнить для каждой 
‚ панели методы ManualFloat и ManualDock, назначив приемником в ManualDock 
форму. Вы получите приложение, в котором пользователь сможет перемещать па- 
нели мышью. Это может быть полезно в каких-то приложениях, связанных с про- 
ектированием топологии или конструированием. Подобные задачи будут рассмот- 
рены в следующем разделе. 


4.4.3 Буксировка компонентов в окне приложения 


В ряде случаев в приложениях Windows используется перемещение отдель- 
ных компонентов в поле окна или какой-то панели. Это перемещение может быть 
перемещением в какие-то заранее определенные позиции (это легко осуществляет- 
ся заданием соответствующих значений свойствам Left и Top) или осуществляться 
непрерывной буксировкой компонента с помощью мыши. Простой пример этого — 
буксировка компонентов по площади формы в среде разработки C++Builder. По- 
добные задачи возникают достаточно часто в технических приложениях, связан- 
ных с компоновкой какого-то устройства, с формированием каких-то схем (напри- 
мер, электрических) и т.п. 

Опробовать различные способы буксировки можно в тестовом приложении, 
подобном приведенному на рис. 4.13. Этот пример имеется на прилагаемом к кни- 
ге диске. В нем на форме размещено четыре компонента Image, в которые загруже- 
ны какие-то изображения или части изображения (0 загрузке в Image изображе- 
ний и о работе с этими компонентами см. раздел 5.1.1). Если хотите воспроизвести 
пример, подобный рис. 4.13, в котором на отдельных компонентах, как на детских 
кубиках, воспроизведены фрагменты единого изображения, то можете в обработ- 
чик события формы OnCreate вставить следующий код: 

TImage * Pict = new TImage(Forml1) ; 

Pict->AutoSize = true; 

/* В следующем операторе вместо 

надо указать имя файла */ 

Pict->Picture->LoadFromFile("..."); 

Imagel->Canvas~->CopyRect (Imagel->ClientRect, Pict->Canvas, 

Rect (0,0,Pict->Width / 2,Pict->Height / 2)); 

Image2->Canvas->CopyRect (Image2->ClientRect, Pict->Canvas, 

Rect (Pict->Width / 2,0, Pict->Width, Pict->Height / 2)); 

Image3->Canvas->CopyRect (Image3->ClientRect, Pict->Canvas, 

Rect (0, Pict->Height / 2,Pict->Width / 2,Pict->Height) ); 

Image4->Canvas->CopyRect (Image4->ClientRect, Pict->Canvas, 

Rect (Pict->Width / 2,Pict->Height / 2, 
Pict->Width, Pict->Height )); 
delete Pict; 


Сейчас мы He будем анализировать этот код. Он станет вам понятен после изу- 
чения главы 5. В компонентах Image свойство AutoSize должно быть установлено 
в true. 

Начнем рассмотрение на этом примере приемов буксировки. Все приведенные 
далее обработчики событий записаны в общем виде. Так что вы можете применять 
их одновременно ко всем вашим компонентам Image, а можете к разным компо- 
нентам применить разные методы, чтобы легче их было сравнивать друг с другом. 

Все методы используют несколько глобальных переменных, объявление кото- 
рых надо поместить в модуле вне каких-либо процедур: 
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Рис. 4.13 

Приложение, 
демонстрирующее 
буксировку компонентов 


int XO, (Оз 
bool move = false; 


Переменная move определяет режим буксировки. Она будет устанавливаться в 
true в начале буксировки и сбрасываться в false в конце. Поэтому по значению 
тоуе можно будет различать перемещения мыши с буксировкой и без нее. Пере- 
менные XO и YO потребуются нам для запоминания координат курсора мыши. 

Один из возможных вариантов решения нашей задачи — буксировка самого 
компонента. Буксировка начинается при нажатии левой кнопки мыши на соответ- 
ствующем компоненте Image. Поэтому начало определяется событием OnMouse- 
Down, обработчик которого имеет вид: 

void _fastcall TForm1::ImagelMouseDown(TObject *Sender, 

TMouseButton Button, TShiftState Shift, int X, int Y) 

{ 


if (Button != mbLeft) return; 
ХО = X; 
YO = Y; 


move = true; 
((TControl *)Sender) ->BringToFront (); 
} 


Сначала в этой процедуре проверяется, нажата ли именно левая кнопка мыши 
(равен ли параметр Button значению mbLeft, обозначающему левую кнопку). За- 
тем в переменных XO и YO запоминаются координаты мыши Х и У в этот момент 
времени. Задается режим буксировки — переменная тоуе устанавливается в true. 
Последний оператор выдвигает методом BringToFront компонент, в котором про- 
изошло событие — ((TControl *)Sender), на передний план. Это позволит ему в 
дальнейшем перемещаться поверх других аналогичных компонентов. Данный опе- 
ратор не обязателен, но если его не записать, то в процессе буксировки перемещае- 
мый компонент может оказаться под другими компонентами. 

Во время буксировки компонента работает его обработчик события 
OnMouseMove, имеющий вид: 

void _ Ёаз$са11 TForml::ImagelMouseMove(TObject *Sender, 

TShiftState Shift, int X, int Y) 

{ 

if (move) 
{ 
TImage * Im = (TImage *) Sender; 
Im->SetBounds (Im->Left + X — XO, 
Im->Top + Y — YO, Im->Width, Im->Height) ; 
} 
} 


Он изменяет с помощью метода SetBounds координаты левого верхнего угла 
на величину сдвига курсора мыши (Х — XO для координаты Х и У — YO для коор- 
динаты У). Тем самым поддерживается постоянное расположение точки курсора в 
системе координат компонента, т.е. компонент смещается вслед за курсором. Ши- 


и 
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рина Width и высота Height компонента остаются неизменными. Изменение коор- 
динат можно было бы задавать непосредственным изменением свойств Left и Top: 
Im->Left += X -х0; 
Im=>Top + Хх. -— У0; 

‚ Но поскольку эти операторы выполняются поочередно, то компонент будет де- 
лать каждый раз два перемещения: сначала по горизонтали, а потом по вертикали. 
Это приведет к заметному на глаз дрожанию изображения. 

По окончании буксировки, когда пользователь отпустит кнопку мыши, насту- 
пит событие OnMouseUp. Обработчик этого события должен содержать всего один 
оператор: 


> 


move = false; 


указывающий приложению на окончание буксировки. Тогда при последующих со- 
бытиях OnMouseMove их обработчик, приведенный ранее, перестанет изменять 
координаты компонента. 

Рассмотренный вариант буксировки не свободен от недостатков. Основной из 
них — некоторое дрожание изображения при перемещении, что выглядит не очень 
приятно. Устранить этот недостаток позволяет другой вариант, заключающийся в 
букировке не самого компонента, а его контура (этот вариант вы можете видеть на 
рис. 4.13 a). При этом отмеченных выше неприятных явлений не наблюдается, по- 
скольку сам компонент перемещается только один раз — в момент окончания бук- 
сировки, когда требуемое положение уже выбрано. В этом варианте используются 
методы рисования на канве, которые подробно рассматриваются в главе 5 в разде- 
ле 5.1.3. Для их применения нам потребуется еще одна глобальная переменная: 


TRect rec; 


Это объявление следует добавить к приведенным ранее объявлениям Move, XO 
и YO. Переменная rec будет использоваться для запоминания положения переме- 
щаемого контура компонента. | 

Начинается процесс буксировки, как и ранее, с события OnMouseDown, кото- 
рое обрабатывается процедурой вида: | 

void  fastcall TForml::Image2MouseDown(TObject *Sender, 


TMouseButton Button, TShiftState Shift, int X, int У) 
| 


if (Button != mbLeft) return; 

XO = X; 

YO = Y; 

rec = ((TControl *)Sender)->BoundsRect; 


move = true; 


} 
Эта процедура отличается OT рассмотренной ранее только оператором 


/ 


rec = ((TControl *)Sender) ->BoundsRect; 


который запоминает в переменной rec исходное положение компонента. В проце- 
ype отсутствует также оператор BringToFront, поскольку сам компонент не будет 
перемещаться и не приходится заботиться о том, чтобы он оказался поверх анало- 
гичных компонентов. 

При дальнейшем перемещении курсора мыши срабатывает обработчик собы- 
тия OnMouseMove, имеющий вид: 


void _fastcall TForml::Image2MouseMove(TObject *Sender, 
TShiftState Shift, int X, int У) 
{ 
if(! move) return; 
Canvas->DrawFocusRect (rec) ; 
rec.left += X — XO; 
rec.right += X — X0; 
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rec.bottom += Y — YQ; 
ХО = X; 
YO = Y; 


Canvas->DrawFocusRect (rec); 


} 


В этой процедуре перерисовывается и сдвигается только прямоугольник KOH- 
тура компонента с помощью метода DrawFocusRect. Первое обращение к этому 
методу стирает прежнее изображение контура, поскольку повторная прорисовка 
того же изображения по операции ИЛИ (ог) стирает нанесенное ранее изображение 
(см. главу 5, раздел 5.1.5). Затем изменяются значения, хранимые в переменной 
rec, и той же функцией DrawFocusRect осуществляется прорисовка сдвинутого 
прямоугольника. При этом сам компонент остается на месте. 

Когда пользователь отпускает кнопку мыши, наступает событие OnMouseUp и 
срабатывает следующая процедура: 


void _fastcall TForml::Image4MouseUp(TObject *Sender, 
TMouseButton Button, TShiftState Shift, int X, int Y) 
{ 
Canvas->DrawFocusRect (rec); 
((TControl *) Sender) ->SetBounds ( 
rec sheftt). + Xise:X0,:> гес.Тор Ae Уго, 
((TControl *)Sender)->Width, 
((TControl *)Sender)->Height); 
((TControl *)Sender)->BringToFront(); 
move = false; 
} 


Первый ее оператор стирает последнее изображение контура, а второй опера- 
тор перемещает компонент в новую позицию. Оператор BringToFront не является 
обязательным. Он проявит себя только в случае, если перемещенный компонент 
ляжет поверх другого аналогичного компонента. 

Приведенный алгоритм исключает мерцание изображения, так как само пере- 
мещение компонента осуществляется только в момент отпускания кнопки мыши. 
К тому же при этом в обработчике события OnMouseUp легко предусмотреть ка- 
кие-то условия отказа от перемещения (например, нажатую клавишу Alt). Для это- 
го достаточно в приведенный выше обработчик добавить проверку нажатых кла- 
виш: 


Canvas->DrawFocusRect (rec) ; 

if(! Shift.Contains (ssAlt) ) 

{ 

((TControl *)Sender) ->SetBounds ( 
rea u.Gett: +. Х:- XO}. rece Top-4+5 kr XO, 
((TControl *)Sender)->Width, 
((TControl *)Sender)->Height) ; 

((TControl *)Sender)->BringToFront(); 
} 


move = false; 


В этом случае, если пользователь перед завершением буксировки нажмет кла- 
Buy Alt, компонент не переместится. Это полезно в некоторых приложениях, свя- 
занных с каким-то проектированием топологии или размещения предметов: при- 
кинув новое положение компонента пользователь может тут же вернуться к пре- 
дыдущему, если новое расположение неудачно. С другой стороны, для некоторых 
задач буксировка только контура мало информативна. Например, при проектиро- 
вании какой-то мозаики перемещение контура не даст представления о том, подой- 
дет ли компонент по своему виду к данному месту. В этих случаях предпочтитель- 
нее буксировка всего изображения. 
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Описанный выше способ перемещения изображения контура компонента мож- 
но осуществить иначе с использованием техники Drag&Dock и методов Manual- 
Float и ManualDock, описанных в разделе 4.4.2. Чтобы опробовать этот подход, 
установите в форме свойство DockSite равным true и сделайте в перемещаемых 
компонентах (в нашем примере — в Image) установку свойств DragKind в dkDock 
u,DragMode в dmAutomatic. Это надо сделать по крайней мере в двух компонен- 
тах. Если перемешаемым будет только один компонент, описываемый метод не 
сработает. В начале работы приложения надо выполнить для каждого компонента, 
который в дальнейшем может перемещаться, методы ManualFloat и ManualDock, 
назначив приемником в ManualDock форму. Для этого можно вставить в обработ- 
чик события формы OnCreate, например, следующие операторы: 

Image3->ManualFloat (Rect (Form1l->Left+Image3->Left, 

Forml->ToptImage3->Top, 
Forml->Left+Image3->Left+Image3->Width, 
Forml->Top+Image3->Top+Image3->Height) ); 

Image3->ManualDock(Forml,NULL, alLeft) ; 


Аналогичные операторы с заменой имени компонента Images надо вставить и 
для других перемещаемых компонентов. 

И это все. Вам не надо писать никаких обработчиков событий компонентов. 
Вы получили приложение, в котором пользователь может перемещать мышью 
ваши изображения. При этом в процессе буксировки перемещается только контур 
изображения в виде утолщенной рамки (рис. 4.13 6). Сам компонент перемещается 
на новое место только в конце буксировки. Если хотите, то можете в обработчик 
события OnEndDock внести оператор 


((TControl *) бепаег) ->Вг1паТоЕгоп® (); 


который обеспечит в момент переноса размещение компонента поверх других. 


4.5 Формы 


4.5.1 Управление формами 


Основным элементом любого приложения является форма — контейнер, в ко- 
тором размещаются другие визуальные и невизуальные компоненты. Рассмотрим 
некоторые свойства, методы и события, присущие формам. 

Обычно сколько-нибудь еложное приложение содержит несколько форм. 
Включение в проект новой формы осуществляется командой File | New Form или 
другими способами, подробно описанными в разделе 2.5.1. По умолчанию все фор- 
мы создаются автоматически при запуске приложения и первая из введенных в 
приложение форм считается главной. Главная форма отличается от прочих рядом 
свойств. Во-первых, именно этой форме передается управление в начале выполне- 
ния приложения. Во-вторых, закрытие пользователем главной формы означает за- 
вершение выполнения приложения. В-третьих, главная форма так же, как и лю- 
бая другая, может быть спроектирована невидимой, но если все остальные формы 
зарыты, то главная форма становится в любом случае видимой (иначе пользова- 
тель не смог бы продолжать работать с приложением и даже не смог бы его завер- 
шить). 

Указанные выше условия, принятые по умолчанию (первая форма — главная, 
все формы создаются автоматически), могут быть изменены. Главной в вашем при- 
ложении может быть вовсе не та форма, которая была спроектирована первой. Не 
стоит также в общем случае все формы делать создаваемыми автоматически. В 
приложении могут быть предусмотрены формы (например, формы для установки 
различных опций), которые требуются далеко не в каждом сеансе работы с прило- 
жением. Было бы варварским расточительством создавать на всякий случай такие 
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формы автоматически при каждом запуске приложения и занимать под них па- 
мять. А в приложениях МПГ дочерние формы в принципе не могут быть автомати- 
чески создаваемыми, так как число таких форм определяет пользователь во время 
работы приложения, создавая каждую новую форму командой типа Новое окно. 

Изменить принятые по умолчанию условия относительно форм можно в окне 
Опций проекта, которое вызывается, например, командой Project | Options главного 
меню. В открывшемся окне Опций проекта (Project Options) надо выбрать страницу 
Forms, представленную на рис. 4.14. 


Рис. 4.14 iProject Options 
Страница Forms окна Опций проекта a | 


В верхнем выпадающем списке Main forms можно выбрать главную форму сре- 
ди имеющихся в проекте. Пользуясь двумя нижними окнами можно установить, 
какие формы должны создаваться автоматически, а какие не должны. Например, 
если надо исключить форму Form2 из списка автоматически создаваемых, то надо 
выделить ее в левом окне (Auto-create forms) и с помощью кнопки со стрелкой, на- 
правленной вправо, переместить в правое окно доступных форм (Available forms). 

Для каждой автоматически создаваемой формы C++Builder добавляет в файл 
программы соответствующий оператор ее создания методом CreateForm. Это мож- 
но увидеть, если выполнить команду View | Project Source и просмотреть появивший- 
ся в окне Редактора Кода файл проекта. Для примера, показанного на рис. 4.14, он 
будет содержать следующие выполняемые операторы: 

Application->Initialize(); 
Application->CreateForm( classid(TForml), &Forml); 


Application->CreateForm(  classid(TAboutBox), &AboutBox) ; 
Application->Run (); 


Первый из них инициализирует приложение, второй и третий создают соот- 
ветствующие формы, а последний начинает выполнение приложения. 

Для форм, которые были исключены из списка автоматически создаваемых, 
аналогичный метод CreateForm надо выполнить в тот момент, когда форма долж- 
на быть создана. Например, чтобы создать в нужный момент при выполнении кода 
в модуле формы Form1 форму Form2, надо выполнить оператор: 


Application->CreateForm( classid(TForm2), &Form2) ; 


Форма Form2 будет создана и, если ee свойство Visible установлено в true, TO 
пользователь в тот же момент увидит ее на экране. Только для того, чтобы это сра- 
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ботало, надо в модуль формы Form] включить заголовочный файл модуля формы 
Form2. Если имя этого файла Unit2.h, то можно вручную включить в модуль фор- 
мы РГогит1Т директиву препроцессора 


#include “Unit2.h" 


То же самое можно сделать, выполнив команду главного меню File | Include Unit 
Hdr и выбрав в появившемся диалоговом окне имя нужного файла. Тогда указан- 
ная выше директива препроцессора будет записана в модуль автоматически. 

В момент создания формы возникает последовательность событий: 


| Событие ое one emg инь 


| OnCreate форма создание формы и всех управляемых ею ком- 
понентов 


OnActivate | форма о aay 


после этого события форма становится види- 
мой 


управление (фокус) передается данной форме 


первый компонент в | фокус передается компоненту, первому в по- 
последовательности |следовательности табуляции 
табуляции формы 


_OnResize форма переустанавливаются размеры формы 
| OnPaint _| форма _ | прорисовка изображения формы _ 


Обратите внимание на событие OnCreate. Обработка этого события широко ис- 
пользуется для настройки каких-то компонентов формы, создания списков и т.д. 
Это событие для каждой формы происходит только один раз. Все остальные собы- 
тия могут в процессе выполнения приложения неоднократно повторяться. 

В нужный момент форму можно сделать видимой методами Show или 
ShowModal. Последний метод открывает форму как модальную. Это означает, что 
управление передается этой форме и пользователь не может передать фокус другой 
форме данного приложения до тех пор, пока он не закроет модальную форму. Бо- 
лее подробное описание модальных форм и примеры работы с ними будут рассмот- 
рены позднее в разделе 4.5.2. 

Методы Show и ShowModal можно применять только к невидимой в данный 
момент формы. Если нет уверенности, что форма в данный момент видима, то пре- 
жде, чем применять эти методы, следует проверить свойство Visible формы. При 
выполнении методов Show или ShowModal возникает событие формы onShow. Это 
событие возникает до того момента, как форма действительно станет видимой. По- 
этому обработку события ONShow можно использовать для настройки каких-то 
компонентов открываемой формы. Отличие от упомянутой ранее настройки ком- 
понентов в момент события onCreate заключается в том, что событие опСгеа{е на- 
ступает для каждой формы только один раз в момент ее создания, а события 
onShow наступают каждый раз, когда форма делается видимой. Так что при этом в 
настройке можно использовать какую-то оперативную информацию, возникаю- 
щую в процессе выполнения приложения. 

Методом Hide форму в любой момент можно сделать невидимой. В этот мо- 
мент в ней возникает событие OnHide. 

Необходимо напомнить, что для выполнения методов CreateForm, Show, 
ShowModal, Hide и вообще для обмена любой информацией между формами моду- 
ли соответствующих форм должны видеть друг друга, а для этого в них надо вклю- 
чать описанные выше директивы препроцессора #include. Например, если форма в 
модуле Оп 1 должна управлять формой в модуле Оп! 2, то в модуль Оп 1 должна 
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быть включена инструкция #теа4е “Unit2.h". А если к тому же форма в модуле 
Unit2 должна пользоваться какой-то информацией, содержащейся в модуле 
Unit1, то в модуль Unit2 должна быть включена инструкция #теаде “Unit1l.h”. 

Закрыть форму можно методом Close. При этом в закрывающейся форме воз- 
никает последовательность событий, которые можно обрабатывать. Их назначе- 
ние — проверить возможность закрытия формы и указать, что именно подразуме- 
вается под закрытием формы. Проверка возможности закрытия формы необходи- 
ма, например, для того, чтобы проанализировать, сохранил ли пользователь доку- 
мент, с которым он работал в данной форме и который изменял. Если не сохранил, 
приложение должно спросить его о необходимости сохранения и, в зависимости от 
ответа пользователя, сохранить документ, закрыть приложение без сохранения 
или вообще отменить закрытие. 

Рассмотрим последовательность событий, возникающих при выполнении ме- 
тода Close. 

Первым возникает событие onCloseQuery. В его обработчик передается по 
ссылке булева переменная CanClose, определяющая, должно ли продолжаться за- 
крытие формы. По умолчанию CanClose равно true, что означает продолжение за- 
крытия. Но если из анализа текущего состояния приложения или из ответа поль- 
зователя на запрос о закрытии формы следует, что закрывать ее не надо, парамет- 
ру CanClose должно быть присвоено значение false. Тогда последующих событий, 
связанных с закрытием формы не будет. 

Например, пусть в приложении имеется окно редактирования Richkdit1, в ко- 
тором свойство Modified указывает Ha то, был ли изменен пользователем текст в 
этом окне с момента его последнего сохранения. Тогда обработчик события 
onCloseQuery может иметь вид: 

void _fastcall TForml::FormCloseQuery(TObject *Sender, 


bool &CanClose) 
{ 
if (RichEditl->Modified) 
{ 
int res = Application->MessageBox ( 
"Текст документа не сохранен. \п\п" 
"Сохранить документ в файле?\п\п" 
"(Отмена — продолжение работы)", 
"Подтвердите завершение работы", 
MB YESNOCANCEL + МВ ICONQUESTION) ; 
Switch (res) 
{ 
case IDYES: MSaveClick (Sender) ; 
break; 
case IDCANCEL: CanClose = false; 
} 
} 
} 


В приведенном обработчике вызывается методом Application->MessageBox 
(см. его подробное описание в главе 15 в разделе 15.7.2.3) диалоговое окно, пока- 
занное на рис. 4.15. Если пользователь ответит «Да», то будет выполнена описан- 
ная в приложении процедура сохранения MSaveClick. Если пользователь ответит 
«Нет», то никаких действий в структуре switch производиться не будет. В обоих 
случаях после выхода из обработчика события значение CanClose останется рав- 
ным своему значению по умолчанию true и процесс закрывания формы будет про- 
должен. Но если пользователь при запросе ответит «Отмена» или нажмет клавишу 
Esc, то значение CanClose станет равно false и окно не закроется. Этот обработчик 
сработает при любой попытке пользователя закрыть приложение: нажатии в нем 
кнопки или раздела меню Выход, нажатии кнопки системного меню в полосе заго- 
ловка окна и т.п. 
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Рис. 4.15 Подтвердите завершение работ 
Диалоговое окно с запросом о завершении работы 


Если обработчик события onCloseQuery отсутствует или если в его обработчи- 
ке сохранено значение true параметра CanClose, то следом наступает событие 
OnClose. В обработчик этого события передается по ссылке переменная Action, ко- 
торой можно задавать значения: 


а а ELE ELERLLIEE DES RLAEEE ELIE ELLER IEEE NEE SAEE LEGER GE LEDER ELIE EEG OLE SEL IDLE REECE SER LES i RIOR LLG POLL LOLI OEE EEE, 


caNone Не закрывать форму. Это позволяет и в обработчике данного 
события еще отказаться от закрытия формы 


НИРС 


caHide При этом значении (оно принято по умолчанию для форм, не 
являющихся главными и дочерними в приложениях MDI) за- 
крыть форму будет означать сделать ее невидимой. Для поль- 
зователя она исчезнет с экрана, однако вся хранящаяся в фор- 
ме информация сохранится. Она может использоваться други- 
ми формами или той же самой формой, если она снова будет 
сделана видимой 


caMinimize При этом значении закрыть форму будет означать свернуть ee 
до пиктограммы. Как и в предыдущем случае, вся информа- 
ция в форме будет сохранена 


саЕгее При этом значении закрыть форму будет означать уничтоже- 
ние формы и освобождение занимаемой ею памяти. Вся ин- 
формация, содержащаяся в форме, будет уничтожена. Если 
эта форма в дальнейшем потребуется еще раз, ее надо будет 
создавать методом CreateForm 


Не все значения Action допустимы для любых форм. Например, для дочерних 
форм в приложении MDI возможны значения только CaNone и caMinimize. 

Если в обработчике события OnClose задано значение Action, равное caFree, 
то при освобождении памяти возникает еще одно последнее событие — OnDestroy. 
Оно обычно используется для очистки памяти от тех объектов, которые автомати- 
чески не уничтожаются при закрытии приложения. 

Начиная с C++Builder 4 формы имеют свойство OldCreateOrder, определяющее 
моменты событий OnCreate и OnDestroy. Если это свойство установлено в false (зна- 
чение по умолчанию), то событие OnCreate наступает после того, как закончили ра- 
боту все конструкторы компонентов, содержащихся на форме, а событие OnDestroy 
наступает прежде, чем вызывается какой-либо деструктор. При OldCreateOrder = 
true, что соответствует поведению компонентов в C++Builder 3 и более ранних, со- 
бытие OnCreate наступает при выполнении конструктора TCustomForm, а событие 
OnDestroy наступает при выполнении деструктора TCustomForm. 
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4.5.2 Модальные формы | 


Открытие форм как модальных используется в большинстве диалоговых окон. 
Модальная форма приостанавливает выполнение вызвавшей ее процедуры до тех 
пор, пока пользователь не закроет эту форму. Модальная форма не позволяет так- 
же пользователю переключить фокус курсором мыши на другие формы данного 
приложения, пока форма не будет закрыта. Так что пользователь должен выпол- 
нить предложенные ему действия прежде, чем продолжить работу. 

Модальной может быть сделана любая форма, если она делается видимой ме- 
тодом ShowModal. Если та же самая форма делается видимой методом Show, то 
она не будет модальной. 

Поведение модальной формы определяется ее основным свойством 
ModalResult. Это свойство доступно только во время выполнения приложения. 
При открытии формы методом ShowModal сначала свойство ModalResult равно 
нулю. Как только при обработке каких-то событий на форме свойству Мода! Вези 
будет присвоено положительное значение от 1 до 8, модальная форма закроется. А 
значение ее свойства ModalResult можно будет прочитать как результат, возвра- 
щаемый методом ShowModal. Таким образом программа, вызвавшая модальную 
форму, может узнать, что сделал пользователь, работая с этой формой, например, 
на какой кнопке он щелкнул. 

В C++Builder предопределены некоторые константы, облегчающие трактовку 
результатов, полученных при закрытии модальной формы: 


Численное Константа Пояснение 


| значение 
О О ИИА re 


ModalResult 
mrOk Закрытие модальной формы нажатием кнопки ОК 
или 
idOK 


mrCancel Закрытие модальной формы нажатием кнопки 
или Cancel, или методом Close, или нажатием кнопки 
idCancel системного меню в полосе заголовка окна 


mrAbort Закрытие модальной формы нажатием кнопки 
или Abort 
idAbort 


mriIgnore Закрытие модальной формы нажатием кнопки |g- — 
или поге 
idIlgnore 


Закрытие модальной формы нажатием кнопки Yes | 


Закрытие модальной формы нажатием кнопки No 


Е Закрытие модальной формы нажатием кнопки 
Retry 


mrAll. Закрытие модальной формы нажатием кнопки All 
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Все приведенные выше пояснения значений ModalResult (кроме значений 0 и 2) 
носят чисто условный характер. В своем приложении вы вольны трактовать ту или 
иную величину ModalResult и соответствующие константы как вам угодно. 

Требуемые значения ModalResult можно задавать в обработчиках соответст- 
вующих событий в компонентах модальной формы. Однако при использовании 
кнопок можно обойтись и без подобных обработчиков. Дело в том, что кнопки типа 
TButton и TBitBtn имеют свойство ModalResult, по умолчанию равное mrNone. 
Для кнопок, расположенных на модальной форме, значение этого свойства можно 
изменить и тогда не потребуется вводить каких-либо обработчиков событий при 
щелчке на них. В кнопках BitBtn при свойстве Kind, не равном bkCustom, заложе- 
ны по умолчанию значения ModalResult, соответствующие назначению той или 
иной кнопки. 

Ниже приведен пример использования модальных форм. 


4.5.3 Пример приложения с модальными формами заставки 
и запроса пароля 


Во многих больших приложениях при их запуске сначала на экране появляет- 
ся форма-заставка, содержащая логотип приложения и сведения о программе и ее 
разработчике. Назначение этой формы чаще всего заключается в том, чтобы обес- 
печить начальную загрузку и настройку программы. Тогда эта форма должна за- 
крываться не раньше, чем закончатся эти операции. Но иногда эта форма носит 
чисто информационный характер. В этих случаях желательно, чтобы она немед- 
ленно закрывалась при любых действиях пользователя и даже закрывалась через 
какое-то время без каких-либо действий со стороны пользователя. Именно такую 
форму-заставку мы и попробуем создать. 

Помимо формы-заставки нередко в приложениях, особенно в тех, которые ра- 
ботают с базами данных, в начале работы приложения появляется форма с запро- 
сом пароля. При неверном пароле приложение закрывается, не позволяя пользова- 
телю работать с ним. 

Формы-заставки и формы запроса пароля могут быть реализованы множест- 
вом различных способов. Рассмотрим один из них. 


1. Откройте в C++Builder новое приложение (File | New Application). Пусть открыв- 
шаяся форма будет главной в нашем приложении (вместо такой пустой формы 
вы можете взять любое разработанное вами ранее приложение и добавлять 
форму-заставку и форму запроса пароля в него). Назовите для определенности 
главную форму приложения FMain. 


2. Добавьте в приложение новую форму (File | New Form). Пусть это будет ваша 
форма-заставка. Назовите ее FLog. Ее свойство BorderStyle надо сделать рав- 
ным bsNone (см. раздел 4.1.3), чтобы в окне этой формы отсутствовала полоса 
заголовка. Вы можете поместить на форме какой-то рисунок (разместить ком- 
понент Image и вставить в его свойство Picture желаемый рисунок), надписи и 
т.п. В простейшем случае поместите в центре формы метку Label и напишите 
в ней какой-то текст. Размер формы-заставки задайте небольшим, меньшим, 
чем обычные окна приложения. Свойство Position следует сделать равным ро- 

ScreenCenter, чтобы форма появлялась в центре экрана. 


3. Теперь напишите обработчики событий, которые при любом действии пользо- 
вателя закрывали бы форму. Щелкните на форме, чтобы в Инспекторе Объек- 
тов открылись относящиеся к ней страницы (если у вас форма накрыта пане- 
лями или рисунками, то, щелкнув на них, нажимайте клавишу Esc до Tex пор, 
пока в Инспекторе Объектов не откроются страницы, относящиеся к форме). 
Перейдите в Инспекторе Объектов на страницу событий, выберите событие оп- 
KeyDown и напишите для него обработчик, состоящий из одного оператора — 


> italia «ia 
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Close(). Аналогичный обработчик напишите для события onMouseDown. Если 
на форме у вас имеются метки, компоненты Image и др., то выделите их все, 
задайте в событии OnMouseDown ссылку на тот же обработчик, что вы сделали 
для формы, а в форме поставьте свойство KeyPreview в true, чтобы форма пе- 
‘рехватывала все связанные с нажатием клавиш события компонентов. 


Теперь форма будет закрываться при нажатии пользователем любой клавиши 
или кнопки мыши. Давайте сделаем так, чтобы и при. отсутствии каких-то дейст- 
вий со стороны пользователя форма закрывалась сама, например, через 5 секунд. 


4. Добавьте на форму компонент Timer со страницы System. Это невизуальный 
компонент, который может отсчитывать интервалы времени (см. раз- 
дел 3.5.6). Интервал задается в свойстве компонента Interval в миллисекун- 
дах. Задайте его равным 5000. Единственное событие таймера — onTimer, на- 
ступающее по истечении заданного интервала времени. Напишите в обработ- 
чике этого события все тот же единственный оператор Close(). 


Теперь при любом действии и даже бездействии пользователя форма-заставка 
будет закрываться. Но что это означает? По умолчанию закрыть форму значит сде-. 
лать ее невидимой. Однако, форма-заставка не нужна после того, как она будет 
предъявлена пользователю в первый момент выполнения приложения. Хранить 
все время в памяти эту уже ненужную форму не имеет смысла. Поэтому в форме 
надо предусмотреть, чтобы закрытие формы означало ее удаление из памяти и ос- 
вобождение памяти для чего-нибудь более полезного. Для этого надо сделать сле- 
дующее. 

5. В событие формы OnClose вставьте оператор: 


Action = caFree; 


Как указывалось в предыдущих разделах, ‘этот оператор приводит к уничто- 
жению объекта формы и освобождению занимаемой формой памяти. 

Форма-заставка готова к использованию. Проверьте только, имеет ли ее свой- 
ство Visible значение false. Это важно, поскольку только невидимую форму можно 
открыть методом ShowModal. В главной форме свойство Visible тоже должно 
иметь значение false. 

Теперь можно записать в главной форме оператор ShowModal. Но чтобы это 
можно было сделать, необходимо сослаться в модуле главной формы на модуль 
формы-заставки. 


6. Сохраните проект, дав файлу модуля главной формы имя UMain, а файлу мо- 

дуля формы-заставки имя UFLog. Добавьте в модуль ОМашт директиву ком- 

илятора #include "UFLog.h" или выполните для модуля UMain команду File | 
Include Unit Hdr и укажите в диалоге имя включаемого модуля UFLog. 


Сохранение необходимо сделать, чтобы модули обрели свои окончательные 
имена. Иначе если вы сделаете ‘ссылку, пока модули имеют имена по умолчанию 
(Unit1 и Unit2), а потом при сохранении дадите им более осмысленные имена (это 
всегда желательно делать), то прежние ссылки на модули окажутся неверными и 
вам придется их переделывать. | 

Теперь осталось написать в модуле ОМаш обработчик события формы 
OnShow. 


7. Напишите в модуле UMain обработчик события формы OnShow, состоящий из 
одного оператора: 


FLog->ShowModal (); 


Событие OnShow наступает перед тем, как форма становится видимой. Поэто- 
му в момент выполнения указанного оператора она еще не видна. Оператор откры- 
вает форму FLog как модальную, передает ей управление и дальнейшее выполне- 


= 
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ние программы в модуле Маш останавливается до тех пор, пока модальная фор- 
ма не будет закрыта. После закрытия модальной формы выполнение программы 
продолжится и главная форма станет видимой. 

Можете сохранить проект, запустить приложение и убедиться, что все работа- 
ет правильно. 

Теперь добавим в приложение форму запроса пароля. Реальная форма такого 
типа должна предлагать пользователю ввести свое имя и пароль, сравнивать вве- 
денные значения с образцами, хранящимися где-то в системе, при неправильном 
пароле давать возможность пользователю поправиться. Если пользователь так и не 
может ввести правильный пароль, форма должна закрыть приложение, не допус- 
тив к нему пользователя. При правильном пароле после закрытия формы запроса 
должна открыться главная форма приложения. Все это не трудно сделать, но мы 
упростим задачу, чтобы не отвлекаться от главного — взаимодействия форм в при- 
ложении. Будем использовать всего один пароль, который непосредственно ука- 
жем в соответствующем операторе программы. И не будем давать пользователю 
возможности исправить введенный пароль. 


8. Добавьте к приложению новую форму. Назовите ее FPSW и сохраните ее мо- 
дуль в файле с именем UPSW. Уменьшите размер формы до разумных преде- 
лов, поскольку она будет содержать всего одно окно редактирования. Устано- 
вите свойство формы BorderStyle равным bsDialog, свойство Position равным 
poScreenCenter. В свойстве Caption напишите «Введите пароль и нажмите En- 
ter». Эта надпись будет служить приглашением пользователю. 


9. Поместите в центре формы окно редактирования Edit, в котором пользователь 
будет вводить пароль. Очистите его свойство Text. Задайте в свойстве Pass- 
wordChar символ “*". В обработчике события OnKeyDown этого компонента 
запишите оператор: 


if (Key == УК ВЕТОВМ) Close(); 


Этот оператор анализирует нажатую клавишу (подробнее об этом смотрите в 
разделе 4.3.2.2). Если нажата клавиша Enter, то считается, что пользователь завер- 
шил ввод пароля, и форма закрывается. Анализ введенного пароля откладывается 
до события OnClose. Дело в том, что, несмотря на приглашение в заголовке окна 
нажать после ввода пароля Enter, пользователь может проигнорировать это и за- 
крыть окно, например, системной кнопкой. Если он до этого ввел правильный па- 
роль, то несправедливо не проверить его, наказывая таким образом пользователя 
за непослушание. Вообще, если вы хотите создать для пользователя дружествен- 
ный интерфейс, поменьше диктуйте ему последовательность действий. Лучше ис- 
ходите из правила: «Пользователь всегда прав». И старайтесь предусмотретьфеак- 
цию на его самые неразумные (с вашей точки зрения) действия. 


10. В обработчике события OnClose формы FPSW напишите оператор 
if (Editl->Text == "1") ModalResult = 6; 


Этот оператор сличает введенный текст с паролем. В данном операторе для уп- 
рощения непосредственно указан правильный пароль — символ '1’. Если введен 
правильный пароль, то свойству ModalResult присваивается некоторое условное 
число — 6 (можно было бы выбрать и любое другое допустимое число, кроме 0 и 2). 
Если пароль неправильный, то оставляется значение ModalResult = 2 (mrCancel), 
которое автоматически присваивается при любой попытке закрыть форму. В обоих 
случаях форма закрывается, так как задание отличного от нуля положительного 
значения ModalResult равносильно закрытию формы. Но при правильном пароле 
значение ModalResult будет равно 6, а при неправильном — 2. 

На этом проектирование формы запроса пароля закончено. Теперь запишем в мо- 
иуле главной формы ОМаш оператор, показывающий пользователю эту форму и ана 
лизирующий ответ пользователя. Для этого надо выполнить следующие операции. 
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11. В модуле UMain, надо, как и ранее, добавить ссылку на модуль UPSW, авоб- 
работчике события OnShow после ранее введенного оператора FLog->Show- 
Modal() добавить оператор: 


if (FPSW->ShowModal() != 6) 
{ 


ShowMessage ("Ваш пароль неверный"); 
С1озе(); 
} 


else 


{ 
ShowMessage ("Ваш пароль '" + FPSW->EPSW->Text + "'"); 
delete FPSW; 


} 


Этот оператор анализирует значение свойства ModalResult формы запроса па- 
роля. Значение этого свойства возвращает функция FPSW->ShowModal(). Если 
результат не равен 6, то был введен неправильный пароль. Тогда главная форма, а 
с ней вместе и приложение, закрываются методом Close. При правильном пароле 
можно продолжать работу приложения. Оператор ShowMessage введен просто для 
того, чтобы показать, как можно использовать свойство другой формы — в данном 
случае текст, введенный пользователем в качестве пароля. В реальном приложе- 
нии по этому паролю можно было бы определить уровень доступа пользователя к 
конфиденциальной информации. Затем следует уничтожение формы запроса паро- 
ля операцией delete (см. главу 12 раздел 12.9). Это необходимо сделать, чтобы ос- 
вободить память. Сама по себе эта форма в момент ее закрытия не уничтожается, 
поскольку по умолчанию закрыть форму — значит сделать ее невидимой. Уничто- 
жать форму до этого момента было нельзя, так как при этом уничтожилась бы со- 
держащаяся в ней информация — введенный пароль. 

На этом разработка нашего приложения закончена. Можете сохранить проект, 
запустить приложение и посмотреть, как оно работает. 


Описанный выше способ управления формой запроса пароля не является опти- 
мальным. Он просто призван был показать, как можно обрабатывать величину 
ModalResult, возвращаемую методом ShowModal. Но то же самое можно было бы 
сделать и проще. В обработчике события OnClose формы ЕРЗУ\У/ можно было бы на- 
писать оператор: 


if (Editl->Text != "1") Application->Terminate(); 


При неверном пароле этот оператор завершает работу всего приложения мето- 
дом Application->Terminate(). Тогда в главной форме не надо анализировать ре- 
зультат работы пользователя с формой FPSW, так как если приложение не закры- 
лось при выполнении оператора ShowModal, то значит пароль введен правильный. 
Поэтому операторы в главной форме тоже упрощаются: 

FPSW->ShowModal (); 


ShowMessage ("Ваш пароль '"+FPSW->EPSW->Textt+"'") ; 
delete FPSW; 


Проведите в вашем приложении соответствующие замены. операторов и убеди- 
тесь, что приложение и в этом случае работает правильно. 


4.5.4 Управление формами в приложениях с интерфейсом 
множества документов (приложениях МО!) 


Типичным приложением MDI является привычный всем Word. В приложении 
MDI имеется родительская (первичная) форма и ряд дочерних форм (называемых 
также формами документов). Окна документов могут создаваться самим пользова- 
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телем в процессе выполнения приложения с помощью команд типа Окно | Новое. 
Число дочерних окон заранее неизвестно — пользователь может создать их столь- 
ко, сколько ему потребуется. Окна документов располагаются в клиентской облас- 
ти родительской формы. Поэтому чаще всего целесообразно в родительской форме 
ограничиваться только главным меню, инструментальными панелями и, если не- 
обходимо, панелью состояния, оставляя все остальное место в окне для окон дочер- 
них форм. При этом обычно окно родительской формы в исходном состоянии раз- 
ворачивают на весь экран. | 

Из родительской формы можно управлять дочерними формами. 

Дочернюю форму нельзя уничтожить, пока не уничтожена родительская форма. 

Требования, которые надо учитывать при разработке приложений MDI, под- 
робно рассмотрены в разделе 4.1.2. 

Для создания приложения МПТ необходимо спроектировать родительскую и 
дочернюю формы. В родительской форме свойство FormStyle устанавливается в 
fsMDIForm, а в дочерней — в fsMDIChild. Поскольку дочерние окна будет созда- 
вать сам пользователь в процессе выполнения приложения, дочернюю форму необ- 
ходимо исключить из числа создаваемых автоматически (в разделе 4.5.1 рассказы- 
валось, как это сделать с помощью окна Опций проекта). 

Рассмотрим теперь, как можно сделать обработчик команды, по которой поль- 
зователь задает в родительском окне создание нового окна документов — нового 
экземпляра дочерней формы. Этот обработчик может иметь вид: 

класс дочерней формы * имя = пем класс дочерней формы (Application); 

if (!имя) return; 

операторы настройки, если они нужны 

имя->5Пом (); 


Первый оператор процедуры создает методом пем объект дочерней формы и 
указатель на него с некоторым произвольным временным именем. Далее могут 
следовать какие-то операторы настройки нового дочернего окна. Например, ново- 
_му окну надо присвоить какой-то уникальный заголовок (свойство Caption дочер- 
ней формы), чтобы пользователь мог отличать друг от друга окна документов. По- 
следний оператор процедуры делает видимым вновь созданное окно. 

Пусть, например, вы создали в модуле Мат родительскую форму, содержа- 
щую раздел меню Окно | Новое, и создали в модуле UDoc дочернюю форму с име- 
нем FDoc, имеющую тип TFDoc (посмотреть для контроля имя и тип дочерней 
формы вы можете в верхнем выпадающем списке Инспектора Объектов, выделив 
интересующую вас форму, или в модуле, посмотрев автоматически создаваемый 
C++Builder оператор, объявляющий переменную формы и расположенный сразу 
после директив препроцессора). 

Тогда в модуль родительской формы вы должны вставить директиву препро- 
цессора, подключающую заголовочный файл дочерней формы UDoc (см. разделы 
4.5.1 и 4.5.3). А в обработчике события, связанного с выбором пользователем раз- 
дела меню Окно | Новое, можно написать операторы: ; 


TFDoc *TF = new TFDoc (Application) ; 
1-ой тобига: 


TF->Show (); 


В родительской форме имеется ряд свойств, позволяющих управлять дочерни- 
ми окнами. Все они доступны только для чтения и только во время выполнения. 

Свойство MDIChildCount определяет количество открытых дочерних окон. 
Приведем оператор, который можно вставить в предыдущий пример для задания 
уникального имени вновь созданного окна TF: 


TF->Caption = "Документ " + IntToStr(MDIChildCount) ; 
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Свойство MDIChildrenfint i] дает доступ к 1-му окну (окна индексируются в 
порядке их создания, последнее созданное окно имеет индекс 0). Однако, во время 
работы пользователя с окнами индексация может измениться. Поэтому можно ре- 
комендовать использовать индексы только в циклах при проведении некоторых 
операций сразу со всеми дочерними окнами. Следующий пример показывает про- 
цедуру, с помощью которой из родительской формы Form1 можно закрыть (свер- 
нуть) все дочерние окна, начиная с последнего: 

for’ (int i = MDIChildCount-1; i >= 0; i-) 

MDIChildren[i]->Close(); 


В момент создания окон документов они автоматически располагаются каска- 
дом в клиентской области родительской формы. При этом, если размера клиент- 
ской области не хватает для размещения дочерних окон, размеры последних авто- 
матически уменьшаются. Имеется ряд методов родительской формы, упорядочи- 
вающих размещение дочерних окон. Метод Cascade располагает все открытые (не 
свернутые) окна каскадом. Метод Tile располагает окна мозаикой. При этом учи- 
тывается свойство родительской формы TileMode. Если оно равно tbhVertical, то 
упорядочивание производится по вертикали, а если TileMode равно tbHorizontal, 
то упорядочивание производится по горизонтали. Метод Arrangelcons упорядочи- 
вает расположение пиктограмм свернутых окон. 

Отдельно надо упомянуть об объединении главных меню родительской и до- 
черних форм. Обычно обе эти формы имеют главные меню, но они различны. На- 
пример, родительская форма может иметь меню Окно, а дочерняя форма — меню 
Файл и Правка. Меню дочерних форм не должно появляться в окнах документов, а 
должно всегда встраиваться в главное меню родительской формы. Поэтому свойст- 
во AutoMerge компонента типа TMainMenu на приложения MDI не влияет: 
встраивание меню происходит независимо от значения этого свойства. А места, на 
которые встраиваются разделы меню дочерней формы, определяются значениями 
свойства GroupIndex каждого раздела меню так же, как это имеет место в обыч- 
ных многооконных приложениях при задании свойства AutoMerge равным true 
(см. раздел 3.6.1 главы 3). 


4.5.5 Пример приложения с интерфейсом множества 
документов — простой многооконный редактор 


Рассмотрим проектирование простого приложения МПТ. Пусть мы хотим соз- 
дать многооконный редактор, в каждое окно которого можно загрузить содержи- 
мое заданного входного текстового файла, что-то в нем изменить и сохранить текст 
в заданном выходном файле (рис. 4.16). 

Обратите внимание на следующие требования к интерфейсу МПТ, проиллюст- 
рированные на рис. 4.16. 


> 
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Если новое окно открывается без загрузки текста из файла, заголовок окна должен содер- 
жать уникальное имя типа «Документ...» или «Окно ...», где вместо многоточия должен быть 
неповторяющийся номер окна. Если в окно загружается текст из файла, то заголовок окна 
должен содержать имя АНН ое 


О О О авы 


Хороший с стиль ‚ программирования BOLLE LT EE о ао 


Когда окно документа развертывается, его имя. должно включаться в заголовок главного 
окна a (рис. 4. 16 в) Ni счастью, Че производит эту операцию автоматически. 


а а а ай 
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ЛИКА нь SELLE ERLE LES В LDCR LS 


Хороший стиль программирования 


Меню Окно должно завершаться разделами, содержащими список открытых окон (см. 
рис. 4.16 в). Как это сделать — рассказано в главе 3 в разделе 3.6.1 и будет повторено в 
рассматриваемом примере. 
Построим дочерние окна с использованием компонентов RichEdit, но для про- 
стоты не будем тратить время на разработку сервиса, необходимого в реальных ре- 
дакторах. Более серьезный пример имеется на прилагаемом к книге диске. 


о ECE IE ET EE NEL TE BES NS рр LLM SORE LS GEE LEE OTT HE 


EUR ORL GEG ET LEE RY 


Puc. 4.16 

Пример простого приложения MDI: 
многооконный редактор в режимах 
упорядочивания окон каскадом (а), по 
вертикали (6), с развернутым окном Р`тойст локанойта 3 
документа (в) 


кчмент 1] 


Начнем с построения формы окна документа. 
1. Откройте в C++Builder новое приложение. 
2. Назовите открывшуюся форму FDoc. 


3. Разместите на форме компонент RichEditl типа TRichEdit. Его свойство Align 
задайте равным alClient, чтобы окно редактирования заняло всю площадь 
окна. Сотрите текст, появившийся в RichEdit1 (свойство Lines). 


4. Разместите на форме по одному компоненту типов TOpenDialog и TSaveDialog 
(см. раздел 3.8.2). Задайте в обоих диалогах свойства DefaultExt равными rtf, 
а в свойства Filter занесите строку «текстовые. файлы». с шаблоном 
«* rtf;*.txt» и строку «все файлы» с шаблоном «*.*». 


рады nani ой 
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5. Разместите на форме компонент типа MainMenu. Создайте в нем раздел Файл 
(присвойте его свойству Маше значение MFile) с подразделами Открыть (Мате 
= MOpen) и Сохранить как (Name = М$ауе). 


6. Теперь напишите обработчики событий для введенных подразделов меню. Для 
раздела МОреп обработчик может иметь вид: 


if (OpenDialog1l->Execute() ) 
{ 
RichEdit1l->Clear () ; 
RichEdit1l->Lines->LoadFromFile (OpenDialogl->FileName) ; 
} 


Для раздела MSave обработчик может иметь вид: 


if (SaveDialogl->Execute() ) | 
RichEdit1->Lines->SaveToFile (SaveDialogl->FileName) ; 


7. Сохраните проект, дав спроектированному модулю имя UDoc. 


Простенький редактор (пока однооконный) построен. Можете скомпилировать 
его и проверить в работе. 

Теперь давайте спроектируем родительскую форму и превратим наш одно- 
оконный редактор в многооконный. 


8. Измените свойство FormStyle созданной вами ранее формы на fsMDIChild. 


9. Откройте в вашем проекте новую форму (File | New Form). Назовите ее FMDI. Со- 
храните ее модуль с именем UMDI (File | Save As). 


10. Измените свойство FormStyle новой формы на fsMDIForm. Задайте свойство 
WindowState равным wsMaximized, чтобы окно этой формы предъявлялось 
пользователю в первый момент развернутым на весь экран. Введите (вручную 
или командой File | Include Unit Hdr) директиву препроцессора #include, ссылаю- 
щуюся на заголовочный файл UMDI.h модуля UMDI. Иначе вы не сможете от- 
крывать дочерние формы и управлять ими. 


11. Выполните команду Project | Options и в открывшемся окне на странице Forms 
переведите дочернюю форму FDoc из списка автоматически создаваемых в 
список доступных форм. При этом, как вы сможете убедиться по выпадающе- 
му списку вверху окна, главной станет родительская форма UMDI — единст- 
венная, оставшаяся в списке автоматически создаваемых форм. 


12. Введите на форму UMDI компонент типа MainMenu. Сформируйте в нем раз- 
дел меню Окно (имя Name = MWind) с подразделами Новое (Name = MNew), 
Каскад (Name = MCascade), Упорядочить по горизонтали (Name = MHor), Упорядо- 
чить по вертикали (Name = MVert), Упорядочить значки (Name = МТеопз). Свойст- 
во формы WindowMenu установите равным MWind. Это обеспечит появление 
внизу меню Окно разделов, содержащих список открытых окон. 


Чтобы введенные разделы меню не заменялись во время выполнения раздела- 
ми меню дочернего окна, необходимо задать им всем значения свойства Group- 
Index, отличные от TEX, которые имеют разделы меню дочерней формы. Если этого 
не сделать, то в процессе выполнения при открытии первого же дочернего окна 
меню Окно заменится на меню дочерней формы Файл. Следовательно, дальнейшее 
управление окнами будет потеряно. Это произойдет потому, что по умолчанию зна- 
чения свойства GroupIndex для всех разделов всех меню равно 0. 

Если мы хотим, чтобы в процессе выполнения приложения меню дочерней 
формы Файл встраивалось перед меню Окно, необходимо всем разделам меню Окно 
присвоить значение GroupIndex, большее, чем 0, соответствующий разделам до- 
чернего меню. | | 
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13. Во всех введенных разделах меню Окно установите свойство GroupIndex рав- 
‚ным 1. 


14. Запишите обработчик события OnClick для раздела меню Новое (MNew). Этот 
обработчик может иметь вид, уже рассмотренный в предыдущем разделе: 


void _fastcall TFMDI::MNewClick(TObject *Sender) 


{ 

TFDoc* TF = new TFDoc (Application) ; 

if (!TF) return; 

TF->Caption = "Документ " + IntToStr(MDIChildCount) ; 
“TF->Show(); 
} 


15. Внесите операторы в обработчики событий OnClick для остальных разделов 
меню. Для раздела Каскад: 


Сазсаае (); 


Для раздела Упорядочить по горизонтали: 


TileMode = tbHorizontal; 
pee eB, 


Для раздела Упорядочить по вертикали: 


TileMode = tbVertical; 
Tile(); 


Для раздела Упорядочить значки: 


АггапдеТсопз (); 


На этом проектирование многооконного редактора завершено. Можете сохра- 
нить проект и опробовать приложение в работе (см. рис. 4.16). Посмотрите, как ве- 
дет себя приложение при создании нового окна документа, если размеры родитель- 
ского окна не достаточно велики. Проверьте, что было бы, если бы вы не изменили 
свойство GroupIndex в меню родительского окна или если форма документов име- 
ла бы свойство FormStyle равное fsNormal. Вообще поэкспериментируйте с этим 
приложением, чтобы уяснить все особенности приложений MDI. 


4.5.6 Объект $сгееп и приложения, работающие 
с нескольким мониторами 


В приложении C++Builder автоматически создается глобальный объект 
Screen (экран) типа TScreen, свойства которого определяются из информации 
Windows о мониторе, на котором запускается приложение. Вы можете в любом 
приложении использовать, например, такие свойства объекта Screen, как 
Height — высота экрана и Width — его ширина. Это, в частности, может потребо- 
ваться, если вы задаете значение свойства своих форм Position таким, что размеры 
форм остаются постоянными. Так как вы используете в процессе проектирования 
один тип монитора, а приложение в дальнейшем может работать на мониторе дру- 
гого типа, то не исключено, например, что ваша форма не поместится на экране 
или наоборот — будет слишком маленького размера для данного монитора. Чтобы 
избежать этих неприятностей, можно автоматически масштабировать свою форму, 
вводя, например, в обработчик ее события OnCreate код: 


Width = Screen->Width / 2; 
Height = Screen->Height / 2; 


Этот код задает размеры формы равными половине соответствующих размеров 
экрана. 
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Разрешающую способность экрана можно определить, воспользовавшись 
свойством PixelsPerInch, указывающим количество пикселей экрана на дюйм в 
вертикальном направлении. Это справедливо именно для вертикального направле- 
ния, поскольку во многих мониторах коэффициенты масштабирования по гори- 
зонтали и вертикали различаются. 

Screen имеет свойство Forms[int Index], содержащее список форм, отображае- 
мых в данный момент на экране, и свойство FormCount, отражающее количество 
таких форм. Вы можете использовать это свойство, например, для того, чтобы га- 
рантировать, что на данном типе монитора размеры ни одной формы не превысят 
размеров экрана. Соответствующий код может выглядеть так: 


for (int i = 0; i < Screen->FormCount; i++) 
{ 
if (Screen->Forms[i]->Height > Screen->Height) 
Screen->Forms[i]->Height = Screen->Height - 100; 
if (Screen->Forms[i]->Width > Screen->Width) 
Screen->Forms[i]->Width = Screen->Width - 100; 
} 


Размеры форм, превышающие размер экрана, урезаются этим кодом с запасом 
в 100 пикселей. 

В приведенных примерах надо, конечно, предусмотреть, чтобы при изменении 
размеров формы адекватно изменялось и расположение компонентов на ее поверх- 
ности. Этот вопрос подробно рассмотрен в разделе 4.2. 

Так же, как к формам, можно получить доступ и к модулям данных (см. раз- 
дел 9.11.9). Свойство DataModulesfint Index] содержит список всех существую- 
щих на текущий момент модулей данных приложения, а параметр DataModule- 
Count указывает число таких модулей. Эти параметры можно использовать в сово- 
купности для поиска по всем модулям данных приложения. 

Еще одно полезное свойство объекта Screen — Fonts (шрифты). Это свойство 
типа TStrings содержит список шрифтов, доступных на данном компьютере (свой- 
ство только для чтения). Его можно использовать в приложении, чтобы проверять, 
имеется ли на компьютере тот или иной шрифт, используемый в приложении. 
Если нет — то можно или дать пользователю соответствующее предупреждение, 
или сменить шрифт в приложении на один из доступных, или дать пользователю 
возможность самому выбрать соответствующий шрифт. Например, вы можете по- 
местить в вашем приложении компонент списка TComboBox и при событии формы 
OnCreate загрузить его доступными шрифтами с помощью операторов: 


ComboBox1l->Items = Screen->Fonts; 
ComboBoxl->ItemIndex = 0; 


Тогда в нужный ‘момент пользователь может выбрать подходящий шрифт из 
списка, а для того, чтобы этот шрифт использовался, например, для текста в ком- 
поненте RichEdit1, в обработчик события OnClick или OnChange списка вставьте 
операторы: 

RichEdit1->SelAttributes->Name = 


ComboBox1l->Items->Strings [ComboBox1->ItemIndex] ; 
RichEdit1l->SetFocus(); 


Если хотите использовать выбранный шрифт для всех компонентов формы, в 
которых свойство ParentFont установлено в true, то приведенный выше оператор 
должен иметь вид: 


Font->Name = ComboBox1->Items->Strings [CorboBoxl->ItemIndex] ; 


Свойство Cursor объекта Screen определяет вид курсора. Если это свойство 
равно crDefault, то вид курсора при перемещении над компонентами определяется 
установленными в них свойствами Cursor. Но если свойство Cursor объекта Screen 
отлично от crDefault, то соответствующие свойства компонентов отменяются и 
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курсор имеет глобальный вид; заданный в Screen. Этим можно воспользоваться 
для такой частой задачи, как изменение курсора на форму «песочные часы» во 
время выполнения каких-то длинных операций. Подобное изменение формы кур- 
сора можно оформить следующим образом: 

Screen->Cursor = crHourGlass; 

try 

{ 


// выполнение требуемых длинных операций 


} 


Gaten (;:. ¢) 

{ | 

_ЭЗсгееп->Сигзог = crDefault; // восстановление курсора 
throw; 

} 

Screen->Cursor = crDefault; 


При успешном или аварийном (см. раздел 12.10) окончании длинных опера- 
ций курсор в любом случае возвращается в значение по умолчанию. 

Если в приложении в какие-то отрезки времени используется отличный от 
crDefault глобальный вид курсора, то приведенный код можно изменить, чтобы по 
окончании длинных операций восстановить прежнее глобальное значение: 


TCursor ‘Save Сагзог =' Screen->Cursor; 
Screen->Cursor = crHourGlass; 
try 


{ 
// выполнение требуемых длинных операций 


} 


саксы. (...) 

{ 
Screen->Cursor = Save Cursor; 
throw; 

} 

Screen->Cursor = Save Cursor; 


Имеется также свойство Cursors[ I ], которое представляет собой список дос- 
тупных приложению курсоров. Вы можете создать и использовать также свой соб- 
ственный курсор. Создается он и включается в ресурс приложения встроенным в 
C++Builder Редактором Изображений (Image Editor). Как работать с этим редакто- 
ром при создании курсора поясняется в разделе 5.1.2.4 главы 5. А регистрируется 
созданный вами курсор с помощью функции LoadCursor. Сделать это можно сле- 
дующим образом. | 

Пусть, например, вы создали свой курсор и включили его в ресурс приложе- 
ния под именем NEWCURSOR. Тогда в своем приложении вы можете ввести гло- 
бальную константу, обозначающую ваш курсор. Например: 


const crMyCursor = 1; 


Значение этой константы может лежать в пределах oT -32768 до 32767. Ho 
важно, чтобы она не совпадала с предопределенными значениями стандартных 
курсоров, лежащими в диапазоне от 0 до -21. 

В обработчике события OnCreate формы вы можете ввести оператор, регистри- 
рующий ваш курсор в свойстве Cursors: 


Screen->Cursors[crMyCursor]=LoadCursor (HInstance, "NEWCURSOR") ; 


Обратите внимание Ha то, что имя курсора пишется обязательно заглавными 
буквами, так как именно так хранятся имена курсоров в ресурсах приложения. 

В нужный момент вы можете установить этот курсор в качестве глобального 
оператором 


Screen->Cursor = crMyCursor; 


ры .—” 
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а затем восстановить значение глобального курсора оператором 


Screen->Cursor = crDefault; 


Вы можете использовать ваш зарегистрированный курсор и как локальный, 
например, для панели Panell оператором 


Panell->Cursor = (TCursor)crMyCursor; 


Пример использования различных курсоров вы найдете в разделе 5.1.6 главы 5. 

С помощью Screen можно получить доступ к активной в текущий. момент фор- 
ме вашего приложения через свойство ActiveForm. Если в данный момент пользо- 
ватель переключился с вашего приложения на какое-то другое и, следовательно, 
ни одна форма вашего приложения не активна, то ActiveForm указывает на фор- 
му, которая станет активной, когда пользователь вернется к вашему приложению. 
В момент переключения фокуса с одной вашей формы на другую, генерируется со- 
бытие OnActiveFormChange. 

Аналогично с помощью свойства ActiveControl можно получить доступ к ак- 
тивному в данный момент оконному компоненту на активной форме. При смене 
фокуса генерируется событие OnActiveControlChange. 

Начиная с C++Builder 4 предусмотрена возможность разработки мультиэ- 
кранных приложений, работающих одновременно с множеством мониторов. При 
этом приложение может решать, какие формы и диалоги надо отображать на том 
или ином мониторе. Свойства различных мониторов, используемых в таком при- 
ложении, можно найти с помощью свойства Screen->Monitors[ I ], где I — индекс 
монитора. Индекс 0 относится к первичному монитору. Свойство Screen->Moni- 
tors[ I ] является списком объектов типа TMonitor, содержащих информацию о 
конкретных мониторах. 

Среди свойств объектов типа TMonitor имеются Height — высота и Width — 
ширина экрана монитора. Кроме того имеются свойства Left и Тор. Эти свойства 
означают следующее. Все доступное экранное пространство можно представить 
себе разбитым на экраны отдельных мониторов, размещающихся слева направо и 
сверху вниз. Соответственно свойства Left и Тор определяют координаты левого 
верхнего угла экрана монитора в этом логическом экранном пространстве. Объек- 
ты типа TMonitor имеют также свойство MonitorNum — номер монитора, пред- 
ставляющий собой его индекс в свойстве Screen->Monitors[ I ]. 

Для управления тем, на каком мониторе должна появляться та или иная фор- 
ма, служит свойство формы DefaultMonitor. Это свойство может принимать значе- 


ния: 


dmDesktop He предпринимается попыток разместить форму на конкрет- 
ном мониторе 

dmPrimary форма размещается на первом мониторе в списке Screen->Mo- 
nitors 

dmMainForm форма появляется на том мониторе, на котором размещена 


главная форма 


dmActiveForm форма появляется на том мониторе, на котором размещена те- 
кущая активная форма 


Mo 
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4.6 Печать в C++Builder 


Печать в C++Builder может осуществляться различными способами. В данном 
разделе обсуждаются простые способы печати текстов и изображений. Составление 
и печать сложных отчетов рассмотрены в главе 11 в разделе 11.2. 


4.6.1 Печать форм методом Print 


Формы в C++Builder имеют метод Print, который печатает клиентскую об- 
ласть формы. При этом полоса заголовка формы и полоса главного меню не печата- 
ются. Таким образом, можно включить в приложение форму, в которой пользова- 
тель во время выполнения размещает необходимые для печати результаты: тексты 
и изображения. Если имя этой формы Form?2, то ее печать может выполняться опе- 
ратором 


Form2->Print(); 


Свойство формы PrintScale определяет опции масштабирования изображения 
при печати. Возможные значения PrintScale: 


о О а а а аи ыыы 
роМопе Масштабирование не используется. Размер изображения мо- 
жет изменяться в зависимости от используемого принтера 


poProportional Делается попытка напечатать изображение формы того же 
размера, который виден на экране 


poPrintToFit Увеличивает или уменьшает размер изображения, подгоняя 
его под размер страницы, заданный при установке принте- 
ра. Это значение принято по умолчанию 


4.6.2 Методы компонентов, обеспечивающие печать 


Ряд компонентов в C++Builder имеют методы, обеспечивающие печать храня- 
щихся в них данных. Например, компонент RichEdit имеет метод Print, позво- 
ляющий печатать в обогащенном формате текст, хранящийся в компоненте. В этот 
метод передается единственный параметр типа строки, назначение которого за- 
ключается только в том, что при просмотре в Windows очереди печатаемых зада- 
ний принтера эта строка появляется как имя задания. Например, оператор 


RichEdit1l->Print ("Printing of RichEdit1"); 


обеспечивает печать текста компонента RichEdit1, причем задание Ha печать полу- 
чает uma «Printing of RichEditl». 

Печать воспроизводит все заданные особенности форматирования. Перенос 
строк и разбиение текста на страницы производится автоматически. Длина строк 
никак не связана с размерами компонента RichEdit, содержащего этот текст. 

Печатью через RichEdit можно воспользоваться и для печати файлов докумен- 
тов в текстовом формате или в формате RTF. Для этого надо последовательно вы- 
полнить оператор загрузки файла в компонент и оператор печати загруженного 
текста. Например: 


RichEdit1->Lines->LoadFromFile ("Test.txt"); 
RichEditl->Print("neuatp файла Test.txt"); 


или 


RichEdit1->Lines->LoadFromFile("Test.rtf£"); 
RichEdit1l->Print("neuatTp файла Test.rtf"); 
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Компонент Chart, используемый для отображения графиков и диаграмм (cM. 
раздел 3.4.6), также имеет метод Print, обеспечивающий печать. Предварительно 
может быть выполнен метод PrintPortrait, задающий книжную (вертикальную) 
ориентацию бумаги, или метод PrintLandscape, задающий альбомную (горизон- 
тальную) ориентацию. Масштабировать размер печатаемого графика можно, вы- 
звав предварительно метод PrintRect, 


procedure PrintRect ( Const В : TRect ) ; 


в котором параметр В, определяет размер области принтера, в которой осуществля- 
ется печать. 

Компонент Chartfx (см. раздел 3.4.7) имеет быструю кнопку печати (пятая 
слева в инструментальной панели рис. 3.25), с помощью которой пользователь в 
любой момент может напечатать текущий график или диаграмму. 


4.6.3 Печать средствами офисных приложений Windows 
с помощью функции ShellExecute и обращения 
к серверам СОМ 


Для печати файлов средствами стандартных офисных приложений Windows 
можно использовать функцию ShellExecute. Подробно 06 этой функции см. раз- 
дел 6.1.4. А здесь мы коротко рассмотрим технологию такой печати без каких-ли- 
бо дополнительных пояснений. 

Чтобы воспользоваться функцией ShellExecute, надо ввести в модуль дирек- 
тиву препроцессора 

#include "ShellApi.h" 


которая подключает заголовочный файл ShellApi.h, содержащий объявление фун- 
кции ShellExecute и некоторых других функций Windows API. Функция ShellExe- 
cute при соответствующем задании ее параметров ищет по расширению заданного 
для печати файла соответствующую ему системную программу Windows, и, если 
находит, то осуществляет печать. Например, обычно Windows настроен так, что 
файлам с расширением .txt соответствует программа Notepad, а файлам с раситире- 
нием .doc — Word. В этом случае выполнение оператора 


ShellExecute (Handle, "print", "Test.txt",NULL,NULL,SW_HIDE) ; 


вызовет печать файла с именем test.txt средствами программы Notepad, a оператор 
ShellExecute (Handle, "print", "Test.doc",NULL,NULL,SW_ HIDE); 


вызовет печать файла с именем test.doc средствами программы Word. 

Этот способ печати можно использовать как для распечатки заранее создан- 
ных файлов, так и для распечатки файлов, созданных во время выполнения при- 
ложения методами SaveToFile, имеющимися у многих компонентов. 

Имеется также возможность печатать тексты и графику средствами стандарт- 
ного редактора Windows Word или средствами Excel. Для этого в C++Builder 5 
имеются компоненты — серверы СОМ, позволяющие сначала создать документ со- 
ответствующего. приложения Windows, а затем его напечатать. Эти возможности 
рассмотрены в главе 6 в разделе 6.4.4. 


4.6.4 Печать с помощью объекта Printer 


В C++Builder имеется класс печатающих объектов TPrinter, который обеспе- 
чивает печать текстов, изображений и других объектов, расположенных на его 
канве — Canvas. Свойства канвы подробно рассмотрены в разделе 5.1.3 и здесь мы 
не будем на них останавливаться. Достаточно знать, что на канве могут разме- 
щаться различные изображения и текст. ° 
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Класс объектов TPrinter объявлен в модуле Printers. Поэтому для работы с 
этим классом надо включить в текст директиву препроцессора | 
#include <Printers.hpp> 


Рассмотрим некоторые свойства и методы объекта типа TPrinter. 


| Canvas Канва Canvas — место в памяти, в котором формируется 

| страница или документ перед печатью. Canvas обладает ря- 

| дом свойств, включая Pen (перо) и Brush (кисть), которые 

| разделе 5.1.3 

| TextOut Метод канвы, который позволяет посылать в нее текст 

аи es Метод канвы, который позволяет посылать в нее изображение 
PageHeight | Высота страницы в пикселях 

| Page Width Ширина страницы в пикселях 

| NewPage Принудительно начинает новую страницу на принтере 


позволяют вам делать рисунки и помещать на них текст. По- 
BeginDoc Используется для начала задания печати 
| PageNumber Возвращает текущий номер печатаемой страницы 


| Свойство, метод | Описание 

дробное описание канвы и методов работы с ней вы найдете в 
| Используется для окончания задания печати. Фактическая 
| печать происходит только при вызове EndDoc 


Предположим, вы хотите напечатать текст и изображение, используя печа- 
тающий объект. Изображение размещено на форме в компоненте Imagel. Вы мо- 
жете осуществить эту печать следующим кодом: 

TPrinter *Prntr = Printer(); 

Prntr->Canvas->Font->Size = 12; 

Prntr->BeginDoc();_ 

Prntr->Canvas->TextOut (10,10,"Я печатаю через объект Printer"); 

Prntr->Canvas~->Draw ( 

(Prntr->PageWidth — Imagel->Picture->Bitmap->Width) /2, 
40, Imagel->Picture->Bitmap) ; 
Prntr->EndDoc(); 


„Первый оператор этого кода использует функцию Printer, которая создает 
глобальный объект типа TPrinter. В том же операторе создается указатель на этот 
объект Prntr. 

Следующий оператор задает размер шрифта канвы принтера. Затем функция 
BeginDoc запускает задание на печать. Следующий оператор посылает на канву 
принтера с помощью метода канвы TextOut, начиная с точки с координатами (10, 
10), текст «Я печатаю через объект Printer». Следующий оператор методом Draw 
рисует на канве принтера изображение. При этом изображение выравнивается по 
горизонтали на середину страницы. Координата верхней стороны изображения за- 
дается равной 40. 

В заключение метод EndDoc вызывает печать текста и изображения и останав- 
ливает задание на печать. 

Печатающий объект Printer не производит автоматического переноса строк и 
разбиения текста на страницы. Поэтому печать длинных текстов с помощью объ- 
екта Printer требует достаточно сложного программирования. Проще это делать 
описанными ранее способами или с помощью системы QuickReport, которая описа- 
на в разделе 11.2. 
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4.7 Развертывание приложений 


4.7.1 Оформление завершенного проекта 


4.7.1.1 Задание учетной информации о версии завершенного 
приложения 


Если вы делаете приложение, которое в дальнейшем будет распространяться 
среди пользователей, вы обязаны снабдить его положенной учетной информацией ` 
о версии данного продукта, о его назначении и т.д. Впрочем, и для самого себя по- 
лезно указывать подобную информацию, чтобы не запутаться в многочисленных 
версиях разрабатываемого приложения: 

Для задания или просмотра этой информации надо выполнить команду Project | 
Options и в открывшемся окне опций проекта перейти на страницу Version Info 
(рис. 4.17). Указанная на данной странице информация заносится в выполняемый 
файл и становится доступна пользователю, когда он щелкает правой кнопкой 
мыши на пиктограмме вашего приложения и выбирает команду Свойства. Тогда в 
открывшемся диалоговом окне на странице Версия пользователь может увидеть 
информацию о вашем приложении (см. рис. 4.18). 


Рис. 4.17 Project Options 
Страница Version Info окна Project Options Paw ot 


ee eae 
‘Nporpamma прекрасная 


Рис. 4.18 
Информация о приложении, которую видит 
пользователь, работая в Windows 


"Имя элемент 
[Версия 
4B 
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Основная опция страницы Version Info — Include version information in project. Если 
она не установлена, то все окна страницы доступны только для чтения. Это позво- 
ляет просто посмотреть информацию о версии вашего прошлого приложения, 
если, конечно, вы позаботились о том, чтобы ввести ее в приложение. Если же вы 
установите опцию Include version information т project, то все окна страницы станут 
доступны для ввода информации. 


Окна группы Module Version Number позволяют вам задать номер версии, со-: 


стоящий из четырех цифр, разделенных точками. Например, 2.3.1.0. Этот номер 
пользователь видит в верхней части окна (рис. 4.18). Индикатор Auto-increment build 
number позволяет автоматизировать изменение последней из этих цифр. Если вы 
включили этот индикатор, последняя цифра будет увеличиваться на единицу каж- 
дый раз, когда вы будете выполнять команду Project | Build All. При других командах 
компиляции цифра изменяться не будет. 

Группа индикаторов Module Attributes указывает назначение версии. Эти инди- 
каторы можно заполнять для себя в чисто информационных целях, например: 
Debug Build — отладка, Pre-Release — версия не для коммерческого использования, 
DLL — проект DLL, Special Build — версия получена в стандартном режиме компиля- 
ции, Private Build — версия построена не в стандартном режиме компиляции. 

Окно Language указывает кодовую страницу системы пользователя, которая 
нужна для запуска приложения, т.е. указывает язык. Соответственно в окне 
‘рис. 4.18 при выделении пользователем строки Язык он увидит язык приложения 
(константа 0х0419 соответствует русскому языку). Окно Language заполняется ав- 
томатически в зависимости от установленной в системе кодовой страницы. 

Список Key/Value включает в себя стандартные сведения о программном про- 
‚дукте: CompanyName (Производитель), FileDescription (Описание — в окне рис. 4.18 
вторая строка вверху окна), FileVersion (Версия продукта), InternalName (Внутреннее 
имя), LegalCopyright (Авторские права — в окне рис. 4.18 третья строка вверху 
окна), Legallrademarks (Товарные знаки), OriginalFilename (Исходное имя файла), 
ProductName (Название продукта), ProductVersion (Версия продукта), Comments (За- 
метки). В этом перечислении в скобках указаны заголовки, которые пользователь 
видит в окне рис. 4.18. Перемещая курсор в этом окне, пользователь может читать 
то, что вы занесли в список Key/Value. Вообще говоря, для коммерческого продукта 
все строки списка, кроме LegalCopyright, Legallrademarks и Comments, должны запол- 
няться, а эти три строки могут заполняться при необходимости. 


4.7.1.2 Интернационализация приложения 


Если вы предназначаете свое приложение для международного рынка или 
хотя бы для международной демонстрации, вам надо позаботиться о его интерна- 
ционализации. Надо, чтобы в зависимости от того, какой язык установлен в 
Windows на конкретном компьютере, ваше приложение автоматически разговари- 
вало бы на этом языке. 

Начиная с C++Builder 5 подобная интернационализация приложений сущест- 
венно облегчилась. Правда, для этого надо спроектировать приложение так, чтобы 
оно поддавалось интернационализации. Для этого.надо изолировать все ресурсы, 
которые должны изменяться в процессе локализации. То есть перенести в файлы 
.dfm и .res все, что может изменяться при смене языка. Например, все тексты, ис- 
пользуемые в приложении, надо перенести в ресурсы с помощью ключевого слова 
resourcestring. | 

Все далее изложенное вы можете применить к любому из имеющихся у Bac при- 
ложений. Но лучше давайте разработаем чисто демонстрационное приложение, что- 
бы на его примере рассмотреть методику интернационализации. Откройте новое 
приложение, поместите на форму две метки, список ListBox, кнопку, компонент 
MainMenu. Можете также поместить на форму полосу состояния StatusBar и ком- 
понент ApplicationEvents, заносящий в эту полосу подсказки Hint компонентов. 
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Задайте какой-нибудь русский текст в заголовке формы (свойство Caption), 
например, «Интернационализация». Занесите какие-то строки в список ListBox, 
сделайте надписи на первой метке и на кнопке. Задайте тексты ярлычков и под- 
сказок компонентов в их свойствах Hint. Задайте значения true в свойствах 
ShowHint компонентов. Задайте также какие-то разделы меню. Все это может вы- 
глядеть так, как показано на рис. 4.19. 

Теперь давайте напишем пару операторов, чтобы наше приложение могло 
что-то делать. В обработчик события OnHint компонента ApplicationEvents зане- 
сите оператор 


StatusBarl->SimpleText = Application->Hint; 


Этот оператор, рассмотренный в разделе 4.1.9, отобразит в панели состояния 
подсказки Hint. 
В обработчик события OnClick кнопки занесите код 


if (ListBoxl->ItemIndex >= 0) 
Label2->Caption = "Выбрана строка '" + 
ListBoxl->Items->Strings [ListBoxl->ItemIndex] + "'"; 
else Label2->Caption = "Выбор не сделан"; 


Этот код отображает в метке Label2 строку, выбранную пользователем в спи- 
ске ListBox1. 
Рис. 4.19 6) If 
Приложение при 
установленном русском (а) и 
английском (6) языке (при 
русифицированной версии 
Windows) 


om Edit 
3 ListBox 
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‚ {Line 2 И 


ый 
Selected line ‘Line cn 


Приложение завершено. Сохраните его, выполните и убедитесь, что все рабо- 
тает. Можете, конечно, придумать какое-нибудь свое более интересное приложе- 
ние. Важно, чтобы в нем были русские надписи на компонентах формы и какие-то 
русские тексты в коде (в нашем случае это тексты в обработчике события кнопки 
OnClick). 

Теперь давайте подготовим ваше приложение к интернационализации. Основ- 
ное требование к приложению, которое должно разговаривать на разных язы- 
ках — изоляция ресурсов. В самом выполняемом модуле никаких текстов и ника- 
ких изображений, которые должны изменяться в зависимости от языка, не долж- 
но быть. Все, что может подвергаться изменениям, должно быть вынесено в дина- 
мически присоединяемые библиотеки. Тогда приложение в зависимости от лока- 
лизации Windows, установленной на конкретном компьютере, сможет подключать 
соответствующую этой локализации библиотеку. 

C++Builder 5 обеспечивает изоляцию файлов изображений форм .dfm, и фай- 
лов ресурсов „ге, в которых могут размещаться тексты. Следовательно, обо всех 
текстах, отображаемых в компонентах формы, заботиться не надо. Они автомати- 
чески будут изолированы вместе с файлом формы. А вот для изоляции текстов, 
имеющихся в приложении, надо принимать специальные меры. Такая изоляция 
может быть сделана несколькими способами. Наиболее напрашивающийся вари- 
ант — ввести в приложение невидимый список ListBox, занести в него требуемые 
строки и извлекать их оттуда, когда потребуется сделать пользователю какое-то 
сообщение. Это просто, но не очень удобно для программирования, так как придет- 
ся оперировать не идентификаторами строк, а их индексами в списке. К тому же 
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такой вариант неэкономичен, так как приходится хранить не просто строки, a це- 
лый компонент со всеми его атрибутами. | 

Другой вариант изоляции строк — занести их в файл ресурсов. Это, в частно- 
сти, можно сделать, введя в приложение модуль на языке Pascal, в котором с помо- 
щью ключевого слова resourcestring занести требуемые строки в файл ресурсов 
.res. Рассмотрим подробнее этот вариант на примере нашего приложения. 

Текст соответствующего файла на языке Разса] может иметь вид: 

unit <имя файла>; 

interface 

resourcestring 

// список строк вида идентификатор = строка 

implementation 

begin 

end. 

Например, в нашем случае требуется перенести в файл ресурсов две строки: 
«Выбрана строка ‘'› и «Выбор не сделан». Дадим им идентификаторы SSel и 
SNoSel соответственно. Тогда текст модуля на языке Pascal (дадим ему имя ures) 
должен иметь вид: 


unit ures; 


interface 
resourcestring 
SSel = 'Выбрана строка '''; 
SNoSel = 'Выбор не сделан'; 
implementation 
begin 
end. 


Обратите внимание Ha TO, что в языке Pascal, в отличие от языков С и С++, 
для строк используются одинарные кавычки, а не двойные. Поэтому в текст стро- 
ки SSel введена в конце пара одинарных кавычек, чтобы символ воспринимался 
именно как кавычка, а не как окончание строки. 

Приведенный выше текст можно написать в любом текстовом редакторе, со- 
хранить как «только текст» в файле с именем игез.раз и затем включить файл 
игез.раз в проект. Но можно все это сделать в среде C++Builder. Для этого выпол- 
ните команду Не | New и в окне Депозитария на странице New выберите пикто- 
грамму Text. В окне Редактора Кода откроется пустой файл с именем по умолча- 
нию Filel.txt. Занесите в него приведенный выше текст. Сохраните этот файл (ко- 
манда File | Save As) под именем игез.раз, выбрав для этого в окне диалога сохране- 
ния файла фильтр Pascal unit (*.pas). Теперь надо включить этот файл в проект. Вы- 
полните для этого команду Project | Add to Project, в открывшемся диалоговом окне 
выберите фильтр Pascal unit (*.pas) и укажите файл ures.pas. 

Теперь надо обеспечить доступ из основного модуля программы к файлу 
ures.pas. Это делается обычным образом. Перейдите в окне Редактора Кода в мо- 
дуль Unitl, выполните команду File | Include Unit Hdr и в открывшемся диалоговом 
окне выберите присоединяемый файл ures.pas. Взгляните, к чему привело выпол- 
нение этой команды. Вы можете увидеть, что в текст модуля введена директива 
компилятора 


#include "ures.hpp" 


Это подключается заголовочный файл ures.hpp, который C++Builder автома- 
тически сгенерировал для модуля ures.pas. Полезно взглянуть на этот заголовоч- 
ный модуль. Для этого переведите курсор на имя модуля ures.hpp в директиве 
#include, щелкните правой кнопкой мыши и выберите в контекстном меню раз- 
дел Open File at Cursor. Вы увидите в окне Редактора Кода файл игез.Врр. Обратите 
внимание в нем на следующий раздел: | 
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namespace Ures 

{ 

//-. type declarations 

//- var, const, procedure ———— 

extern PACKAGE System::ResourceString _55е1; 

#define Ures SSel System: :LoadResourceString(&Ures:: SSel) 
extern PACKAGE System: :ResourceString SNoSel; 

#define Ures SNoSel System: :LoadResourceString(&Ures:: SNoSel) 


} /* namespace Ures */ 


Эти операторы объявляют ключевым словом Namespace область видимости 
имен. Введенным вами строкам присвоены имена _SSel и _SNoSel. Однако тип 
этих идентификаторов — ResourceString. Это структуры, работать с которыми не- 
удобно. Гораздо удобнее работать с идентификаторами Ures_SSel и Ures_SNoSel, 
определенными директивами #4еЁ! те. Эти директивы определяют макросы, вызы- 
вающие функции LoadResourceString. Эти функции переводят аргументы типа 
ResourceString в тип AnsiString. Следовательно, именно через идентификаторы 
Ures_SSel и Ures_SNoSel следует обращаться к строкам, содержащимся в файле 
ресурсов. 

Теперь осталось изменить ранее написанный оператор обработчика щелчка на 
кнопке следующим текстом: 

if (ListBoxl->ItemIndex >= 0) 

Label2->Caption = Ures SSel + 


ListBox1->Items->Strings[ListBoxl->ItemIndex] + "'"; 
else Label2->Caption = Ures SNoSel; 


В этом операторе тексты, которые были в нем раньше, заменены идентифика- 
торами строк Ures_SSel и Ures_SNoSel. 

Сохраните модернизированный вариант вашего приложения, выполните ко- 
манду Project | Build All и запустите приложение на выполнение. Убедитесь, что все 
работает нормально. 


О а 


Предупреждение 
Для того, чтобы дальнейшая интернационализация прошла успешно, надо компилировать 
‚ЗеовИР именно командой Brees | Build All. pa aR командах некие ОЙ не ЗАОДуЧи 
ag давайте займемся интернационализацией приложения. нь всего 

это сделать, выполнив команду File | New и выбрав на странице New окна Депозита- 

рия пиктограмму Resource DLL wizard — Мастер DLL ресурсов. Предварительно при- 
ложение должно быть сохранено на диске и откомпилировано (у нас уже, это сдела- 
но). 

Мастер покажет вам серию экранов, которые, вероятно, не имеет смысла опи- 
сывать все, так как в них в большинстве случаев вы можете ничего не делать, про- 
сто нажимая кнопку Мех! — следующее окно. Остановимся только на тех, в кото- 
рых вам надо что-то делать. Первое из таких окон, представлено на рис. 4.20. В 
нем в списке вы должны установить индикаторы тех языков, для которых хотите 
создать варианты своего приложения. Языков очень много, так что при желании. 
вы можете сделать свое приложение настоящим полиглотом и распространять его 
по всему миру. Но для начала выберите какой-то один язык, например, англий- 
ский. Впоследствии вы сможете добавлять к своему приложению другие языки. 
Русский язык тоже можете указать, хотя это вовсе не обязательно. Он все равно яв- 
ляется базовым, т.е. исходным. Впрочем, для большей симметрии дальнейшей ра- 
боты задайте и его. 

Еще одно окно, на которое надо обратить внимание, представлено на рис. 4.21. 
В нем вы можете кнопкой Ада НЕ указать какие-то дополнительные файлы, изме- 
няющиеся для разных языков, но не распознаваемых автоматически. Без дополни- 
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Рис. 4.20 Resource DLL Wizard 
Выбор языков приложения 
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тельных указаний C++Builder распознает файлы .dfm и .rc. Ho y вас могут быть 
какие-то дополнительные файлы: ресурсов, текстовые, графические, файлы на- 
стройки .ini (см. раздел 4.7.3), которые вы захотите иметь различными для разных 
языков. Например, в нашем приложении могла бы быть предусмотрена загрузка в 
список ListBox какого-то текстового файла, который передается пользователю 
вместе с приложением. Или приложение могло бы быть снабжено файлом справки 
-hip, тексты которого, естественно, должны изменяться при смене языка. Подоб- 
ные файлы следует добавить в окно рис. 4.21. Следует сказать, что большинство 
типов дополнительных файлов не управляются рассмотренным далее Менеджером 
Трансляции. C++Builder просто’создаст копии этих файлов для каждого языка. A 
перевод этих копий на тот или иной язык вы должны будете осуществить само- 
стоятельно. 


Рис. 4.21 

Указание дополнительных 
файлов, подлежащих 
трансляции 


В нашем случае надо добавить файл ресурсов .res, в который помещены стро- 
ки, указанные Kak resourcestring. Нажмите кнопку Add File, в открывшемся диа- 
логовом окне выберите шаблон типа файлов All files (*.*) и укажите файл ресурсов, 
имеющий то же имя, что ваш проект, и расширение .res. 

Пройдя далее через серию окон Мастера DLL ресурсов и нажав в последнем из 
них кнопку Finish, вы увидите окна с сообщениями о том, что отсутствует файл „гс, 
с предложением перекомпилировать проект с опциями, обеспечивающими созда- 
ние этого файла, и предложением сохранить файл группы проектов. Следует согла- 
ситься со всеми сделанными вам предложениями и сохранить файл группы проек- 
тов. | 

Теперь все сделано, чтобы ваш проект смог заговорить на разных языках. Пе- 
ред вами автоматически откроется окно Менеджера Трансляции (рис. 4.22), в ко- 


Проектирование графического интерфейса пользователя 317 


тором вы можете осуществить трансляцию ресурсов на разные языки. В левой па- 
нели окна вы видите дерево ресурсов форм (Forms) и ресурсов проекта (Resource 
Script) для разных языков. Выделите, например, в английском языке вершину мо- 
дуля формы Uniti. Вы увидите в правой панели (см. рис. 4.22) свойства формы и ее 
компонентов, допускающие трансляцию. В первом столбце Id (на рис. 4.22 он по- 
казан не полностью) расположены идентификаторы свойств. Во втором столбце 
приводятся значения этих свойств в исходном русском варианте, следующий стол- 
бец указывает, транслировалось или нет данное свойство, а в следующем столбце 
вы видите значение свойства в английском варианте. Это значение вы можете ре- 
дактировать. Редакцию можно осуществлять или непосредственно в ячейке табли- 
цы, или можно, выделив ячейку, нажать крайнюю правую быструю кнопку (см. 
рис. 4.22) и вызвать специальный многострочный редактор. В таблице имеются 
еще не показанные на рис. 4.22 столбцы, указывающие предыдущую редакцию пе- 
ревода, дату создания начального варианта и последнего изменения. 


Рис. 4.22 < Translation Manages - D:\Tests\internat\Project1_.cpp 
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Вы можете в транслируемом варианте изменить шрифт, множество символов 
и т.п., чтобы сделать тексты доступными на соответствующем языке. Но главное, 
что надо сделать — перевести тексты надписей на форме и ее компонентах. Чтобы 
это было проще осуществить, можно посоветовать предварительно щелкнуть на за- 
головке столбца Русский. Тогда строки таблицы станут упорядочены в алфавитном 
порядке значений свойств русского варианта и все надписи на русском языке собе- 
рутся вместе, как показано на рис. 4.22. 

Аналогичным образом надо заменить строки ресурсов в вершине английского 
варианта Project]_DRC, содержащие русские надписи «Выбрана строка» и «Выбор 
не сделан». 

При переходе к вершине Ргоес  _ОКС вам будет задан вопрос, хотите ли вы со- 
хранить изменения в вершине Unit!. Аналогичный вопрос о сохранении изменений 
будет вам задан при выходе из окна Менеджера Трансляции. Конечно на эти во- 
просы следует ответить положительно. Впрочем, вы можете не дожидаться этих 
вопросов, а сохранить результаты трансляции, нажав соответствующую быструю 
кнопку (первая слева в правой группе на рис. 4.22). 

Крайняя правая кнопка Actions на рис. 4.22 открывает выпадающее меню с ря- 
дом разделов. Это же меню появляется при щелчке правой кнопкой в какой-то 
строке столбца Русский. Остановимся на одном разделе этого меню — Repository с 
двумя подразделами Add Strings to Repository и Get Strings from Repository. Первый из 
этих подразделов сохраняет ваш перевод строки в депозитарии переводов. A BTO- 
рой переносит в выделенную строку перевод, хранящийся в депозитарии. В сам де- 


/ 
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позитарий (см. рис. 4.23) вы можете попасть, нажав крайнюю левую кнопку в окне 
рис 4.22. В нем вы можете хранить переводы различных типовых текстов, встре- 
чающихся в приложениях. Так что после интернационализации нескольких при- 
ложений у вас будет не так уж много забот с переводом новых текстов. 


Рис. 4.23 
Окно депозитария трансляции 


Файл’ 
Выбор’ 


: 'Интернационализация | й __  метавопайганом' 


По рассмотренной выше команде Се! Strings from Repository перенос из депозита- 
рия осуществляется автоматически, если там нашлось точное соответствие текста, 
указанного в выделенной строке, причем в депозитарии имеется только один пере- 
вод этого текста. Если имеется несколько переводов, то поведение определяется ус- 
тановкой опции Multiple Find Action в окне задания опций трансляции, которое вы 
можете вызвать командой главного меню C++Builder 5 Tools | Translation Tools 
Options. Если в опции Multiple Find Action вы установите радиокнопку Skip, To при об- 
наружении в депозитарии более одного перевода данного текста ничего делаться не 
будет. Если вы установите радиокнопку Use first, то в этом случае в строку будет 
вставлен нервый из нескольких переводов. Если вы установите радиокнопку 
Display selection, то вам будет предоставлен выбор из имеющихся переводов. 

В том же окне задания опций трансляции имеются также опции группы 
Resource DLL Wizard. Эти опции означают следующее: 


ОИ ЯНА О О а а В а ай 


Automatic repository query Автоматически заполнять строки перевода- 
ми из депозитария 

Automatically compile projects Автоматически компилировать проект, если 
необходимо, не запрашивая 00 этом пользо- 
вателя 


Show Translation Manager after КО\/ Автоматически показывать окно Менеджера 
Трансляции после окончания работы Масте- 
ра трансляции 


Давайте вернемся к нашему примеру. По окончании работы с Менеджером 
Трансляции вы увидите, что создалась группа проектов. С ней проще всего рабо- 
тать, вызвав окно Менеджера проектов (команда View | Project Manager), показанное 
для нашего примера на рис. 4.24. Оно содержит вершину Ргоес!|.ехе, отображаю- 
щую сам проект, и вершины Projectl.enu и Projectl.rus, отображающие соответст- 
венно ресурсы английского и русского вариантов. Выбрав вершину Гогт] того или 
иного варианта, вы можете увидеть, как выглядит ваша форма в русском или анг- 
лийском исполнении. Вершины Рго|ес _ОКС.гс покажут вам файлы ресурсов обоих 
вариантов. Но не исправляйте их вручную — это не приведет ни к чему хорошему. 


Предупреждение 
Не исправляйте вручную в интернационализированном проекте файлы ресурсов. Все исп- 
равления делайте только через окно Менеджера Трансляции. 
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Рис. 4.24 | 
Окно. Менеджера Проектов группы 
оттранслированных вариантов приложения 
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D:\Tests\Internat\rus 
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Сохраните файл группы проектов и попробуйте с ним работать. Активизируй- 
те в окне Менеджера Проектов вершину Project|.exe. Для этого можете сделать на 
ней двойной щелчок, или выделить ее и нажать кнопку Activate, или нажать в инст- 
рументальной полосе среды C++Builder маленькую кнопочку рядом с быстрой 
кнопкой Кип. После этого выполните ваше приложение. Вы увидите ту же карти- 
ну, что и раньше (рис. 4.19 a). 

А теперь выполните команду Project | Languages. Всплывет каскадное меню с 
разделами Ада (добавить новый язык), Remove (удалить один из языков), Set Active 
(сделать активным один из языков) и Update Resource DLLs (обновить DLL ресурсов). 


ОЕ ОИ О ОИ ИИ ОИ 


Предупреждение .. 


Все разделы команды aus | Languages, кроме команды Add, доступны, только если у вас 

в окне Менеджера Проектов активизирована вершина головного файла проекта (в нашем 

фаны — а ный или PROKOP OR, PERS. а 

нони ‘Add приведет вас в одно из окон ОИ DLL ресурсов, в котором вы 
можете указать проект и далее добавить к нему новый язык. Команда Кетоуе при- 
ведет вас в окно, в котором вы увидите список введенных в проект языков и около 
каждого языка будут стоять индикаторы. Их вы можете включить у тех языков, 
‚которые хотите удалить. Впрочем, удаление коснется только возможности делать 
соответствующий язык активным. Сами DLL ресурсов на диске сохранятся. 

Команда Update Resource DLLs обновляет DLL ресурсов. Выполняйте ее после 
любых изменений и вообще почаще работайте. с ней в случаях возникновения ка- 
ких-то недоразумений. 

Команда Set Active делает активным один из языков. В ответ на эту команду по- 
является диалоговое окно, в котором вы можете выбрать один из языков для от- 
ладки вашего приложения, или выбрать <none>. Последнее означает, что выбор 
варианта осуществляется автоматически в зависимости от языка, установленного 
в Windows. Установите активным русский язык (если вы не указывали его как 
один из языков при работе в окне рис. 4.20, то его не будет в списке команды Set 
Active). Выполнив проект, вы увидите, что ничего в его работе, конечно, не измени- 
лось. Если же вы сделаете активным английский язык и после этого выполните 
проект, то увидите (рис. 4.19 6), что ваше приложение заговорило на английском 
языке. 
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То, что вы сейчас делали — это только активизация того или иного языка при 
отладке. К действительному поведению приложения при выполнении его не из 
среды C++Builder установки языка отношения не имеют. Можете проверить это. 
Чтобы эксперимент был совсем чистый, перенесите в отдельный каталог файлы 
Projectl.exe и Projectl.enu — английский вариант ресурсов. Закройте C++Buil- 
der. Выполните ваш файл (Projectl.exe) средствами Windows, например, програм- 
мой «Проводник». Приложение будет разговаривать по-русски. А теперь установи- 
тев Windows английский язык. Для этого выполните программу «Панель управле- 
ния», щелкните в ее окне на пиктограмме Язык и стандарты и на странице Регио- 
нальные стандарты выберите из выпадающего списка английский язык. Щелкните 
на ОК. Вам будет предложено перезагрузить компьютер, чтобы ваша установка 
вступила в силу. Согласитесь на перезагрузку, а после нее опять выполните вне 
C++Builder ваше приложение. Вы увидите, что оно разговаривает по-английски. А 
ведь вы ничего с ним не делали! Оно само поняло установленный в системе язык и 
заговорило на нем. Вот это и есть интернационализация приложения. Порадуйтесь 
на свое создание, которое стало полиглотом, но не забудьте опять вернуться к нор- 
мальным установкам, указав с помощью «Панели управления», что вы все-таки 
хотите работать с русским языком. 
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Не забудьте, что если вы хотите распространять свое интернационализированное приложе- 
ние, то вместе с выполняемым модулем надо распространять и файлы соответствующих язы- 
ков (в нашем примере Ргоес!.епц). 
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Мы рассмотрели вариант интернационализации приложения с помощью Mac- 
тера DLL ресурсов. Но в дальнейшем вы можете работать с приложением: добав- 
лять, например, новые языки, удалять введенные, изменять перевод и т.п., не 
прибегая к помощи Мастера. Для этого имеется команда View | Translation Manager, 
вызывающая окно Менеджера Трансляции (рис. 4.22). В нем вы можете не только 
редактировать свой перевод, но и добавлять новый язык (быстрая кнопка со зна- 
ком «+») или удалять имеющийся (быстрая кнопка со знаком «-»). В обоих случа- 
ях произойдет автоматическое обращение к тем или иным окнам Мастера DLL ре- 
сурсов. Только имейте в виду, что команда View | Translation Manager доступна, толь- 
ко если у вас в окне Менеджера Проектов активизирована вершина головного фай- 
ла проекта или корневая вершина группы. 


4.7.1.3 Завершение разработки проекта 


По окончании работы над проектом надо провести завершающую компиляцию 
проекта с соответствующей установкой всех опций. Прежде всего надо решить, бу- 
дете ли вы использовать поддержку пакетов выполнения (см. раздел 7.6), или бу- 
дете генерировать автономный выполняемый файл. Если надо генерировать авто- 
номный файл, а ранее согласно рекомендациям раздела 7.6 вы отлаживали проект 
в режиме поддержки пакетов времени выполнения, то необходимо выполнить ко- 
манду Project | Options и в раскрывшемся окне опций проекта Ha странице Packages 
выключить индикатор Built with runtime packages. Если же вы намерены при распро- 
странении приложения использовать поддержку пакетов выполнения, то вы долж- 
ны, пользуясь методикой, рассмотренной в разделе 7.6, отобрать те пакеты, KOTO- 
рые будут распространяться вместе с приложением. Обычно полезно проверить 
полноту комплектации передаваемых пользователю файлов, попробовав выпол- 
нить приложение на компьютере, на котором отсутствует C++Builder. 

При заключительной компиляции надо также установить опции оптимиза- 
ции, отключить опции отладки и т.п. Все это делается в окне опций проекта, pac- 
смотренном в разделе 14.2.9. В частности, правильной установке всех этих опций 
на странице Compiler окна опций проекта способствует кнопка Release (см. раз- 
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дел 14.2.9.2). Но некоторые опции надо устанавливать на страницах Advanced 
Compiler и С++. 

На заключительной стадии разработки проекта надо также решить вопросы 
установки вашего приложения на компьютерах пользователей. Эти вопросы рас- 
смотрены в следующих разделах. 


4.7.2 Установка и настройка приложения 


4.7.2.1 Работа с системным реестром 


Обсудим коротко вопросы установки вашего приложения на компьютере поль- 
зователя. Если это очень простое приложение, то никаких проблем нет — доста- 
точно скопировать выполняемый файл приложения с загрузочной дискеты или 
диска СО КОМ в выделенный для приложения каталог. Если в дальнейшем поль- 
зователь решит удалить вашу программу со своего компьютера, ему будет доста- 
точно удалить этот файл. 

В более сложных приложениях обычно фигурируют различные файлы на- 
стройки, конфигурации и т.д., расположенные к тому же в разных каталогах. В 
этих случаях установить программу на компьютере и удалить ее, если она стала не 
нужна, уже гораздо сложнее. 

Раньше, в Windows 3.x информация о конфигурации и настройках приложе- 
ния хранились в файлах .ini. Ho для того чтобы упорядочить процессы установки 
и удаления программ, начиная с Windows 95 и МТ Microsoft требует, чтобы вся ин- 
формация о конфигурации системы хранилась в системном реестре. Реестр 
(Registry) — это база данных для хранения информации о системной конфигура- 
ции аппаратуры, о Windows и о приложениях Windows. Почти все, что в Windows 
3.х находилось в файлах ли, перенесено в Windows 95 и МТ в реестр. Реестр имеет 
иерархическую организацию, которая, содержит много уровней ключей, субклю- 
чей и параметров. Информация ‘хранится в виде иерархического дерева, каждый 
узел которого называется ключом. Ключ может содержать субключи и значения 
параметров. 

Реестр делит все свои данные на две категории: характеризующие компьютер 
и характеризующие пользователя. Характеристики компьютера включают в себя 
все, связанное с техническими средствами, а также с установленными приложе- 
ниями и их конфигурацией. Характеристики пользователя включают в себя уста- 
новки по умолчанию для экрана, пользовательские конфигурации, PARODMARID (9) 
выбранных пользователем принтерах, установки сети. 

Все субключи относятся к шести основным ключам реестра. Четыре из них оп- 
ределяют характеристики компьютера: 


В а ня ERIS MEP ORIOLE ROE EE ELC ЕАСИ OEIC IEA EEE REE INE АИ: WOE OR: 


‘Hkey_ Local_Machine Информация (9 компьютере, включая конфигурацию. 
установленной аппаратуры и программного обеспечения 


Hkey_Current_Config Информация о текущем оборудовании 


Hkey_Dyn_Data Динамические данные о состоянии, используемые про- 
цедурами plug-and-play 


Hkey_Classes_Root Информация об OLE, Drag&Drop, клавишах быстрого 
доступа и пользовательском интерфейсе Windows 95 


Два ключа верхнего уровня определяют характеристики пользователя: 
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ЗА И КД SEMEL REELED ДИ IIE AE И ELE: АГА: 


Hkey_ Users Информация о пользователях, включая установки экра- 
на и приложений 


Hkey_Current_User Информация о пользователе, зарегистрированном в дан- 
ный момент 


Реестр хранится в файле SYSTEM.DAT в каталоге Windows. Просмотр и ре- 
дактирование реестра из Windows осуществляется редактором реестра Regedit.exe 
(рис. 4.25). Только прежде, чем вы будете вручную что-то редактировать в реестре 
или опробовать изложенные ниже приемы работы с реестром из приложений 
C++Builder, прислушайтесь к следующему совету. 


С oO B e ii POOLE LE ALS! LASOPSED PSPSPS SAE SEELEORLL ALLELE АКИ SSESS ММАС МИНИ DONC VALNSSESSASELLLE SLE NPCOOLILICEL RA ORDERS PAIRS ALISO ESC SELINA ALLER. PESSAL!ESLLAASSELLAPLEE PLA EER PA LSAPL LEER ELSIE LSEALLLLRLVPASLSALASED LALLA SASL le 


Прежде, чем изменять что-то в реестре, сохраните копию его файла SYSTEM.DAT, pacno- 
ложенного в каталоге Windows, в каком-то другом каталоге. Это позволит вам в случае неу- 
дачного вмешательства в реестр восстановить прежнее состояние этого файла. В противном 
случае ваши эксперименты могут закончится плачевно вплоть до необходимости дарвусто- 
навливать ‚ЗОНВООИ 


а а о а я УВИДЕЛИ ЕАН 


Рис. 4.25 
Окно редактора реестра 
Regedit.exe 


|2 8} Мой а ние... 
$ С] HKEY_CLASSES ROOT | | 26] Пош {значение не присвоено] 
# 2) HKEY_CURRENT_USER "T Registry" 
9} HKEY_LOCAL_MACHINE ab "D:\TESTS\REGINI\PREG.EXE" 


"MS Sans Serif" 


if] Security 
=} = Software 


Для работы с реестром в C++Builder имеется класс TRegistry, описанный в 
модуле registry. Если вы создаете в приложении объект класса TRegistry для рабо- 
ты с реестром, не забудьте обеспечить связь с этим модулем директивой 

#include "registry.hpp"; 

Все ключи в объекте класса TRegistry создаются Kak субключи определенного 
корневого ключа, записанного в свойстве RootKey. По умолчанию RootKey = 
HKEY CURRENT_USER. В каждый момент объект типа TRegistry имеет доступ 
только к одному текущему ключу в иерархии, начинающейся с ключа RootKey. 
Текущий ключ определяется свойством только для чтения CurrentKey. Но это зна- 
чение вам ничего не скажет — это просто некоторое целое значение. А вот свойство 
CurrentPath (тоже только для чтения) содержит строку, включающую имя теку- 
щего ключа и путь к нему по дереву. Изменить текущий ключ можно методом 
OpenKey: 

bool fastcall OpenKey(const AnsiString Key, bool CanCreate); 


Этот метод открывает ключ Key, делая его текущим для объекта. Параметр 
Кеу — строка полного пути по дереву ключей к открываемому ключу. Если Кеу — 
пустая строка, то текущим делается корневой ключ, указанный свойством Root- 
Key. Параметр CanCreate указывает, должен ли создаваться ключ Key, если его 
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нет в реестре. Ключ открывается или создается с доступом KEY ALL ACCESS. 
Создаваемый ключ сохраняется в реестре при последующих запусках системы. 

Запись значений параметров в ключ осуществляется группой методов: Write- 
Integer, WriteFloat, WriteBool, WriteString и др. Объявления всех этих методов 
очень похожи. Например: 


void _fastcall WriteInteger(const AnsiString Name, 
int Value); 
void _fastcall WriteString(const AnsiString Name, 
const AnsiString Value) ; 


Все они заносят значение Value в параметр с именем Name. Имеются анало- 
гичные методы чтения: ReadInteger, ReadFloat, ReadBool, ReadString и др. На- 
пример: 

int  fastcall ВеааТпфедег (сопзЕ AnsiString Маме); 

AnsiString _fastcall ReadString(const AnsiString Name) ; 


Посмотрим на примере, как все это можно использовать для установки про- 
граммы, запоминания ее настроек и для удаления программы. 

Сделайте простое тестовое приложение. Перенесите на форму три кнопки 
Button и диалог FontDialog. Первая кнопка (назовите ее BInst и задайте надпись 
Install) будет имитировать установку программы. Точнее, не саму установку, по- 
скольку копировать файлы с установочной дискеты мы не будем, а только регист- 
рацию нашего приложения в реестре. Вторая кнопка (назовите ее BUnInst и задай- 
те надпись Uninstall) будет имитировать удаление программы. Тут мы не будем уда- 
лять саму программу с диска (жалко ее!), а только удалим из реестра ссылку на 
нее. А третья кнопка (назовите ее BFont и задайте надпись Гоп!) будет позволять 
изменять имя шрифта, используемого в форме, и обеспечит запоминание этого 
шрифта в реестре, чтобы в дальнейшем при запуске приложения можно было чи- 
тать эту настройку и задавать ее форме. | 

Ниже приведен текст этого тестового приложения. 

#include "“registry.hpp"; 

TRegistry *Reg = new TRegistry; 


El TET eee 

void _fastcall TForml::FormDestroy(TObject *Sender) 

{ 

//Удаление из памяти объекта Reg 

delete Reg; 

} 

OT as ea a ae 

void _ fastcall TForml::FormCreate(TObject *Sender) 

{ 

//Задается корневой каталог объекта Reg 

Reg->RootKey = НКЕУ LOCAL MACHINE; 
if (Reg->KeyExists("\\Software\\A Projects\\P1") ) 
{ 

/*Если программа была установлена, то читается настройка шрифта*/ 
Reg->OpenKey("\\Software\\A Projects\\P1",true) ; 
Font->Name = Reg->ReadString ("Шрифт"); 

} 
fers 
| ине 


void _ Еаз®са11 TForml::BInstClick(TObject *Sender) 
{ 

//Имитация установки программы 
Reg->OpenKey("\\Software\\A Рго)есез$", ское); 
Reg->WriteString("Tema","Mon приложения"); 
Reg->OpenKey ("\\Software\\A Projects\\P1", true) ; 
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Reg->WriteString ("NpunoxeHnue","TRegistry"); 

/*Запись в параметр Файл имени и пути к выполняемому файлу*/ 
Reg->WriteString("®amn", ParamStr(0Q)); 

//Запись в параметр Шрифт имени шрифта 
Reg->WriteString("llpuotr", Forml->Font->Name) ; 


J fo a 


void _ fastcall TForml::BUnInstClick(TObject *Sender) 
{ 

//Удаление субключа Pl из регистра 
Reg->DeleteKey("\\Software\\A Projects\\P1") ; 

} 


| | aa В CEE a ON SR 
void _fastcall TForml::BFontClick(TObject *Sender) 
{ 
FontDialogl->Font->Assign (Font) ; 
//Запоминание в реестре имени шрифта 

if (FontDialogl->Execute() ) 

{ 

Font->Assign (FontDialogl->Font) ; 
if (Reg->OpenKey("\\Software\\A Projects\\P1", false) ) 
/* Запись имени шрифта только если имеется раздел Pl */ 
Reg->WriteString ("Шрифт", Forml->Font->Name) ; 

} 

} 


В начале текста следует подключение к приложению модуля registry и созда- 
ние объекта Reg типа TRegistry. Этот объект удаляется при закрывании формы в 
функции TForm1::FormDestroy. 

При создании формы приложения в процедуре TForm1::FormCreate корневым 
узлом объекта Reg задается ключ HKEY LOCAL MACHINE. Затем с помощью 
метода KeyExists проверяется, существует ли в реестре субключ \Software\A 
Projects\P1. Этот ключ, как мы позже увидим, создается при регистрации нашего 
приложения в реестре. Так что в настоящем приложении, если бы метод KeyExists 
вернул false, надо было бы выдать какое-то предупреждение о том, что приложе- 
ние не зарегистрировано, и завершить работу. 

Обратите внимание, что в текстовых строках символ «\» должен удваиваться: 
«\\Software\\A Projects\\P1>». | 

Если метод KeyExists вернул true, то далее в процедуре открывается методом 
ОрепКеу субключ \Software\A Projects\P1 и читается методом ReadString имя 
шрифта, занесенное в параметр Шрифт, в имя шрифта формы. 

Теперь рассмотрим процедуру TForm1::BInstClick, имитирующую установку 
программы. В этой процедуре методами ОрепКеу создается иерархия ключей: А 
Projects. и Р1 в субключе Software (этот субключ всегда существует в реестре). В 
ключ A Projects заносится один параметр — Тема со значением Мои приложения. 
Подразумевается, что этот субключ будет содержать ссылки на все ваши приложе- 
ния, зарегистрированные в реестре. В ключ РТ (субключ вашего регистрируемого 
проекта) заносится три параметра. Первый параметр — Приложение со значением 
TRegistry. Второй параметр — Файл со значением, равным полному имени файла 
приложения вместе с путем. Это имя получается из нулевого параметра командной 
строки, передаваемого функцией ParamStr(O0). В третий параметр — Шрифт зано- 
сится имя текущего шрифта, используемого в форме. В настоящей программе ус- 
тановки в эту процедуру надо было бы добавить копирование соответствующих 
файлов с установочной дискеты. 

Процедура TForm1::BUnInstClick имитирует удаление приложения и ссылки 
на него (субключ РТ) из реестра. В настоящем приложении прежде, чем удалять 
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ключ из реестра, надо было бы прочитать значение параметра Файл и удалить этот 
файл с диска. 

Процедура TForm1::BFontClick вызывает стандартный диалог выбора шриф- 
та, и если пользователь выбрал шрифт, то он присваивается форме и его имя зано- 
сится в реестр. При этом в методе ОрепКеу второй параметр задан равным false. 
Это значит, что если ваше приложение не зарегистрировано (субключа Pl нет в 
реестре), то запись шрифта не производится. 

Сохраните свое тестовое приложение и запустите его на выполнение. Нажмите 
кнопку Install. После этого запустите программу Regedit.exe и посмотрите реестр. 
Вы увидите там свои ключи‘и параметры (именно они показаны на рис. 4.25). 
Щелкните на кнопке Uninstall. Вернитесь в окно Regedit.exe и выберите в нем KO- 
манду Вид | Обновить. Вы увидите, что ключ P1 вместе со всеми своими параметра- 
ми исчез из дерева. Опять нажмите кнопку Install, а затем нажмите кнопку Font и 
выберите шрифт с каким-нибудь другим именем. В окне Regedit.exe вы можете 
увидеть, что значение параметра Шрифт изменится. Закройте свое приложение и 
запустите его повторно. Вы увидите, что на форме применен тот шрифт, который 
вы зарегистрировали в реестре. Таким образом, приложение проимитировало уста- 
новку программы, снятие программы с регистрации и запоминание текущих на- 
строек в реестре. 

Когда вы кончите экспериментировать с этим приложением, удалите с помо- 
щью Regedit.exe из реестра ваш ключ A Projects, поскольку приложение удаляло 
только его субключ Pl. 


4.7.2.2 Работа с файлами М 


В разделе 4.7.2 рассказывалось, как регистрировать приложение в системном 
реестре и фиксировать там текущие настройки приложения. Однако, подобная ра- 
бота с реестром возможна только в 32-разрядных Windows 95/98 и МТ. Если же вы 
хотите, чтобы ваше приложение можно было использовать и в Windows 3.x, то вам 
надо регистрировать приложение и фиксировать его настройки в файлах типа .ini. 
Для 32-разрядных приложений Microsoft не рекомендует работать с файлами .ini. 
Впрочем, несмотря на это и 32-разрядные приложения, наряду с реестром, часто 
используют эти файлы. Да и разработки Microsoft не обходятся без этих файлов. 

Файлы 11 — это текстовые файлы, предназначенные для хранения информа- 
ции о настройках различных приложений. Информация в файле логически груп- 
пируется в разделы, каждый из которых начинается оператором заголовка, заклю- 
ченным в квадратные скобки. Например, [Desktop]. В строках, следующих 3a заго- 
ловком содержится информация, относящаяся к данному разделу, в форме: 


<ключ>=<значение> 
В качестве примера ниже приводится фрагмент файла ODBC.INI: 


[ODBC 32 bit Data Sources] 

GBASE Files=Microsoft dBase Driver (*.dbf) (32 bit) 
Excel Files=Microsoft Excel Driver (*.xls) (32 bit) 
FoxPro Files=Microsoft FoxPro Driver (*.dbf) (32 bit) 
Text Files=Microsoft Text Driver (*.txt; *.csv) (32 bit) 


[dBASE Files] 
Driver32=C: \WINDOWS\SYSTEM\odbcjt32.dl1l 


Файлы .ini, как правило, хранятся в каталоге Windows, который можно найти 
с помощью функции Get WindowsDirectory. 

В C++Builder работу с файлами .ini проще всего осуществлять с помощью со- 
здания в приложении объекта типа TIniFile. Этот тип описан в модуле inifiles, ко- 
торый надо подключать к приложению оператором uses (автоматически это не де- 
лается). 
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При создании объекта типа TIniFile в него передается имя файла .ini, с кото- 
рым он связывается. Файл должен существовать до создания объекта. 

Для записи значений ключей существует много методов: WriteString, 
WriteInteger, WriteFloat, WriteBool и др. Каждый из них записывает значение 
соответствующего типа. Объявления всех этих методов очень похожи. Например: 

void _ Еаз®са11 WriteString(const AnsiString Section, 

const AnsiString Ident, 
const AnsiString Value); 
void _fastcall WriteInteger(const AnsiString Section, 


const AnsiString Ident, 
int Value); 


Вр всех объявлениях Section — раздел файла, Ident — ключ этого раздела, 
Уаше — значение ключа. Если соответствующий раздел или ключ отсутствует в 
файле, он автоматически создается. 

Имеются аналогичные методы чтения: ReadString, ReadInteger, ReadFloat, 
ReadBool и др. Например: 

AnsiString fastcall ReadString(const AnsiString Section, 

const AnsiString Ident, 
const AnsiString Default); 
int  fastcall ReadInteger(const AnsiString Section, 
const AnsiString Ident, 
int Default); 


Методы возвращают значение ключа Ident раздела Section. Параметр Default 
определяет значение, возвращаемое в случае, если в файле не указано значение со- 
ответствующего ключа. | 

Проверить наличие значения ключа можно методом ValueExists, в который 
передаются имена раздела и ключа. Метод DeleteKey удаляет из файла значение 
указанного ключа в указанном разделе. Проверить наличие в файле необходимого 
раздела можно методом SectionExists. Метод EraseSection удаляет из файла ука- 
занный раздел вместе со всеми его ключами. Имеется еще ряд методов, которые вы 
можете посмотреть во встроенной справке C++Builder. 

Посмотрим на примере, как все это можно использовать для установки про- 
граммы, запоминания ее настроек и для удаления программы. 

Сделайте простое тестовое приложение, аналогичное рассмотренному в разде- 
ле 4.7.2.1. Перенесите на форму три кнопки Button и диалог FontDialog. Первая 
кнопка (назовите ee BiInst и задайте надпись Install) будет имитировать установку 
программы. Точнее, не саму установку, поскольку копировать файлы с установоч- 
ной дискеты мы не будем, а только создание файла .ini в каталоге Windows. Вто- 
рая кнопка (назовите ee BUnInst и задайте надпись Uninstall) будет имитировать 
удаление программы. Тут мы не будем удалять саму программу с диска, а только 
удалим из каталога Windows наи файл .ini. А третья кнопка (назовите ee BFont и 
задайте надпись Font) будет позволять изменять имя шрифта, используемого в фор- 
ме, и обеспечит запоминание этого шрифта в файле .ini, чтобы в дальнейшем при 
запуске приложения можно было читать эту настройку и задавать ее форме. 

Ниже приведен текст этого тестового приложения. 

#include "inifiles.hpp";: 

#include <stdio.h> 

TIiniFile *Ini; 

String sFile; 


трее тНы 
void _fastcall TForml::FormCreate(TObject *Sender) 
{ 

Char APchar[255]; 

//Формирование имени файла в каталоге Windows 


/ 
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GetWindowsDirectory (APchar, 255) ; 
sFile = (String)APchar+"\\My.ini"; 
if (FileExists (sFile) ) 
{ 
// Создание объекта Ini 
Ini = new TIniFile(sFile); 
//Чтение в имя шрифта формы значения ключа Шрифт 
Font->Name = Ini->ReadString("llapametpsi", "Шрифт", 
"MS бапз. Serif"); 
} 


} 
до emer maaan 
void _fastcall TForml::FormDestroy(TObject *Sender) 
{ 
if (Ini == NULL) return; 
//Очистка буфера и запись файла на диск 
Ini->UpdateFile(); 
//Освобождение памяти 
delete Ini; 
} 
/-—ШШМщШ——Ш—Ш——Ш—————- 
void _fastcall TForml::BInstClick(TObject *Sender) 
{ \ 
FILE *Е; 
//Проверка существования файла .1п1 
if (! FileExists(sFile) ) 
{ 
//Создание файла .ini 
1Е ((F = fopen(sFile.c_str(), "wt")). == NULL) 
{ 
ЗПпомМеззасве ("Файл не удается открыть"); 
return; 
} 
fclose(F); // закрытие файла 
} 
// Создание объекта Ini 
Ini = new TIniFile(sFile) ; 
/* Создание раздела Files, ключа main и запись в него 
имени выполняемого файла вместе с путем */ 
Ini->WriteString("Files", "main", ParamStr (0)); 
/* Создание раздела Параметры, ключа Шрифт и запись в него 
имени шрифта формы */ 
Ini->WriteString ("Параметры" , "Шрифт", Font->Name) ; 
} 
| a mae 
void _fastcall TForml::BUnInstClick(TObject *Sender) 
{ 
FILE *F; 
//Удаление с диска файла .ini, если он существует 
if (FileExists ($Е11е)) 
DeleteFile(sFile) ; 
} | 
ь——————- 
void _fastcall TForml::BFontClick(TObject *Sender) 
{ 
//Выбор шрифта 
FontDialogl->Font->Assign (Font) ; 
if (FontDialogl->Execute() ) 
{ 
//Присваивание выбранного щрифта форме 
Font->Assign (FontDialogl->Font) ; 
if((Ini != NULL) && Ini->ValueExists ("Параметры", "Шрифт")) 
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//Запись шрифта в ключ "Шрифт" разделе "Параметры" 
Ini->WriteString ("Параметры", "Шрифт", Font->Name) ; 
} 
} 


В начале текста следует подключение к приложению модуля inifiles.hpp, в ко- 
тором объявлен тип TIniFile, и модуля stdio.h, необходимого для операций с фай- 
лами. Объявляется объект Ini типа TIniFile u переменная sFile, в которой будет 
формироваться имя файла и путь к нему. При создании формы приложения в про- 
цедуре TForm1->FormCreate формируется имя файла («My.ini») вместе с путем к 
нему — каталогом Windows. Этот путь определяется функцией GetWindows- 
Directory. Далее функцией FileExists проверяется, существует ли этот файл, т.е. 
проведена ли уже установка программы. Если существует, то создается объект Ini, 
связанный с этим файлом, и значение ключа Шрифт раздела Параметры читается в 
имя шрифта формы. Тем самым читается настройка, произведенная при предыду- 
щем выполнении приложения. 

Теперь рассмотрим процедуру TForm1->BInstClick, имитирующую установку 
программы. В этой процедуре сначала функцией FileExists проверяется, сущест- 
вует ли в каталоге Windows файл «Му.пи». Если не существует, этот файл (пока 
пустой) создается функцией fopen с параметром «w+». Затем создается связанный 
с этим файлом объект Пи. Последующие операторы записывают в этот файл два 
раздела Files и Параметры с соответствующими ключами. В ключ Main записывает- 
ся имя приложения с путем к нему. Для этого используется функция ParamStr(0) 
(см. раздел 15.7.4 главы 15). В результате в созданный файл записывается, напри- 
мер, такой текст: 

[Files] 

main=D:\TESTS\REGINI\PINI.EXE 


[Параметры] 
Шрифт=М5$ Sans Serif 


Процедура TForm1->BUnInstClick имитирует удаление приложения и ero 
файла настройки. В данном случае просто удаляется файл .ini, но в настоящем 
приложении надо было бы прочитать имя файла (или файлов) приложения из раз- 
дела Files и удалить их с диска. 

Процедура TForm1->FormDestroy, срабатывающая при закрывании формы 
приложения, сначала методом UpdateFile переписывает содержимое объекта Пи в 
файл, а затем методом Егее удаляет из памяти этот временный объект. 

Процедура TForm1->BFontClick вызывает стандартный диалог выбора шриф- 
та, и если пользователь выбрал шрифт, то он присваивается форме и его имя зано- 
сится в файл .ini. 

Сохраните свое тестовое приложение и запустите его на выполнение. Нажмите 
кнопку Install. После этого убедитесь в наличии файла «My.ini» в каталоге 
Windows. Можете воспользоваться для этого программой Windows «Проводник» 
или любой другой. В частности, можно открыть этот файл просто из среды 
C++Builder. При нажатии кнопки UnInstall файл должен удаляться с диска. Про- 
верьте запись в файл настройки шрифта и чтение ее при последующих запусках. 
Для этого опять нажмите кнопку Install, а затем нажмите кнопку Font и выберите 
шрифт с каким-нибудь другим именем. Потом закройте свое приложение и запус- 
тите его повторно. Вы увидите, что на форме применен тот шрифт, который вы за- 
регистрировали в файле настройки. Таким образом, приложение проимитировало 
установку программы, удаление программы и запоминание ее текущих настроек. 
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5.1 Построение графических изображений 


5.1.1 Использование готовых графических файлов 


5.1.1.1 Компонент Image и некоторые его свойства 


Нередко возникает потребность украсить свое приложение какими-то картин- 
ками. Это может быть графическая заставка, являющаяся логотипом вашего при- 
ложения. Или это могут быть фотографии при разработке приложения, работаю- 
щего с базой данных сотрудников некоего учреждения. В первом случае вам потре- 
буется компонент Image, расположенный на странице Additional библиотеки компо- 
нентов, во втором — его аналог DBImage, связанный с данными и расположенный 
на странице Data Controls. 

Начнем знакомство с этими компонентами. Откройте новое приложение и пе- 
ренесите на форму компонент Image. Его свойство, которое может содержать кар- 
тинку — Picture. Нажмите на кнопку с многоточием около этого свойства или про- 
сто сделайте двойной щелчок Ha Image, и перед вами откроется окно Picture Editor 
(рис. 5.1), позволяющее загрузить в свойство Picture какой-нибудь графический 
файл (кнопка Load), а также сохранить открытый файл под новым именем или в 
новом каталоге. Щелкните на Load, чтобы загрузить графический файл. Перед 
вами откроется окно Load Picture, представленное на рис. 5.2. По мере перемещения 
курсора в списке по графическим файлам в правом окне отображаются содержащие- 
ся в них изображения. Вы можете найти графические файлы в каталоге Images. Он 
обычно расположен в каталоге ...\ргодгат files\Common Files\Borland Shared. 

На рис. 5.1 и 5.2 изображена загрузка файла ...\|Images\Splash\16Color\earth.omp. 
В окне загрузки графического файла (рис. 5.2) вы можете не только просмотреть 
изображение, хранящееся в выбираемом файле, но и увидеть размер изображе- 
ния — цифры в скобках справа вверху. В некоторых случаях, как вы увидите 
позднее, это важно. 

После загрузки файла щелкните на ОК и в вашем компоненте Image отобра- 
зится выбранная вами картинка. Можете запустить ваше приложение и полюбо- 
ваться ею. Впрочем, вы и так увидите картинку, даже не выполняя приложение. 


Рис. 5.1 
Окно Picture Editor 
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Рис. 5.2 
Окно загрузки графического 
файла 
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Когда вы в процессе проектирования загрузили картинку из файла в KOMIIO- 
нент Image, он не просто отображает ee, но и сохраняет в приложении. Это дает 
вам возможность поставлять ваше приложение без отдельного графического фай- 
ла. Впрочем, как мы увидим позднее, в Image можно загружать и внешние графи- 
ческие файлы в процессе выполнения приложения. 

Вернемся к рассмотрению свойств компонента Image. 

Если установить свойство AutoSize в true, то размер компонента Image будет 
автоматически подгоняться под размер помещенной в него картинки. Если же 
свойство AutoSize установлено в false, то изображение может не поместиться в 
компонент или, наоборот, площадь компонента может оказаться много больше 
площади изображения. 

Другое свойство — Stretch позволяет подгонять не компонент под размер ри- 
сунка, а рисунок под размер компонента. Установите AutoSize в false, растяните 
или сожмите размер компонента Image и установите Stretch в true. Вы увидите, 
что рисунок займет всю площадь компонента, но поскольку вряд ли реально уста- 
новить размеры Image точно пропорциональными размеру рисунка, то изображе- 
ние исказится. Устанавливать Stretch в true может иметь смысл только для ка- 
ких-то узоров, HO не для картинок. Свойство Stretch не действует на изображения 
пиктограмм, которые не могут изменять своих размеров (см. раздел 5.1.1.3). 

Свойство — Center, установленное в true, центрирует изображение на площа- 
ди Image, если размер компонента больше размера рисунка. 

Рассмотрим еще одно свойство — Transparent (прозрачность). Если Transpa- 
rent равно. true, то изображение в Image становится прозрачным. Это можно ис- 
пользовать для наложения изображений друг на друга. Поместите на форму вто- 
рой компонент Image и загрузите в него другую картинку. Только постарайтесь 
взять какую-нибудь мало заполненную, контурную картинку. Можете, например, 
взять картинку из числа помещаемых обычно на кнопки, например, стрелку (файл 
...\program files\common files\borland shared\images\buttons\arrow|r.bmp). Передвиньте 
ваши Image Tak, чтобы они перекрывали друг друга, и в верхнем компоненте уста- 
новите Transparent равным true. Вы увидите, что верхняя картинка перестала 3a- 
слонять нижнюю. Одно из возможных применений этого свойства — наложение на 
картинку надписей, выполненных в виде битовой матрицы. Эти надписи можно 
сделать с помощью встроенной в C++Builder программы Image Editor, которая бу- 
дет рассмотрена позднее. 

Учтите, что свойство Transparent действует только на битовые матрицы (0 TH- 
пах графических файлов см. в разделе 5.1.1.3). 


5.1.1.2 Простое приложение для просмотра графических файлов 


Вы создали приложение, в котором на форме отображается выбранная вами в 
процессе проектирования картинка. Вы можете легко превратить его в более инте- 
ресное приложение, в котором пользователь сможет просматривать и загружать 
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любые графические файлы. Для этого достаточно перенести на форму компонент 
OpenPictureDialog, расположенный в библиотеке на странице Dialogs и вызываю- 
щий диалоговое окно открытия и предварительного просмотра изображения 
(рис. 5.2), а также кнопку, запускающую просмотр или меню с единственным раз- 
делом Файл. 

А теперь вам осталось написать всего один оператор в обработчике щелчка на 
кнопке или на разделе меню: | 


if (OpenPictureDialogl->Execute() ) 
Imagel->Picture->LoadFromFile (OpenPictureDialogl->FileName) ; 


Этот оператор загружает в свойство Picture компонента Imagel файл, выбран- 
ный в диалоге пользователем. Выполните свое приложение и проверьте его в рабо- 
те. Щелкая на кнопке вы можете выбрать любой графический файл и загрузить 
его в компонент Imagel. 

В таком приложении есть один недостаток — изображения могут быть разных 
размеров и их положение на форме или будет несимметричным, или они не будут 
помещаться в окне. Это легко изменить, заставив форму автоматически настраи- 
ваться на размеры изображения. Для этого надо установить в компоненте Imagel 
свойство AutoSize равным true, а приведенный ранее оператор изменить следую- 
щим образом: 


if (OpenPictureDialogl->Execute() ) 
{ 
Imagel->Picture->LoadFromFile (OpenPictureDialogl->FileName) ; 
Forml->ClientHeight = Imagel->Height + 10; 
Imagel->Top = Forml->ClientRect.Top 
+ (Forml->ClientHeight — Imagel->Height) / 2; 
Forml->ClientWidth = Imagel->Width + 10; 
Imagel->Left = Forml->ClientRect.Left 
+ (Forml->ClientWidth — Imagel->Width) / 2; 
} 


В этом коде размеры клиентской области формы устанавливаются несколько 
больше размеров компонента Imagel, которые в свою очередь адаптируются к раз- 
меру картинки благодаря свойству AutoSize. 

Запустите теперь ваше приложение, и вы увидите (рис. 5.3), что при различ- 
ных размерах изображения ваше приложение выглядит отлично. 


6) |, Просмотр графики 
‚ Файя. 


Рис. 5.3 °) 
Адаптация формы к размерам 
изображения 


5.1.1.3 Форматы графических файлов 


Прежде, чем продвигаться дальше, поговорим немного о форматах графиче- 
ских файлов. C++Builder поддерживает три типа файлов — битовые матрицы, 
пиктограммы и метафайлы. Все три типа файлов хранят изображения; различие 
заключается лишь в способе их хранения внутри файлов и в средствах доступа к 
ним. Битовая матрица (файл с расширением .bmp) отображает цвет каждого пик- 
селя в изображении. При этом информация хранится таким образом, что любой 


f 
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компьютер может отобразить картинку с разрешающей способностью и количест- 
вом цветов, соответствующими его конфигурации. 

Пиктограммы (файлы с расширением .ico) — это маленькие битовые матрицы. 
Они повсеместно используются для обозначения значков приложений, в быстрых 
кнопках, в пунктах меню, в различных списках. Способ хранения изображений в 
пиктограммах схож с хранением информации в битовых матрицах, но имеются и 
различия. В частности, пиктограмму невозможно масштабировать, она сохраняет 
тот размер, в котором была создана. 

Метафайлы (Metafiles) хранят не последовательность битов, из которых COCTO- 
ит изображение, а информацию о способе создания картинки. Они хранят последо- 
вательности команд рисования, которые и могут быть повторены при воссоздании 
изображения. Это делает такие файлы, как правило, более компактными, чем би- 
товые матрицы. 

C++Builder 5 может работать со следующими файлами: 


-JPg, -jpeg 
Битовые матрицы (Bitmaps) .bmp | 


5.1.1.4 Классы для хранения графических объектов 
TPicture, TBitmap, Ticon и TMetafile 


Выше были рассмотрены типы графических файлов. Для хранения графиче- 
ских объектов, содержащихся в битовых матрицах, пиктограммах и метафайлах, 
в C++Builder определены соответствующие классы — TBitmap, TIcon и TMetafile. 
Все они являются производными от абстрактного базового класса графических 
объектов TGraphic. Кроме того определен класс, являющийся надстройкой над 
TBitmap, TIcon и TMetafile и способный хранить любой из этих объектов. Это 
класс TPicture, с которым вы уже познакомились в начале этой главы. Он имеет 
свойство Graphic, которое может содержать и битовые матрицы, и пиктограммы, 
и метафайлы. Более того, он может содержать и объекты определенных пользова- 
телем графических классов, производных от TGraphic. Для доступа к графическо- 
му объекту можно использовать свойство TPicture->Graphic, но если тип графиче- 
ского объекта известен, то можно непосредственно обращаться к свойствам 
TPicture->Bitmap, TPicture->Icon или TPicture->Metafile. 

Для всех рассмотренных классов определены методы загрузки и сохранения в 
файл: — 


void fastcall LoadFromFile(const System: :AnsiString Filename) ; 


void _fastcall SaveToFile(const System::AnsiString Filename) ; 


При этом для классов TBitmap, ТТсоп и TMetafile формат файла должен соот- 
ветствовать классу объекта. Объект класса TPicture может оперировать с любым 
форматом. 

Для всех рассмотренных классов определены методы присваивания значений 
объектов: 


void _ Еаз®са11 Assign(TPersistent* Source) ; 
Однако, для классов TBitmap, TIcon и TMetafile присваивать можно только 


значения однородных объектов: соответственно битовых матриц, пиктограмм, мета- 
файлов. При попытке присвоить значения разнородных объектов генерируется ис- 
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ключение. Класс TPicture — универсальный, ему можно присваивать значения объ- 
ектов любых из остальных трех классов. А значение TPicture можно присваивать 
только тому объекту, тип которого совпадает с типом объекта, хранящегося в нем. 

Приведем пример. Часто в приложениях создается объект типа ТВ тар, Ha- 
значение которого — запомнить содержимое графического изображения и затем 
восстанавливать его, если оно будет испорчено или изменено пользователем. Код, 
решающий эту задачу, может иметь вид: 


// Объявление и создание объекта Bitmap 
Graphics::TBitmap *Bitmap = new Graphics::TBitmap(); 


void _fastcall TForml::FormDestroy(TObject *Sender) 
// Уничтожение Bitmap и освобождение памяти 


{ 
Bitmap->Free(); 
} 
ff ион ооо 
void _fastcall TForml::MOpenClick(TObject *Sender) 
// Загрузка изображения из файла в Bitmap и Imagel 


{ 
if (OpenPictureDialogl->Execute ()) 


{ 
Bitmap->LoadFromFile (OpenPictureDialogl->FileName) ; 
Imagel->Picture->Assign (Bitmap) ; 
} 
} 
f | Sr nen 
void  fastcall TForml::MSaveClick(TObject *Sender) 
// Сохранение изображения из Imagel в Bitmap 


{ 

Bitmap->Assign (Imagel->Picture) ; 

} 

‘dt (ear EEE nak x eqemanaemaaencee 

void _ fastcall TForml::MRestoreClick(TObject *Sender) 
// Восстановление изображения в Imagel из Bitmap 


{ 
Imagel->Picture->Assign (Bitmap) ; 


} 

В этом коде сначала объявляется переменная Bitmap типа TBitmap и создает- 
ся соответствующий объект. Если вы создали объект Bitmap, то надо не забыть его 
уничтожить при окончании работы и освободить от него память. Автоматически 
это не делается. Поэтому надо освобождать память, например, в обработчике собы- 
тия формы OnDestroy (процедура FormDestroy) методом Free: 


Bitmap->Free (); 
В процедуре MOpenClick в объект Bitmap методом LoadFromFile загружается 
изображение из выбранного пользователем файла. Затем оператор 
Imagel->Picture->Assign (Bitmap) ; 
присваивает значение графического объекта Bitmap свойству Picture компонента 


Imagel. Изображение тем самым делается видимым пользователю. 
Этот оператор можно записать иначе: 


Forml->Imagel->Picture->Bitmap->Assign (Bitmap) ; 
что даст тот же самый результат. 
Если надо переписать в Bitmap отредактированное пользователем в Imagel 


изображение (о редактировании будет рассказано в последующих разделах), это 
можно сделать оператором (процедура MSaveClick): 


Bitmap->Assign (Imagel->Picture) ; 
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Если же надо восстановить в Imagel прежнее изображение, испорченное по 
каким-то причинам, то это можно сделать оператором (процедура MRestoreClick): 


Imagel->Picture->Assign (Bitmap) ; 


Таким образом, мы видим, что методом Assign можно копировать изображе- 
ние из одного однотипного графического объекта в другой и обратно. 

Загружать изображения можно не только из файлов, но и из ресурсов прило- 
жения с помощью методов 


void _ Еаз®са11 ГоааЕгопВезопгсеМаме (1пе Instance, 
const System::AnsiString ResName) ; 


или 
void _ fastcall LoadFromResourceID(int Instance, int ResID); 


где ResName — имя графического объекта в файле ресурса, a ResID — ero иденти- 
фикатор. Например, оператор 


Bitmap1->LoadFromResourceName (HInstance, "MYBITMAP") ; 


загружает в объект Bitmapl из ресурса битовую матрицу с именем «MYBITMAP». 
Как создавать в ресурсах битовые матрицы и другие графические объекты будет 
рассказано в разделе 5.1.2.4. 

Имеются еще методы загрузки и выгрузки графических объектов в поток и в 
буфер обмена Clipboard, но эти методы используются относительно редко и вы мо- 
жете посмотреть их в справке по C++Builder. 


5.1.2 Редактор Изображений Image Editor 


5.1.2.1 Создание файла изображения 


В C++Builder имеется встроенный Редактор Изображений — Image Editor, ко- 
торый вызывается командой Tools | Image Editor. Окно Редактора Изображений пред- 
ставлено на рис. 5.4 а. Это сравнительно простой редактор с не очень богатыми воз- 
можностями. Он позволяет создавать изображения в виде битовых матриц, пикто- 
грамм, изображений курсоров и не только сохранять созданные изображения в 
виде файлов, но и сразу включать их в файл ресурсов приложения. В этом и заклю- 
чается его основное отличие от других, более мощных графических редакторов. 

Работа начинается с меню Не, в котором вы можете выбрать раздел Ореп — 
открыть новый файл изображения или ресурсов, или раздел New — создать новый 
файл. Если вы выбрали New, то вам предлагается сделать дополнительный выбор, 
определяющий вид файла, который вы хотите создать: 


Рис. 5.4 a) gO Image Editor - [Bitmap2. bmp] 
Окно Редактора м Ek ext View . Bitm 
Изображений (a) и i 
ero 
вспомогательное 
окно задания 
СВОЙСТВ 
изображения (6) 


ыыы 2. 
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Риме мот Ba Sen A Sy ease | 
Component Resource File (.dcr) | файл ресурсов компонента 
Bitmap File (.bmp) файл битовой матрицы 
Icon File (.ico) файл пиктограммы 

Cursor File (.cur) файл изображения курсора 


Пусть, например, вы хотите создать свой рисунок для битовой матрицы. То- 
гда, выбрав раздел Bitmap File, вы попадаете в окно (рис. 5.4 6), в котором должны 
выбрать размер (Size) матрицы по горизонтали (Width) и вертикали (Height), а также 
выбрать набор цветов: 2, 16 или 256. Вероятно, для начала вам будет вполне доста- 
точно 16 цветов. 

После сделанного выбора вы увидите в окне Редактора Изображений границы 
вашего будущего рисунка, как это показано на рис. 5.4 а. Вы можете начинать тво- 
рить. Раздел меню View предоставляет вам возможность увеличить изображение в 
2 раза (раздел Zoom п), уменьшить ранее увеличенное изображение (раздел Zoom 
Out) или посмотреть изображение в его реальном размере (раздел Actual Size). 

Расположенная слева инструментальная панель предоставляет вам следую- 
щий инструментарий, достаточно типичный для любого графического редактора: 


ХОЗ 


py Выделение прямоугольной области рисунка, которую = затем можно ‘пере. 
= двинуть мышкой, скопировать или вырезать в буфер обмена и т.п. 


И АИ ЗС. АИ SEBS И EEO ALE OOO PEGS, DEE PLIES ERE IB COCR NOCHE 


vy Выделение произвольной области рисунка, которую затем можно пере- 
“4S двинуть мышкой, скопировать или вырезать в буфер обмена и т.п. 


Просмотр отдельных пикселей — выделение прямоугольной области ри- 
сунка, которая затем увеличивается настолько, что можно работать с от- 
дельными пикселями 


Ластик, перемещение которого стирает изображение, окрашивая пиксе- 
ли вспомогательным цветом, если нажата левая кнопка мыши, или 
основным цветом, если нажата правая кнопка мыши 


Карандант, перемещение которого наносит линию основным цветом, 
если нажата левая кнопка мыши, или вспомогательным цветом, если 
нажата правая кнопка мыши. Толщина линии выбирается из набора, 
расположенного внизу инструментальной панели 


Кисть, перемещение которой окрашивает поверхность основным цветом, 
если нажата левая кнопка мыши, или вспомогательным цветом, если 
нажата правая кнопка мыши. Форма кисти выбирается из набора, рас- 
положенного внизу инструментальной панели 


Пульверизатор. Цвет зависит от нажатой кнопки мыши. Форма пятен вы- 
бирается из набора, расположенного внизу инструментальной панели. 


Ввод текста. Перед началом ввода или сразу в момент окончания можно 
пользуясь меню Тех! выбрать тип и размер шрифта 


Заполнитель, заливающий выбранным цветом любой нарисованный зам- 
кнутый контур или всю поверхность изображения 


Индикатор цвета, показывающий цвет пикселя, на который он указыва- 
ет. Его надо подвести к пикселю, цвет которого вы хотите выбрать, и 
щелкнуть левой или правой кнопкой мыши, если хотите соответственно 
назначить этот цвет основным, или вспомогательным 
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Кроме перечисленных инструментов на инструментальной панели вы можете 
видеть кнопки, соответствующие рисованию прямых линий, дуг, незаполненных и 
заполненных прямоугольников, прямоугольников со скругленными углами, эл- 
липсов. 

При выборе таких инструментов, как карандаш, кисть, пульверизатор, кноп- 
ки рисования линий, дуг, незаполненных фигур, внизу появляется палитра, по- 
зволяющая выбрать толщину линии или форму кисти. 

В нижней части Редактора Изображений (рис. 5.4 а) расположена палитра 
цветов. В ее левой части имеются два квадрата. Цвет левого из них — назовем его 
основным, используется, если при рисовании вы нажимаете левую кнопку мыши; 
цвет правого — вспомогательный, используется, если при рисовании вы нажимае- 
те правую кнопку мыши. 

Вот, собственно, и все премудрости. Если вы обладаете художественными спо- 
собностями (я, увы, ими не обладаю), то можете попробовать нарисовать что-ни- 
будь стоящее. Если же нет, то можете воспользоваться каким-нибудь готовым фай- 
лом .bmp (команда File | Open позволит вам его открыть) и что-то к нему добавить, 
например, текст. А еще проще — напишите просто текст и сохраните в виде файла 
-bmp. В дальнейшем вы можете наложить его в своем приложении на любой рису- 
нок с помощью свойства Transparent компонента Image, как было рассказано в 
разделе 5.1.1.1. 

Файл пиктограммы создается аналогично. Вы можете создать, например, не- 
сложный файл пиктограммы и затем использовать его как вашу фирменную пик- 
тограмму во всех своих приложениях. 


5.1.2.2 Создание пиктограммы для шаблона компонента в библиотеке 


Рассмотрим отдельно возможную процедуру создания собственных пикто- 
грамм для библиотеки компонентов, если вы помещаете туда новый компонент 
или шаблон. Вы научитесь разрабатывать свои шаблоны и компоненты для биб- 
лиотеки в главе 7. А пока посмотрим, как их можно украсить собственными пик- 
тограммами. 

Эти пиктограммы должны иметь формат файла .bmp размером 24 на 24. Вы 
можете, конечно, нарисовать сами нужную пиктограмму, если сумеете. Но по- 
скольку у меня, например, художественные способности отсутствуют, то мне пред- 
ставляется более легким и более качественным следующий путь. | 

Вы создаете новое приложение C++Builder, переносите на форму компонент, 
похожий на тот, который создаете, и изменяете в нем то, что надо. Например, в 
разделе 7.2 описана процедура создания шаблона окна редактирования, которое 
разрешает вводить только цифры. Вы можете взять за основу обычный компонент 
Edit, поместить его на форму и установить в нем текст «0», что укажет пользовате- 
лю на специфику компонента. Далее надо уменьшить его размеры настолько, что- 
бы он нормально помещался в размер 24 на 24. При необходимости можно ум 
шить соответственно размер шрифта (в этом вам часто может помочь шрифт Small 
Fonts). Полезно установить в false свойство AutoSize. Иначе высота компонента 
при выполнении приложения будет задана автоматически. 

Затем вы запускаете приложение на выполнение и нажимаете клавиши 
Alt+Print Screen. В результате изображение окна вашего приложения будет записано 
в буфер обмена. 

После этого открываете Редактор Изображений (Tools | Image Editor), выполняе- 
те команду File | New | Bitmap File (.bmp) и в открывшемся окне (рис. 5.4 6) задаете раз- 
мер 24 на 24. Перед вами откроется окно заготовки вашего рисунка. Выполняете 
команду Edit | Paste, которая скопирует изображение из буфера обмена в вашу заго- 
товку рисунка. Остается только мышью сдвинуть его так, чтобы изображение ин- 
тересующего вас компонента попало в центр рамки рисунка. Затем выполняете ко- 
манду File | Save Аз и сохраняете рисунок в файле. Далее можете использовать его 
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как пиктограмму в библиотеке компонентов (см. раздел 7.2, рис. 7.1, в котором за- 
гружается только что описанная пиктограмма). 

Мы рассмотрели создание пиктограммы для включаемого в библиотеку ново- 
го шаблона компонента. Пиктограммы новых компонентов делаются точно так же, 
но они выполняются не в виде отдельных файлов, а включаются в файлы ресурсов, 
о которых пойдет речь ниже. 


5.1.2.3 Создание пиктограммы для кнопки 


Теперь мы попробуем создать пиктограмму для кнопки. Такие кнопки, как 
SpeedButton и BitBtn, могут воспринимать пиктограммы, загружаемые в их свой- 
ство Gliph. Одно изображение пиктограммы имеет размер 16х16. Но в одном фай- 
ле может содержаться до четырех изображений такого размера. Самое левое соот- 
ветствует отжатой кнопке. Второе слева соответствует недоступной кнопке, когда 
ее свойство Enabled равно false. Третье слева изображение используется при нажа- 
тии пользователя на кнопку при ее включении. Четвертое слева изображение ис- 
пользуется в кнопках с фиксацией (в SpeedButton) для изображения кнопки’в на- 
жатом состоянии. 

Давайте сделаем пиктограмму по полной программе — на 4 изображения. Соз- 
дайте новый файл битовой матрицы (File | New | Bitmap File (.bmp)) и в открывшемся 
окне (рис. 5.4 6) задаете размер.64х16. Разбейте изображение на 4 квадрата, разде- 
ленных белыми рамками в один пиксель (рис. 5.5 а), и закрасьте их в последова- 
тельности слева направо красным, серым, желтым и зеленым цветами. 


Рис. 5.5 о 
Создание пиктограммы для кнопки (а) 
и ее использование (6) 


При создании файла пиктограмм для кнопок надо иметь в виду, что левый 
| нижний пиксель задает цвет «прозрачности», т.е. цвет, который будет заменяться 
цветом поверхности кнопки. Поэтому, если вы, например, просто закрасите пер- 
вый квадрат, не задав ему рамку, то он не будет виден на кнопке. 

Сохраните созданный файл и постройте простое приложение, чтобы посмот- 
реть ваши пиктограммы в работе. Перенесите на форму (рис. 5.5 6) три кнопки: 
SpeedButtou, BitBtn и Button. В свойство Gliph кнопок SpeedButton и BitBtn за- 
грузите ваш файл пиктограмм. В свойстве Caption кнопки BitBtn задайте ка- 
кую-нибудь надпись, например «BitBtn». При этом вы сможете увидеть, что в 
свойствах кнопок NumGliphs установится равным 4. Поварьируйте свойствами 
Margin и Spacing кнопок, чтобы получить симметричное размещение пиктограмм 
и надписей. Для кнопки SpeedButton установите свойств GroupIndex равным 1, а 
свойство AllowAllUp в true. В обработчик щелчка кнолки Button вставьте код: 
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--BitBtn2->Enabled-= ! BitBtn2->Enabled; 
SpeedButton2->Enabled = ! SpeedButton2->Enabled; 

который будет переключать свойство доступности кнопок с пиктограммами. Te- 
перь выполните приложение и посмотрите, как будут меняться цвета кнопок при 
различных манипуляциях с ними. В отжатом состоянии пиктограммы.будут крас- 
ными. В момент нажатия они окрашиваются в желтый цвет. У нажатой кнопки 
SpeedButton цвет пиктограммы будет зеленым. А в недоступных кнопках цвет 
пиктограмм будет серым. 


5.1.2.4 Работа с файлами ресурсов 


В предыдущих разделах рассматривалась последовательность создания новых 
файлов картинок и пиктограмм. Теперь рассмотрим случай, когда требуется вклю- 
чить картинку, пиктограмму или курсор в файл ресурсов какого-то проекта или 
компонента. Файлы ресурсов проектов имеют расширение .res и содержат битовые 
матрицы (.bmp), пиктограммы (.ico), изображения курсоров (.cur), используемые в 
проекте. Файлы ресурсов компонентов имеют расширение .4сг (dynamic component 
гезоигсе — динамические ресурсы компонента) и могут включать такие же элемен- 
ты, как и файлы .res. 

В некоторых случаях включение изображений в файл ресурса — единственная 
возможность рештить ту или иную задачу. Например, если вы хотите ввести в CBO- 
ем приложении какой-то нестандартный курсор, это можно сделать, зарегистриро- 
вав его с помощью функции LoadCursor в свойстве Cursors компонента Screen (не- 
обходимые для этого операции подробно обсуждаются в разделе 4.5.6). Однако, 
для использования своего курсора надо сначала создать его и включить в ресурс 
приложения с помощью Редактора Изображений. Другой пример — создание пик- 
тограммы для нового компонента, включаемого вами в библиотеку C++Builder 
(см. разделы 5.1.2.2 и 7.3). Эта пиктограмма также должна быть создана не в виде 
отдельного файла, а как элемент ресурса компонента. 

Работа с файлом ресурса приложения в Редакторе Изображений обычно начи- 
нается командой Не | Ореп, открывающей файл ресурсов приложения .гез, в кото- 
ром вы хотите что-то изменить. Перед вами открывается окно, содержащее струк- 
туру файла в виде дерева (рис. 5.6 а). Сначала в нем может быть только один 
узел — Icon, содержащий вершину MAINICON, соответствующую стандартной пик- 
тограмме приложения. Добавить новые узлы вы можете с помощью команды 
Resource | New (ее вы можете найти и во всплывающем меню Редактора Изображе- 
ний), выполняя которую вам предоставляется возможность выбрать один из типов 
элементов: Bitmap, Cursor или Icon. Пусть, например, вы хотите использовать в сво- 
ем приложении нестандартный курсор в виде человечка с указкой. Вы выполняете 
Resource | New | Cursor и в дереве структуры файла ресурсов приложения появляется 
новая вершина. Вы должны задать ей то имя, которое в дальнейшем будете ис- 
пользовать в приложении при регистрации курсора функцией LoadCursor. Затем 
вы щелкаете на созданной вершине и вам открывается заготовка изображения 
курсора, в которой вы рисуете нужную картинку. 

При рисовании курсора в главном меню Редактора Изображений появляется 
раздел Cursor (см. рис. 5.6 а) с двумя подразделами: Set Hot Coot — указание горя- 
чей точки, и lest — тестирование. Горячая точка — это та точка изображения кур- 
сора, координатами которой являются параметры Х и У, передающиеся в обработ- 
чики событий мыши (см. раздел 4.3.1.2). При выборе раздела меню Set Hot Cpot or- 
крывается диалоговое окно (см. рис. 5.6 6), в котором вы должны задать горизон- 
тальную и вертикальную координаты горячей точки. Координаты задаются в пик- 
селях, т.е. чтобы правильно указать координату надо посчитать, на сколько клето- 
чек требуемая точка отстоит от левого верхнего угла рисунка. Например, для кур- 
сора на рис. 5.6 а в качестве горячей точки, очевидно, надо задать точку конца 
указки. 


алая д ай 
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Рис. 5.6 
Структура файла ресурсов приложения (а) 
и окно задания горячей точки курсора (6) 


После задания горячей точки вы можете выбрать раздел меню Cursor | Test. Пе- 
ред вами откроется окно, в котором курсор приобретет нарисованный вами вид. 
Нажав кнопку мыши и передвинув курсор, вы увидите, что за курсором тянется 
нарисованная линия. Вы можете видеть, из правильной ли точки курсора выходит 
эта линия, и при необходимости можете подкорректировать координаты горячей 
точки или само изображение курсора. 

Когда вы завершили создание курсора, надо вернуться в окно структуры фай- 
ла ресурса и выполнить команду File | Save. 

Несколько иначе, но подобным же образом создаются файлы ресурсов компо- 
нентов. Эта процедура иллюстрируется рисунком 5.7. Начинается работа с коман- 
ды File | New | Component Resource File (.4сг). Затем, если вы хотите создать пикто- 
грамму для регистрации вашего нового компонента в библиотеке, вы должны вы- 
полнить команду Resource | New | Bitmap и в открывшемся диалоговом окне задать 
размер картинки — 24 на 24. Только такой размер воспримется при регистрации 
вашего компонента в библиотеке. 

Затем вы должны назвать соответствующую вершину в дереве структуры фай- 
ла ресурсов тем же именем, которое имеет вводимый вами класс компонента. В 
противном случае C++Builder не воспримет это изображение как пиктограмму ва- 
шего компонента. И последнее требование. Ваш файл .4сг вы должна сохранить с 
именем, совпадающим с именем файла модуля, в котором вы создаете компонент, 
и в том же самом каталоге, в котором хранится. этот файл модуля. Например, 
рис. 5.7 подразумевает, что вы создаете компонент, описанный в разделе 7.3. 


Рис. 5.7 
Структура файла ресурсов компонента 
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Класс вашего компонента назван TEditLetNum, а имя модуля, в котором вы CO3+ 
даете свой компонент, — EditLetNum. 

Только при соблюдении всех перечисленных выше условий ваше изображение 
будет воспринято C++Builder как пиктограмма компонента и она будет использо- 
вана при установке компонента на странице библиотеки. 

А само создание изображения ничем не отличается от создания пиктограммы 
шаблона компонента, подробно описанного в разделе 5.1.2.2. 


5.1.3 Канва — холст для рисования 


5.1.3.1 Канва и пиксели 


Многие компоненты в C++Builder имеют свойство Canvas (канва, холст), 
представляющее собой область компонента, на которой можно рисовать или ото- 
бражать готовые изображения. Это свойство имеют формы, графические компо- 
ненты Image, PaintBox, Bitmap и многие другие. Канва содержит свойства и мето- 
ды, существенно упрощающие графику C++Builder. Все сложные взаимодействия 
с системой спрятаны для пользователя, так что рисовать в C++Builder может чело- 
век, совершенно не искушенный в машинной графике. 

Каждая точка канвы имеет координаты Х и У. Система координат канвы, как 
и везде в C++Builder, имеет началом левый верхний угол канвы. Координата Х 
возрастает при перемещении слева направо, а координата У — при перемещении 
сверху вниз. 

С координатами вы уже имели дело многократно, но пока вас не очень интере- 
совало, что стоит за ними, в каких единицах они измеряются. Координаты изме- 
ряются в пикселях. Пиксель — это наименьший элемент поверхности рисунка, с 
которым можно манипулировать. Важнейшее свойство пикселя — его цвет. Для 
описания цвета используется тип TColor. С цветом вы встречаетесь практически в 
каждом компоненте и знаете, что в C++Builder определено множество констант 
типа TColor. Одни из них непосредственно определяют цвета (например clBlue — 
синий), другие определяют цвета элементов окон, которые могут меняться в зави- 
симости от выбранной пользователем палитры цветов Windows (например, 
clBtnFace — цвет поверхности кнопок). Полный перечень этих констант с поясне- 
ниями см. в главе 16. 

Но для графики иногда этих предопределенных констант не хватает. Вам мо- 
гут понадобиться такие оттенки, которых нет в стандартных палитрах. В этом слу- 
чае можно задавать цвет 4-байтовым шестнадцатеричным числом, три младших 
разряда которого представляют собой интенсивности синего, зеленого и красного 
цвета соответственно. Например, значение $00ЕЕ0000 соответствует чистому сине- 
му цвету, $0000ЕЕ00 — чистому зеленому, $000000ЕЕ — чистому красному. 
$00000000 — черный цвет, SOOFFFFFF — белый. Более подробно об этом вы мо- 
жете посмотреть в соответствующем разделе главы 15. 


5.1.3.2 Рисование по пикселям 


Рисовать на канве можно разными способами. Первый вариант — рисование 
по пикселям. Для этого используется свойство канвы Pixels. Это свойство пред- 
ставляет собой двумерный массив Canvas->Pixels[int X][int У], который отвечает 
за цвета канвы. Например, Canvas->Pixels[10][20] соответствует цвету пикселя, 
10-го слева и 20-го сверху. С массивом пикселей можно обращаться как с любым 
свойством: изменять цвет, задавая пикселю новое значение, или определять его 
цвет_ по хранящемуся в нем значению. Например, Canvas->Pixels[10][20] = 
clBlackin — это задание пикселю черного цвета. 

Давайте попробуем нарисовать график некоторой функции Е(Х) на канве ком- 
понента Imagel, если известен диапазон ее изменения Утах и Ymin и диапазон 
изменения аргумента Хпип и Xmax. Это можно сделать такой процедурой: 
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float..x,Y; // координаты функции 
int РХ,РУ; // координаты пикселей 
for (PX = 0; PX <= Imagel->Width; PX++) 

{ 


//Х — координата, соответствующая пикселю с координатой PX 


X = Xmin+ PX * (Хтах — Xmin) / Imagel->Width; 
Y =F ЗУ | 
//РУ — координата пикселя, соответствующая координате У 
РУ = Imagel->Height — (У — Ymin) *Imagel->Height/(Ymax-Ymin); 
//Устанавливается черный цвет выбранного пикселя 
Imagel->Canvas->Pixels [PX] [РУ] = clBlack; 


} 


В этом коде вводятся переменные Х и У, являющиеся значениями аргумента и 
функции, а также переменные РХ и РУ, являющиеся координатами пикселей, со- 
ответствующими Х и У. Сама процедура состоит из цикла по всем значениям гори- 
зонтальной координаты пикселей PX компонента Imagel. Сначала выбранное зна- 
чение PX пересчитывается в соответствующее значение X. Затем производится вы- 
зов функции и определяется ее значение У. Это значение пересчитывается в верти- 
кальную координату пикселя РУ. И в заключение цвет пикселя с координатами 
(PX, РУ) устанавливается черным. 
Попробуйте создать соответствующее приложение и посмотреть, как оно рабо- 
тает. Пусть для простоты мы будем ориентироваться на функцию Sin(X), для кото- 
рой Xmin=0, Хтах=4р (2 периода в радианах), Ymin=-1, Ушах=1. 
Начните новый проект, поместите на него компонент Image и кнопку с надпи- 
сью «Нарисовать», в обработчик события OnClick которой запишите код, анало- 
гичный приведенному выше, но конкретизирующий функцию: 
#define Pi 3.14159 
fioat. а. // координаты функции 
int PX, PY; // координаты пикселей 
for (PX = 0; PX <= Imagel->Width; PX++) 
{ 

//Х — координата, соответствующая пикселю с координатой PX 
Х = PX * 4 * Pi / Imagel->Width; 
Y = sin(X); 

//РУ — координата пикселя, соответствующая координате У 


РУ = Imagel->Height — (У+1) * Imagel->Height / 2; 
//Устанавливается черный цвет выбранного пикселя 
Imagel->Canvas->Pixels[PX] [PY] = clBlack; 


4 


Откомпилируйте ваш проект, сохраните ero (мы еще к нему вернемся) и вы-. 
полните. Результат представлен на рис. 5.8 в его левой части. Правая часть будет 
рассмотрена в следующем разделе. 


Рис. 5.8 ‚ Де ция рисования по пикселям пером 
Рисование по пикселям и им с: | К Перо 
функцией ИпеТо A | 
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. 5.1.3.3 Рисование с помощью пера Pen 


У канвы имеется свойство Реп — перо. Это объект, в свою очередь имеющий 
ряд свойств. Одно из них уже известное вам свойство Color — цвет, которым нано- 
сится рисунок. Второе свойство — Width (ширина линии). Ширина задается в 
пикселях. По умолчанию ширина равна 1. 

Свойство Style определяет вид линии. Это свойство может принимать следую- 
щие значения: 


нее о НЙ НЯ и И ЕЕ р ООС Е i 


psSolid _ Сплошная д линия 

psDash Штриховая линия 

psDot Пунктирная линия 
psDashDot Штрих-пунктирная линия 


psDashDotDot Линия, чередующая штрих и два пунктира 
psClear Отсутствие линии 


psInsideFrame Сплошная линия, но при Width > 1 допускающая цвета, от- 
личные от палитры Windows 


Примеры линий всех стилей приведены на рис. 5.9. 


Рис. 5.9 


Линии различных стилей 


psDashD otDot 
psClear | . 
pslnsideFieme 


Все стили со штрихами и пунктирами доступны только при Width = 1. В про- 
тивном случае линии этих стилей рисуются как сплошные. 

Стиль psInsideFrame — единственный, который допускает произвольные цве- 
та. Цвет линии при остальных стилях округляется до ближайшего из палитры 
Windows. 

У канвы имеется свойство PenPos. Это свойство определяет в координатах 
канвы текущую позицию пера. Перемещение пера без прорисовки линии, т.е. из- 
менение PenPos, производится методом канвы MoveTo(X,Y). Здесь (X,Y) — коор- 
динаты точки, в которую перемещается перо. Эта текущая TOUKA CTAHOBUTCA ис- 
ходной, от которой методом LineTo(X,Y) можно провести линию в точку с коорди- 
натами (Х,У). При этом текущая точка перемещается в конечную точку линии и 
новый вызов LineTo будет проводить точку из этой новой текущей точки. 

Давайте попробуем нарисовать пером график синуса из предыдущего примера. 
Откройте прежний проект, добавьте на него еще один компонент Image и размес- 
тите компоненты так, как показано выше на рис. 5.8. Размеры обоих компонентов 
Image должны быть абсолютно одинаковы, так как на этом для экономии размера 
кода и вашего труда основана программа, которую мы напишем. Сделать размеры 
компонентов абсолютно одинаковыми легко, выделив их оба и воспользовавшись 
командой всплывающего меню Size. 

Затем в уже написанном вами обработчике щелчка на кнопке добавьте перед 
началом цикла оператор 


Image2->Canvas->MoveTo(0,Image2->Height / 2); 
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который переводит перо в начало координат второго графика — на левый край 
канвы в середину ее высоты. А в конце цикла добавьте оператор 


Image2->Canvas->LineTo (PX, РУ); 


который рисует Ha втором графике линию, соединяющую соседние точки. Иначе 
говоря, теперь ваш код должен иметь вид: 


#define Pi 3.14159 
float X,Y; // координаты функции 
int РХ,РУ; // координаты пикселей 
Image2->Canvas->MoveTo(0,Image2->Height / 2); 
for (PX = 0; PX <= Imagel->Width; PX++) 
{ 
//Х — координата, соответствующая пикселю с координатой PX 
Х = PX * 4 * Pi / Imagel->Width; 
Y = sin(X); 
//PY — координата пикселя, соответствующая координате У 
РУ = Imagel->Height — (Y+1) * Imagel->Height / 2; 
//Устанавливается черный цвет выбранного пикселя 
Imagel->Canvas->Pixels[PX] [РУ] = clBlack; 
//Проводится линия на втором графике 
Image2->Canvas->LineTo (РХ,РУ); 
} 


Для экономии кода мы воспользовались тем, что оба графика у нас абсолютно 
одинакового размера и, следовательно, пересчет координат достаточно провести 
для одного из них, а потом воспользоваться этими координатами для рисования 
обоих графиков. 

Откомпилируйте приложение и выполните его. Вы получите результат, пред- 
ставленный на рис. 5.8. Легко видеть, что качество двух одинаковых графиков 
сильно различается. В левом на крутых участках сплошной линии нет — она распа- 
дается на отдельные точки — пиксели. А правый график весь сплошной. Это пока- 
зывает, что при прочих равных условиях рисовать лучше не по пикселям, а пером. 

Отметим еще одно ценное свойство компонента Image и его канвы. Вы можете 
задавать координаты пикселей, выходящие за пределы размеров канвы, и ничего 
страшного при этом не случится. Это позволяет не заботиться о том, какая часть 
рисунка попадает в рамку Image, а какая нет. Вы можете легко проверить это, уве- 
личив, например, вдвое размах вашей синусоиды. Для этого достаточно изменить 
оператор, задающий значение Y, Ha следующий: 


У. =.2 * g2h (3 


a 


Вы получите результат, показанный на рис. 5.10. Изобразилась только та 
часть рисунка, которая помещается в рамку канвы. Это позволяет легко осуществ- 


Рис. 5.10 ГИ Демонстрация рисова селям м перо 
Изображение при размерах 
изображения, превышающих 
размер канвы 
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лять приложения, в которых пользователю предоставляется возможность увели- 
чивать и просматривать в деталях какие-то фрагменты графиков. 

Перо может рисовать не только прямые линии, но и фигуры. Ниже перечисле- 
ны некоторые из методов канвы, использующие перо для рисования фигур: 


В О о О О А в О оао ELIE EE 


Are Рисует дугу окружности или эллипса 

Chord Рисует замкнутую фигуру, ограниченную дугой окружности или 
‚ эллипса и хордой 

Ellipse Рисует окружность или эллипс 

Р1е Рисует сектор окружности или эллипса 

Polygon Рисует замкнутую фигуру с кусочно-линейной границей 

Polyline Pucyer кусочно-линейную кривую — 

Rectangle Рисует прямоугольник 


RoundRect — Рисует прямоугольник CO скругленными углами 


Примеры фигур приведены на рис. 5.11. 


Рис. 5.11 


Примеры фигур, нарисованных пером 


ГИ ЕЕ [1903 


SSS 


Ellipse 


ЕС 


Polygon Polyline - Rectangle RoundRect 


Ниже приведен текст процедуры, которая рисовала фигуры, показанные на 
рис. 5.11. Этот текст поможет вам понять методы, осуществляющие рисование фи- 
гур. Подробное описание методов рисования вы найдете в главе 16. 


Imagel->Canvas->Font->Style < fsBold; 
Imagel->Canvas->Arc(10,10, 90,90, 90,50,10,50); 
Imagel->Canvas->TextOut (40,60, "Arc") ; 
Imagel->Canvas->Chord(110,10,190,90,190,50,110,50); 
Imagel->Canvas->TextOut (135,60, "Спога"); 
Imagel->Canvas->Ellipse(210,10,290,50); 
Imagel->Canvas->TextoOut (230,60,"Ellipse") ; 
Imagel->Canvas->Pie (310,10, 390, 90, 390, 30, 310, 30) ; 
Imagel->Canvas->TextOut (340, 60, "Р1е"); 

TPoint points[5]; 


points[0] = 
points[1] 
points[2] = 
points[3] = 
points[4] = 


Point < 30, 150): 


= Point (40,130); 


Point (50,140); 
Point (60,130); 
Point (70,150); 


Imageli->Canvas->Polygon(points, 4); 
Imagel->Canvas->TextOut (30,170,"Polygon") ; 


points[0].x 
points[1].x 
points[2].x 


+= 100; 
+= 100; 
+= 100; 
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points[3].x += 100; 

points[4].x += 100; 
Imagel->Canvas->Polyline (points, 4) ; 
Imagel->Canvas->TextoOut (130,170, "Ро1у11пе"); 
Imagel->Canvas->Rectangle(230,120,280,160); 
Imagel->Canvas->TextoOut (230, 170, "Rectangle") ; 
Imagel->Canvas->RoundRect (330,120, 380,160, 20,20); 
Imagel->Canvas->TextOut (325,170, "RoundRect") ; 


Проглядите этот текст. Подобный пример вы можете увидеть на прилагаемом 
к книге диске. Там вы можете не только просмотреть текст, но и поменять пара- 
метры методов, чтобы лучше понять, как они работают. 

Для вывода текста на канву в приведенном примере использован метод 
TextOut, синтаксис которого: 


void _fastcall TextOut(int X, int Y, const System::AnsiString Text); 


Имеется еще несколько методов вывода текста, которые применяются реже. 
Все методы вывода текста используют свойство канвы Font — шрифт, с которым 
вы уже знакомы. В частности, в приведенном примере с помощью этого свойства 
установлен жирный шрифт надписей. | 


5.1.3.4 Brush — кисть 


У канвы имеется свойство Brush — кисть. Это свойство определяет фон и за- 
полнение замкнутых фигур на канве. Brush — это объект, имеющий в свою оче- 
редь ряд свойств. Свойство Color определяет цвет заполнения. Свойство Style оп- 
ределяет шаблон заполнения (штриховку). Возможные значения этого свойства 
см. в соответствующем разделе главы 16. 

Имеется еще одно свойство кисти — Bitmap, являющееся указателем Ha объ- 
ект типа TBitmap и определяющее нестандартное заполнение заданным шабло- 
ном. Шаблон задается битовой матрицей размером 8 на 8. Если для кисти задан 
шаблон Bitmap, то заполнение производится именно этим шаблоном, независимо 
от значения свойства Style. 

Шаблон Bitmap может создаваться в процессе выполнения приложения или, 
например, загружаться из файла, как в приведенном ниже примере, в котором фон 
формы заполняется загруженным шаблоном: 

Graphics::TBitmap *BrushBmp = new Graphics::TBitmap; 

try 

{ 

BrushBmp->LoadFromFile («MyBitmap.bmp») ; 
Forml->Canvas->Brush->Bitmap = BrushBmp; 
Forml->Canvas->FillRect (Rect (0,0, Forml->Width, Forml->Height) ); 

} 

__finally 

{ 

Forml->Canvas->Brush->Bitmap = NULL; 
delete BrushBmp; 

} 


В этом примере создается объект BrushBmp типа TBitmap и в него загружает- 
ся битовая матрица из фала с именем MyBitmap.bmp. Затем свойству Form1->Can- 
vas->Brush->Bitmap присваивается указатель на этот объект. После этого загру- 
женный шаблон можно использовать для заполнения фигур на канве формы. Ме- 
тод FillRect рисует на канве заполненный шаблоном прямоугольник, занимаю- 
щий всю площадь формы. Если подобный код вставить в обработчик события фор- 
мы OnResize, то и при изменении пользователем размеров формы ее поверхность 
будет вся заполнена шаблоном. После этого (а также в случае генерации каких-то 
исключений) Bitmap присваивается значение NULL, после чего заполнение опять 
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начинает определяться свойством Style. Затем объект BrushBmp уничтожается, 
чтобы освободить занимаемую им память. 
В приведенном примере использован метод канвы FillRect, объявленный как 


void _fastcall FillRect(const Windows::TRect &Rect); 


Он заполняет заданным стилем или шаблоном прямоугольную область, задан- 
ную параметром Rect. Этот параметр имеет тип TRect. Для его задания проще все- 
го использовать функцию Rect(X1,Y1,X2,Y2), возвращающую структуру Rect с 
координатами углов, заданных параметрами (Х1, Y1) и (Х2, Y2). 

Функцию FillRect удобно, в частности, использовать для стирания изображе- 
ния. Например, оператор 


Imagel->Canvas->FillRect (Rect (0,0, Imagel->Width, Imagel->Height) ); 


очищает всю площадь канвы компонента Imagel. 

Кисть участвует в заполнении фигур не только с помощью этой функции. Все 
перечисленные ранее методы рисования замкнутых фигур тоже заполняют их с по- 
мощью кисти. Это относится к методам Chord, Ellipse, Pie, Polygon и др. 

Имеется еще один интересный метод, работающий с кистью. Это метод 
FloodFill, который заполняет замкнутую область на канве. Этот метод определен 
следующим образом: 


void _ fastcall FloodFill(int X, int У, TColor Color, 
TFillStyle FillStyle) ; 


Точка с координатами Х и У является произвольной внутренней точкой запол- 
няемой области, которая может иметь произвольную форму. Граница этой области 
определяется сочетанием параметров Color u FillStyle. Параметр Color указывает 
цвет, который используется при определении границы заполняемой области, а па- 
раметр FillStyle определяет, как именно по этому цвету определяется граница. Па- 
раметр FillStyle может принимать одно из двух следующих значений: fsSurface 
или fsBorder. Если FillStyle = fsSurface, то заполняется область, окрашенная цве- 
том Color, a на других цветах метод останавливается. Если FillStyle = fsBorder, то 
наоборот, заполняется область окрашенная любыми цветами, не равными Color, a 
на цвете Со]ог метод останавливается. 

Для определения области закрашивания можно использовать координаты и 
цвет одного из пикселей, расположенных внутри области (если FillStyle = fsSur- 
face) или снаружи ee (если FillStyle = fsBorder). В следующем разделе 5.1.4 будет 
приведен пример использования метода FloodFill. 

Имеется еще один метод канвы, связанный с кистью. Это метод FrameRect. 
Он рисует на канве текущей кистью прямоугольную рамку, не закрашивая ее. 
Синтаксис метода FrameRect: 


void _ Еаз®са11 FrameRect (const Windows::TRect é&Rect) ; 


Параметр Rect определяет позицию и размеры прямоугольной рамки. Толщи- 
на рамки — 1 пиксель. Область внутри рамки кистью не заполняется. Метод 
FrameRect отличается от рассмотренного ранее метода Rectangle тем, что рамка 
рисуется цветом кисти (в методе Rectangle — цветом пера) и область не закраши- 
вается (в методе Rectangle закрашивается). 


5.1.4 Пример построения собственного простого графического 
редактора 


Давайте попробуем использовать полученные нами сведения для построения 
собственного простенького графического редактора, воспроизводящего некоторые 
функции настоящих редакторов. 
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1. Начните новое приложение. 


2. Перенесите на форму два компонента типа TImage и расположите их в ниж- 
ней левой части формы (рис. 5.12), придав квадратную форму, например, раз- 
мером 20 на 20. Это будут окна основного и вспомогательного цветов. Имена 
этих компонентов будут Imagel и Ппабе2. 


Рис. 5.12 И! 1; Графический редактор [=] x! 
Редактор изображений в работе: тестовая фа Пра Е en 
картинка (a) и работа с изображением, - 
загруженным из файла (6) 


3. Перенесите на форму еще один компонент типа Tlmage и расположите его в 
верхней части формы, несколько отступив от левого края, где у нас будет ин- 
струментальная панель, и растянув так, чтобы он занимал основную часть 
формы. Это будет холст для рисования. Имя этого компонента будет Imaged. 


4. Перенесите на форму еще один компонент типа TImage и расположите его 
внизу правее первых двух на одном с ними уровне. Это будет палитра цветов. 
Ее высоту задайте той же, что у первых двух компонентов, а длину — в 10 раз 
большую. Имя этого компонента будет Image4. 


5. Перенесите на форму кнопку типа TSpeedButton и расположите ее в верхнем 
левом углу формы. Эта кнопка будет соответствовать кисти — типичному ин-. 
струменту графических редакторов. Назовите ее SBBrush. Установите у кноп- 
ки свойство GroupIndex равным 1 и свойство AllowAllUp в true. Эти свойства 
обеспечат кнопке возможность фиксироваться в нажатом и не нажатом состоя- 
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нии (см. раздел 3.5.2). Желательно загрузить в свойство Glyph пиктограмму 
кисти (файл ..\lmages\Buttons\brush.bmp). 


6. Перенесите на форму еще одну кнопку типа TSpeedButton и расположите ee 
‚ ниже SBBrush. Эта кнопка будет соответствовать указателю цвета пикселя ри- 
сунка. Назовите ее SBColor. Установите у этой кнопки, как и у предыдущей, 
свойство GroupIndex равным 1 (это обеспечит, что только одна из двух кнопок 
может быть нажата) и свойство AllowAllUp в true. Желательно загрузить в 
свойство Glyph пиктограмму (например, файл ..\|тадез\. Butions\one2one.bmp). 


7. Перенесите на форму диалог OpenPictureDialog. 


8. Перенесите на форму главное меню Маш Мепи. В меню задайте раздел Файл с 
подразделом Открыть. Назовите этот подраздел МОреп. Задайте еще один раз- 
дел — Правка с подразделом Отменить. Назовите этот подраздел Undo. 


Теперь размещение компонентов закончено и можно писать обработчики со- 
бытий. Начнем со второстепенных обработчиков. 


9. В заголовочный файл модуля включите оператор: 
Graphics::TBitmap *BitMap = new Graphics::TBitmap; 


Этот оператор создает объект BitMap типа TBitmap. В этот объекте будет co- 
храняться изображение, чтобы его можно было восстановить командой Отменить. 


10. Для события OnCreate формы напишите обработчик вида: 


// задание свойств кисти основного и вспомогательного цветов 
Imagel->Canvas->Brush->Color с1В1аск; 
Image2->Canvas->Brush->Color clWhite; 

// заполнение окон основного и вспомогательного цветов 
Imagel->Canvas->FillRect (Rect (0,0, Imagel->Width, 

Imagel->Height) ); 
Image2->Canvas->FillRect (Rect (0,0, Image2->Width, 
Image2->Height) ); 

// задание ширины элемента палитры цветов 
int HW = Image4->Width / 10; 

// закраска элементов палитры цветов 
for(int 1 = 1; i <=10; 1++) 

{ 
Switch (i) 


{ 
case 1:Image4->Canvas->Brush->Color = clBlack; 


break; 

case 2:Image4->Canvas->Brush->Color = clAqua; 
break; 

case 3:Image4->Canvas->Brush->Color = clBlue; 
break; 

case 4:Image4->Canvas->Brush->Color = clFuchsia; 
break; 

case 5:Image4->Canvas->Brush->Color = clGreen; 
break; 

case 6:Image4->Canvas->Brush->Color = clLime; 
break; 

case 7:Image4->Canvas->Brush->Color = clMaroon; 
break; 

case 8:Image4->Canvas->Brush->Color = clRed; 
break; 

case 9:Image4->Canvas->Brush->Color = clYellow; 
break; 


case 10:Image4->Canvas->Brush->Color = clWhite; 
} 4 | 
Image4->Canvas->Rectangle((i-1) *HW,0,i*HW, 
Image4->Height) ; 
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} | 
// рисование креста на холсте — только для тестирования 
Image3->Canvas->MoveTo (0,0); 
Image3->Canvas->LineTo (Image3->Width, Image3->Height) ; 
Image3->Canvas->MoveTo (0, Image3->Height) ; 
Image3->Canvas->LineTo (Image3->Width, 0) ; 
BitMap->Assign (Image3->Picture) ; 


Обработчик длинный, HO смысл его достаточно прост. Сначала задаются свой- 
ства кисти окон основного (Imagel) и вспомогательного (Image2) цветов: черный и 
белый. Окна заливаются соответствующим цветом с помощью функции FillRect. 
После этого формируется палитра цветов: для каждого элемента палитры задается 
свой цвет и элемент заполняется этим цветом с помощью функции Rectangle. За- 
тем на холсте Image3 рисуется крест (рис. 5.12 а). Он имеет чисто демонстрацион- 
ный характер, чтобы можно было протестировать программу на простом изображе- 
нии. В реальной программе этот рисунок не нужен и, если хотите, можно эти опе- 
раторы не писать. В конце нарисованное на канве сохраняется в объекте ВИМар 
методом Assign. 


11. В обработчик события формы OnDestroy запишите оператор 
В1{Мар->Егее (); 


который освобождает память при закрытии приложения. 
12. Для подраздела меню Открыть в обработчик включите операторы: 


if (OpenPictureDialogl->Execute()) { 
Image3->Picture->LoadFromFile (OpenPictureDialogl->FileName) ; 
BitMap->Assign (Image3->Picture) ; 

} 


Эти операторы загружают в компонент Images файл изображения, который 
выбирает в диалоге пользователь, и запоминают изображение в BitMap. 


13. Для подраздела меню Отменить в обработчик включите ‘оператор: 
Image3->Picture->Assign (В1 Мар); 


Этот оператор восстанавливает на холсте изображение, сохраненное в ВИМар. 
14. В обработчик события OnClick кнопок SBBrush и SBColor запишите оператор 


if (((TSpeedButton *) Sender) ->Down) 
BitMap->Assign (Image3->Picture) ; 


Этот оператор запоминает в BitMap текущий вид изображения перед началом 
работы с очередным инструментом. 


15. В обработчик события OnMouseDown компонентов Image3 и Image4 вставьте 
код: 


if((Sender == Image4) || SBColor->Down) 
// режим установки основного и вспомогательного цветов 
{ ° 
if (Button == mbLeft) 
{ 
// установка основного цвета 
Imagel->Canvas->Brush->Color = 
((TImage *)Sender) ->Canvas->Pixels[X] [У]; 
Imagel->Canvas->FillRect (Rect (0,0, Imagel->Width, 
Imagel->Height) ); 
} 
else 
{ 
// установка вспомогательного цвета 
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Image2->Canvas->Brush->Color = 
((TImage *) Sender) ->Canvas->Pixels[X] [У]; 
Image2->Canvas->FillRect (Rect (0,0, Image2->Width, Image2->Height) ); 
} 
} 
else if (SBBrush->Down) 
// режим закраски указанной области холста 


{ 
if (Button==mbLeft) 

Image3->Canvas->Brush->Color = Imagel->Canvas->Brush->Color; 
else Image3->Canvas->Brush->Color = Image2->Canvas->Brush->Color; 
Image3->Canvas->FloodFill (X,Y, 

Image3->Canvas->Pixels[X] [Y],fsSurface) ; 


} 


Это основной код, осуществляющий как установку основного и вспомогатель- 
ного цветов, так и функцию инструмента графического редактора — кисти. Если 
кнопка мыши нажата на палитре цветов Image4 или если кнопка SBColor — кноп- 
ка указателя цвета утоплена, то приложение находится в режиме установки цве- 
тов. При нажатой левой кнопке мыши цвет пикселя под курсором мыши передает- 
ся в окно основного цвета, а при нажатии правой кнопки — в окно вспомогатель- 
ного цвета. 

Если кнопка мыши нажата на холсте Image3 и при этом кнопка SBBrush уто- 
плена, то приложение находится в режиме закраски указанной области рисунка. В 
этом случае в зависимости от нажатой кнопки мыши выбирается основной или 
вспомогательный цвет и функцией FloodFill производится закраска области, коор- 
динаты внутренней точки которой указаны курсором мыши, а цвет — цветом пик- 
селя, на который указывает мышь. 

Ваше приложение готово. В дальнейшем, после получения некоторых допол- 
нительных сведений о графике, вы, если захотите, сможете вернуться к нему и по- 
полнить новыми инструментами. 

Откомпилируйте приложение, сохраните его и выполните. Проверьте установ- 
ку цветов. При щелчке левой или правой кнопкой мыши на палитре цветов у вас 
будет меняться соответственно основной или вспомогательный цвет. Если вы на- 
жмете кнопку кисти в окне приложения, то при щелчке на холсте у вас должна за- 
крашиваться указанная курсором область в основной или вспомогательный цвет 
(рис. 5.12 а). Если вы отпустите кнопку кисти в окне приложения и нажмете кноп- 
ку определения цветов, то при щелчке на холсте у вас основной или вспомогатель- 
ный цвет будет устанавливаться равным цвету холста под курсором мыши. 

Если вы выполните команду Провка | Отменить, то изображение вернется к 
тому виду, какой был при начале работы с последним использованным инструмен- 
том. 

Теперь вы можете загрузить командой Файл | Открыть вашего приложения ка- 
кое-то изображение (на рис. 5.12 6 загружен файл ...\lImages\Splash\|16Co- 
lor\earth.bmb). Вы можете попробовать перекрашивать те или иные области изобра- 
жения. Например, можете изменить цвет фона, выделить какую-то сплошную об- 
ласть рисунка одного цвета (на рис. 5.12 6 выделена одна из областей облачного по- 
крова) ит.п. 

Итак, вы реализовали два из основных инструментов любого графического ре- 
дактора рисунков: кисть и индикатор цвета. Реализация остальных типичных ин- 
струментов требует предварительного ознакомления с режимами рисования, что 
будет сделано в следующем разделе 5.1.5. После этого вы сможете, вероятно, при 
желании вернуться к вашему графическому редактору и попробовать реализовать, 
например, инструменты, рисующие различные фигуры и перемещающие фрагмен- 
ты изображения. 
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5.1.5 Режимы рисования 


5.1.5.1 Режимы пера 


У пера Реп имеется еще одно свойство, которое мы пока не рассматривали. Это 
свойство — Mode (режим). Возможные значения Mode приведены в справочной 
части книги в главе 16. По умолчанию значение Моде = pmCopy. Это означает, что 
линии проводятся цветом, заданным в свойстве Color. Но возможны и другие pe- 
жимы, в которых учитывается не только цвет Color, но и цвет соответствующих 
пикселей фона. Наиболее интересным из этих режимов является режим 
pmNotXor — сложение с фоном по инверсному исключающему ИЛИ. Операция 
инверсного исключающего ИЛИ анализирует по битам два своих операнда. Ре- 
зультирующий бит равен «0», если соответствующие биты двух операндов не рав- 
ны друг другу, а при равенстве битов операндов результирующий бит равен «1». 

Вспомните, что каждый пиксель хранит цвет как набор битов. Пусть, напри- 
мер, фоновый пиксель имеет значение 0110011, а цвет пера установлен в 1111000. 
Применение операции pmNotXor к этим двум числам даст цвет со значением 
0110100. Этот цвет перо задаст данному пикселю. А теперь посмотрим, что полу- 
чится, если перо повторно пройдет по тому же пикселю. В этом случае опять будет 
выполнена операция pmNotXor по отношению к цвету пера 1111000 и текущему 
цвету пикселя, который стал равен 0110100. Применение pmNotXor к этим чис- 
лам даст в результате 0110011, т.е. первоначальный цвет пикселя. 

Это значит, что если нарисовать на фоне какую-то фигуру один раз, а затем на- 
рисовать ту же фигуру повторно, то нарисованная фигура исчезнет и каждый пик- 
сель вернется к своему первоначальному цвету. Эту особенность режима 
pmNotXor, свойственную также режиму ршХог — сложение с фоном по исклю- 
чающему ИЛИ, можно использовать для создания простенькой анимации. Доста- 
точно нарисовать нечто, затем стереть нарисованное, перерисовать немного изме- 
ненным — и рисунок будет представляться ожившим. В последующих разделах 
мы часто будем использовать такой режим рисования. 


5.1.5.2 Режимы копирования и рисования канвы 


Ранее мы рассматривали и использовали копирование одного графического 
объекта в другой методом Assign. Однако, у канвы имеются и другие методы копи- 
рования. Это прежде всего метод CopyRect, позволяющий копировать прямоуголь- 
ную область источника изображения в прямоугольную область данной канвы. Ме- 
тод определен следующим образом: 

void _ fastcall CopyRect (const Windows::TRect &Dest, 


TCanvas* -Canvas, 
const Windows::TRect &Source); 


Параметр Dest определяет прямоугольную область канвы, в которую произво- 
дится копирование. Параметр Canvas указывает источник, из которого копирует- 
ся изображение. Это может быть канва любого компонента: типа TImage, типа 
TBitmap и др. В частном случае источником может быть и канва того же компо- 
нента, в который производится копирование. Параметр Source определяет прямо- 
угольную область в источнике изображения, которая копируется в область Dest. 
Обе прямоугольные области и в источнике, и в приемнике имеют тип TRect. В раз- 
деле 5.1.3.4 этот тип и работающая с ним функция Rect уже были рассмотрены. 

Копирование — это не просто перенос изображения. В общем случае копирова- 
ние означает сложное взаимодействие копируемого изображения и того, которое 
было до этого в области, куда производится копирование. Характер этого взаимо- 
действия определяется параметром CopyMode (режим копирования) той канвы, в 
которую производится копирование. Вы можете в справочной части книги в главе 
16 посмотреть 15 различных значений этого параметра. По умолчанию значение 
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CopyMode равно cmSrcCopy. Это единственный режим, при котором производится 
действительное копирование: изображение в Dest стирается и заменяется скопиро- 
ванным. Есть два значения — cmWhiteness и cmBlackness, при которых собствен- 
но никакое копирование не производится: просто область закрашивается соответ- 
ственно белым или черным цветом. А все остальные режимы определяют сложное 
взаимодействие копируемого изображения с тем, которое было в Dest. Особый ин- 
терес представляет режим ст$гешуегф, при котором изображения канвы и источ- 
ника комбинируются, используя булеву операцию ХОК. Так же, как мы видели 
это для пера, повторное копирование в подобном режиме восстанавливает прежнее 
изображение на канве. Интересен также режим cmSrcAnd. Если копируемое изо- 
бражение представляет собой контурный черный рисунок на белом фоне, то этот 
рисунок наложится на прежнее изображение канвы, а белый фон будет прозрач- 
ным, так что под ним будет видно первоначальное изображение. В режиме 
emSrcPaint аналогичный эффект будет, если копируемое изображение представ- 
ляет собой белый контурный рисунок на черном фоне. 

Приведем примеры копирования в различных режимах. Операторы 

Imagel->Canvas->CopyMode = cmSrcCopy; 


Imagel->Canvas->CopyRect (Rect (0,0, 200,200) , Image2->Canvas, 
Rect (0,0,200,200)); 


обеспечивают копирование изображения фрагмента канвы компонента Image2 в 
указанную область канвы компонента Imagel. Изображение, которое ранее было 
на канве компонента Imagel в пределах области с координатами углов (0, 0) и 
(200, 200), просто заменяется новым. 

Операторы 

Imagel->Canvas->CopyMode = cmSrcInvert; 


Imagel->Canvas->CopyRect (Rect (0,0,200, 200) , Image2->Canvas, 
Rect (0,0,200,200)); 


Imagel->Canvas->CopyRect (Rect (0,0, 200,200) , Image2->Canvas, 
Rect (0,0,200, 200) ); 


обеспечивают копирование изображения фрагмента канвы компонента Image2 в 
указанную область канвы компонента Imagel в режиме cmSrclInvert. После вы- 
полнения функции CopyRect в первый раз изображения в компонентах Imagel и 
Image2 налагаются друг на друга, а в результате выполнения функции CopyRect 
во второй раз исходное изображение на канве компонента Imagel восстанавлива- 
ется. 

Операторы 

Imagel->Canvas->CopyMode = cmWhiteness; 


Imagel->Canvas->CopyRect (Rect (0,0, 200,200) , Image2->Canvas, 
Rect (0,0, 200,200) ); 


просто очищают указанную область канвы компонента Imagel, закрашивая ee бе- 
лым цветом. При этом изображение в компоненте Image2 никак не участвует в 
операциях копирования. 

На диске, прилагаемом к книге, имеется простой пример приложения, позво- 
ляющего наглядно посмотреть различные режимы копирования. 

В приложении имеются два окна, содержащие разноцветные горизонтальные 
и вертикальные полосы. Соответствующими кнопками любое из них можно загру- 
зить в третье окно, а затем скопировать в него изображение одного из первых двух 
окон. Предварительно в выпадающем списке можно выбрать режим копирования. 

Поэкспериментируйте с этим приложением, чтобы понять различия между ре- 
жимами копирования. Вы уже знаете все, чтобы самим спроектировать такое при- 
ложение. 
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Ещеодин метод копирования — BrushCopy вы можете посмотреть в справоч- 
ной части книги. Он сохраняется, как заявляют сами авторы C++Builder, только 
для совместимости с более ранними версиями системы. 

Помимо методов копирования свойство CopyMode используется также мето- 
дом рисования на канве Draw. Его описание: 


void _fastcall Draw(int X, int У, TGraphic* Graphic) ; 


Метод Draw рисует изображение, содержащееся в объекте, указанном пара- 
метром Graphic, сохраняя исходный размер изображения в его источнике и пере- 
нося изображение в область канвы объекта, верхний левый угол которой определя- 
ется параметрами Х и У. Источник изображения может быть битовой матрицей, 
пиктограммой или метафайлом. Если источник — объект типа ТВИтар, то пере- 
нос изображения производится в режиме, установленном свойством канвы 
CopyMode. . 

Например, оператор 


Imagel->Canvas->Draw (10,10, В1%мар1); 


рисует на канве компонента Imagel изображение из компонента Bitmap! в o6- 
ласть с координатами левого верхнего угла (10, 10). 

Еще один метод рисования — DrawFocusRect. Этот метод рисует изображение 
прямоугольника в виде, используемом для отображения рамки фокуса, операцией 
XOR. Функция DrawFocusRect объявлена следующим образом: 


void _fastcall DrawFocusRect (const Windows::TRect &Rect) ; 


где Rect — прямоугольная область. Поскольку при рисовании используется опера- 
ция ХОБ, то повторный вызов этого метода с тем же значением Rect удаляет изоб- 
ражение прямоугольника. 


5.1.6 Продолжение создания собственного графического 
редактора 


Теперь мы рассмотрели большинство вопросов, связанных с графикой. Можно 
вернуться к созданному нами ранее собственному графическому редактору (раз- 
дел 5.1.4) и попробовать его усовершенствовать. Подобный усовершенствованный 
редактор вы можете найти на диске, прилагаемом к книге. Его вид после выполне- 
ния ряда операций и в момент перетаскивания фрагмента изображения приведен 
на рис. 5.13. Редактор этот чисто демонстрационный и поэтому в нем нет многого, 
что должно быть в настоящем графическом редакторе. К тому же, и тот инстру- 
ментарий, который в нем имеется, надо бы было реализовать компактнее и с боль- 
шей надежностью. Но в данном случае, как и во всех демонстрационных приме- 
pax, функциональность принесена в жертву простоте и наглядности кода. 


Рис. 5.13 |; Графический реда 
Графический редактор в момент перетаскивания 
фрагмента изображения 


12 Зак. 322 
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Тем не менее, мы не будем подробно анализировать текст этого приложения. 
Рассмотрим только основные приемы, которые использованы при создании раз- 
личных инструментов. А общую логику работы вы можете придумать сами или по- 
заимствовать ее из примера. 

Приложение выполняет следующие функции: 


Ш Установка основного и дополнительного цветов. Щелчок на панели цветов ле- 
вой кнопкой мыши устанавливает основной цвет, а щелчок правой кнопкой — 
вспомогательный. 


Ш Кисть — кнопка SBBrush. Закрашивает замкнутую область, ограниченную 
цветом того пикселя, который указан щелчком мыши. При щелчке левой 
кнопкой закрашивание производится основным цветом, при щелчке правой 
кнопкой — вспомогательным. 


Ш Индикация цвета — кнопка SBColor. В этом режиме вы можете указать кур- 
сором мыши любой пиксель на изображении и, щелкнув левой кнопкой, уста- 
новить цвет этого пикселя как основной, а щелкнув правой кнопкой, устано- 
вить его как вспомогательный цвет. 


Ш Карандап — кнопка SBPen. В этом режиме вы можете рисовать произволь- 
ную кривую основным цветом. 


Ш Выделение фрагмента — кнопка SBRect. Фрагмент выделяется точечной рам- 
кой. Выделенный фрагмент можно в дальнейшем перетащить мышью на дру- 
roe место. Если в процессе перетаскивания нажата клавиша Cirl, то произво- 
дится копирование фрагмента, в противном случае — вырезание, при котором 

‚ область начального размещения фрагмента закрашивается вспомогательным 
цветом. Выделенный фрагмент может быть также скопирован или вырезан в 
буфер обмена Clipboard соответствующими командами меню. 


Ш Стирание изображения (ластик) — кнопка SBErase. Перемещение ластика за- 
крашивает область под ним во вспомогательный цвет. 


Ш Рисование прямоугольника — кнопка SBRectang. Рисуется прямоугольная 
рамка основным цветом. 


Ш Рисование заполненного прямоугольника — кнопка SBFillRec. Рисуется пря- 
моугольная рамка основным цветом и прямоугольник внутри закрашивается 
вспомогательным цветом. 


Ш Рисование прямой линии — кнопка SBLine. Рисуется прямая линия основ- 
ным цветом. | 

Ш Открытие графического файла — команда Фойл | Открыть. 

Ш Сохранение изображения в графическом файле — команда Файл | Сохранить 
как. 

Ш Отмена операций, выполненных последним использованным инструментом — 
команда Правка | Отменить. 

Ш Копирование или вырезание выделенного фрагмента изображения в буфер об- 
мена Clipboard — команды Правка | Копировать или Правка | Вырезать. 

Ш Вставка графического изображения типа битовой матрицы из буфера обмена 

Clipboard — команда Правка | Вставить. 

Начнем с рассмотрения функции выделения фрагмента. Она осуществляется 
методом DrawFocusRect. В этом режиме при событии OnMouseDown холста — 
компонента Images, выполняются операторы: 

// Запоминание начального положения курсора мыши . 

ХО = X; 

\0;= у; 


// формирование начального положения области фрагмента 
К.Тор = X; 
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R.Bottom = 
R.Left = Y; 
R.Right = Y; 


x; 


// Рисование рамки 
Image3->Canvas->DrawFocusRect (В); 
RBegin = true; ; 


Эти операторы запоминают координаты мыши Х и У в переменных XO и YO, 
задают начальные координаты прямоугольной области — переменной R типа 
TRect и рисуют рамку (пока нулевого размера) методом DrawFocusRect. Устанав- 
ливается также флаг начала выделения фрагмента — переменная RBegin. 

При событии OnMouseMove компонента Image3, если установлен флаг 
RBegin, выполняются операторы: 


// Стирание прежней рамки 
Image3->Canvas->DrawFocusRect (В); 


// формирование области В 


if (ХО < Х) { R.Left = ХО; R.Right = X; } 
else { R.Left = X; R.Right = ХО; } 

ТЕ (20 < 1) ТЕАТР = 10 а. Bottom = У] 
} 


else { R.Top = Y; R.Bottom = YO; 


// Рисование новой рамки 
Image3->Canvas->DrawFocusRect (В); 


Первый из этих операторов стирает прежнее изображение рамки (напомним, 
что метод DrawFocusRect рисует рамку с помощью операции ХОК). Два следую- 
щих оператора формируют новую область В, из начальных координат (ХО, YO) и те- 
кущих координат курсора (Х, У). Дело в том, что область, передаваемая в функ- 
цию ОгамЕоси$Кес&, должна быть сформирована «правильно» — значение R.Left 
должно быть меньше R.Right, а R.Top — меньше R.Bottom. Поскольку пользова- 
тель может перемещать курсор в любом направлении и соотношение координат 
(ХО, YO) и (Х, У) может быть любым, требуется упорядочивание координат. 

Последний оператор рисует рамку в новом положении. 

Итак, рамка, ограничивающая фрагмент нарисована. Теперь рассмотрим про- 
цедуру перетаскивания пользователем выделенного фрагмента. Если пользователь 
помещает курсор внутрь выделенной области и нажимает кнопку мыши, выполня- 
ются операторы: 


// Стирание прежней рамки 
Image3->Canvas->DrawFocusRect (К); 


// Установка флага перетаскивания 
RDrag = true; 


// Запоминание начального положения курсора мыши 


ХО = X; 
YO = Y; 
// Запоминание начального положения перетаскиваемого фрагмента 
RO = В; 


// Запоминание изображения 
BitMap->Assign (Image8->Picture) ; 


// Установка цвета кисти 
Image3->Canvas->Brush->Color = Image2->Canvas->Brush->Color; 


Первый оператор стирает рамку. Второй — устанавливает флаг перетаскива- 
ния — переменную RDrag. Два следующих оператора запоминают начальное поло- 
жение перетаскиваемого фрагмента в переменной RO типа TRect. Следующий опе- 
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‚ратор запоминает методом Assign изображение в момент начала перетаскивания в 
переменной Bitmap. Это необходимо, чтобы в процессе перетаскивания можно 
было восстанавливать испорченные места изображения и чтобы при желании 
пользователя можно было в дальнейшем отменить результат перетаскивания. По- 
следний оператор задает цвет кисти равным вспомогательному цвету, хранящему- 
ся в компоненте Image2. 

При событии OnMouseMove компонента Images, если установлен флаг RDrag; 
выполняются операторы: 


// Восстановление изображения под перетаскиваемым фрагментом 
Image3->Canvas->CopyRect (В, BitMap->Canvas,R) ; 


// Если не нажата клавиша Ctrl — стирание изображения в RO 
LE! Shift.Contains(ssCtrl)) 
Image3->Canvas->FillRect (RO) ; 


// Формирование нового положения фрагмента 
R.Left = R.Left + X - ХО; 
R.Right = R.Right + X — ХО; 
Ra Тор. = ‘Rs Top + У — YO; 
R.Bottom = R.Bottom + У — YO; 


// Запоминание положения курсора мыши 
ХО-= X; 


// Рисование фрагмента в новом положении 
Image3->Canvas->CopyRect (В, BitMap->Canvas, RO) ; 


// Рисование рамки 
Image3->Canvas->DrawFocusRect (В); 


Первый оператор восстанавливает изображение под перетаскиваемым фраг- 
ментом в его прежней позицией (т.е. стирает фрагмент), копируя соответствую- 
щую область методом CopyRect из компонента BitMap. Далее, если не нажата кла- 
виша Cirl, то очищается область начального размещения фрагмента (осуществляет- 
ся вырезание) методом ЕШКес+. В противном случае начальное изображение фраг- 
мента остается на месте. Затем запоминаются новые координаты курсора и новое 
положение фрагмента, после чего фрагмент и его рамка рисуются в новом положе- 
нии. 

Вот в общих чертах и все, что надо сделать для осуществления наиболее слож- 
ных операций — выделения фрагмента и его перетаскивания. 

Режимы рисования заполненного и не заполненного прямоугольников проще. 
Начало этих режимов по событию OnMouseDown и их продолжение по событиям 
OnMouseMove не отличаются от рассмотренного ранее режима выделения фраг- 
мента. Отличие только в том, что при завершении формирования пользователем 
прямоугольной рамки, т.е. при событии OnMouseUp, надо в данном случае нарисо- 
вать прямоугольник. Рисование заполненного прямоугольника осуществляется 
операторами: 

Image3->Canvas->Brush->Color = Image2->Canvas->Brush->Color; 


Image3->Canvas->Pen->Color = Imagel->Canvas->Brush->Color; 
Image3->Canvas->Rectangle(R.Left,R.Top,R.Right,R.Bottom) ; 


Они задают цвета кисти и пера и рисуют прямоугольник методом Rectangle. 
Рисование не закрашенного прямоугольника осуществляется операторами: 


Image3->Canvas->Brush->Color = Imagel->Canvas->Brush->Color; 
Image3->Canvas->FrameRect (R) ; 


Обратите внимание, что равным основному цвету задается цвет кисти, а не 
пера, поскольку метод FrameRect рисует цветом кисти. 
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Рисование прямой линии осуществляется следующим образом. Начало рисо- 
вания по событию OnMouseDown сводится к операторам: 


ХО = X; 
уф 
Xl = X; 
7. = 2s 


Image3->Canvas->Pen->Mode = pmNotxXor; 
Image3->Canvas->Pen->Color = Imagel->Canvas->Brush->Color; 


Они запоминают положение курсора в двух наборах переменных: (X0,YO) и 
(Х1, УП. Зачем нужны два набора — будет сказано позднее. Затем устанавливает- 
ся цвет пера и режим pmNotXor, который позволит при движении мыши стирать 
изображение линии. 

При событиях OnMouseMove работают следующие операторы: 


// Стирание прежней линии 
Image3->Canvas->MoveTo (Х0,У0); 
Image3->Canvas->LineTo(X1,Y1); 


// Рисование новой линии 
Image3->Canvas-—>MoveTo (X0,Y0) ; 
Image3->Canvas->LineTo (X,Y); 


// Запоминание новых координат конца линии 
Ri =; 
У: =: у; 


В этих операциях сначала парой методов МоуеТо и LineTo стирается линия в 
прежнем положении, а затем такой же парой методов рисуется новая линия. По- 
сле этого запоминаются новые координаты конца линии. 

Попробуем разобраться, зачем все так сложно. Ведь казалось бы, что достаточ- 
но всего двух операторов: 


Image3->Canvas->LineTo (X0, YQ); 
Image3->Canvas->LineTo (X,Y); 


Первый из них сотрет прежнюю линию, поскольку текущая позиция пера по- 
сле рисования этой прежней линии соответствовала концу линии (тем координа- 
там, которые мы храним в переменных X1, УТ). А второй оператор нарисует новую 
линию. И не надо хранить никаких координат. 

Tak просто нельзя сделать из-за одной тонкости: метод LineTo рисует линию, 
начинающуюся в текущей позиции пера и заканчивающуюся в указанной точке, 
исключая эту конечную точку. Поэтому, если выполнить в режиме pmNotXor 
приведенные выше операторы, то первый из них сотрет прежнюю линию, но оста- 
вит нестертой точку с координатами (Х0,У0) и кроме того нарисует точку в быв- 
шей позиции курсора, поскольку она как конечная была исключена при рисова- 
нии предыдущей линии. Таким образом, на концах линии останется «грязь» в 
виде концевых точек, которая и будет тянуться за перемещающимся курсором 
мыши. 

Заключительные операции при событии OnMouseUp аналогичны рассмотрен- 
ным выше, но дополняются переводом пера в режим pmCopy, при котором рисует- 
ся окончательная линия: 


// Стирание прежней линии 
Image3->Canvas->MoveTo (X0, YO) ; 
Image3->Canvas->LineTo(X1,Y1); 

// Рисование новой линии} 
Image3->Canvas->Pen->Mode = pmCopy; 
Image3->Canvas->MoveTo (X0, YO) ; 
Image3->Canvas->LineTo (X,Y) ; 
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Теперь рассмотрим инструмент Перо, позволяющий рисовать произвольные 
линии. Казалось бы естественной реализацией этого инструмента был бы следую- 
щий оператор, включаемый в обработчик события OnMouseMove: 


Image3->Canvas->Pixels[X] [У] = Imagel->Canvas->Brush->Color; 


который окрашивает пиксель под курсором в основной цвет. Однако, попробуйте 
так реализовать Перо и ничего хорошего не увидите. Курсор мыши перемещается 
быстро и события OnMouseMove происходят вовсе не при перемещении на сосед- 
ний пиксель. Поэтому ваша линия распадется на отдельные точки, тем более ред- 
кие, чем быстрее пользователь будет перемещать курсор. Линию, оставляемую 
курсором, следует рисовать тоже методом LineTo, поместив в обработчик события 
OnMouseMove оператор 


Image3->Canvas->LineTo (X,Y); 


Мы рассмотрели почти все инструменты, введенные в приложении рис. 5.13. 
Коротко перечислим оставшееся. Ластик реализуется методом FillRect, очищаю- 
щим изображение под его рамкой. Кисть, отмена команд и загрузка внешнего фай- 
ла рассматривались в разделе 5.1.4. Сохранение файла осуществляется с использо- 
ванием компонента типа SavePictureDialog оператором 


if (SavePictureDialogl->Execute () ) 
{ 
BitMap->Assign (Image3->Picture) ; 
BitMap->SaveToFile (SavePictureDialogl->FileName) ; 
} 


Изображение с холста сохраняется в компоненте Bitmap, из которого методом 
SaveToFile записывается в выбранный пользователем файл. 
Команды меню Копировать и Вырезать осуществляются процедурой 


void _ Еаз®са11 TForml::MCopyClick(TObject *Sender) 
{ 

// Стирание рамки 
Image3->Canvas->DrawFocusRect (К); 


// Создание временного объекта ВМСору 
Graphics::TBitmap *ВМСору = new Graphics: :TBitmap; 
BMCopy->Width = R.Right — R.Left; 

BMCopy->Height = R.Bottom — В.Тор; 

try 
{ 

// Копирование фрагмента в ВМСору 
BMCopy->Canvas->CopyRect (Rect (0,0, BMCopy->Width, 

BMCopy->Height), Image3->Canvas,R) ; 

// Восстановление рамки 

Image3->Canvas->DrawFocusRect (В); 


// Копирование в Clipboard 
Clipboard()->Assign (BMCopy) ; 
if (Sender == MCut) 

{ 

// Вырезание 
Image3->Canvas->Brush->Color = clWhite; 
Image3->Canvas->FillRect (В); 

} 
> 

__ finally 
{ 

// Освобождение памяти 

ВМСору->Егее (); 

} 
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Копированию или вырезанию подлежит ранее выделенный пользователем 
объект, местоположение и размеры которого определяются переменной R. Поэто- 
му сначала создается временный объект типа TBitmap, в который переносится ко- 
пируемый фрагмент. Затем этот объект копируется в буфер обмена Clipboard. Бла- 
годаря разделу __ finally память освобождается от временного объекта при любом 
исходе копирования: удачном или аварийном. 

Для работы с буфером обмена используется функция Clipboard, создающая 
объект типа TClipboard, инкапсулирующий свойства буфера обмена Windows. 

Аналогично реализуется команда Вставить, копирующая изображение из буфе- 
ра обмена Clipboard: 


void _fastcall TForml::MPasteClick(TObject *Sender) 
{ 
Graphics::TBitmap *BMCopy = new Graphics: :TBitmap; 
try 
{ 
try 
{ 
BMCopy->LoadFromClipboardFormat (CF BITMAP, 
Clipboard (\) ->GetAsHandle(CF BITMAP) ,0); 
Image3->Canvas->CopyRect (Rect (0,0, BMCopy->Width, 
BMCopy->Height), BMCopy->Canvas, 
Rect (0,0,BMCopy->Width, 
BMCopy->Height) ); 
} 
__finally 
{ 
ВМСору->Егее (); 


} 


} 
catch (EInvalidGraphicé&) 


{ 


ShowMessage ("Ошибочный формат графики"); 
} 
} 


Чтение из Clipboard осуществляется методом LoadFromClipboardFormat. 
Предусмотрен перехват исключения EInvalidGraphic, если в Clipboard содержится 
не битовая матрица. 

Попробуйте реализовать описанный графический редактор или разберитесь 
подробнее в его работе, посмотрев его код на прилагаемом к книге диске. Попро- 
буйте усовершенствовать редактор, добавив, в него, например, выбор ширины ли- 
ний, рисование эллипсов и т.д. Вы можете также усовершенствовать ваш графиче- 
ский редактор, введя в него различные курсоры в зависимости от выбранного поль- 
зователем инструмента. Методика создания собственных курсоров и включения их 
в файл ресурсов приложения описана в разделах 5.1.2.4 и 4.5.6. На рис. 5.14 пока- 
заны курсоры, подготовленные для включения в графический редактор. Изображе- 
ния вы можете нарисовать сами или почерпнуть их из примера Ехатр- 
les\Apps\Doodle\extrares.res, поставляемого с C++Builder 5. Чтобы перенести изо- 
бражения курсоров из одного файла в другой, вы можете открыть два Редактора 
Изображений и передать рисунки из одного редактора в другой через буфер обмена. 

Если вы включили таким образом курсоры в файл ресурсов, то использовать 
их в приложении можно следующим образом (см. раздел 4.5.6). Надо объявить 
глобальные переменные ваших курсоров: 


/ 


// константы курсоров 


const... int СЕ =. 1 
const int crPlus = 2; 
const int crDraw = 3; 
const int crErase = 4; 
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Рис. 5.14 
Курсоры для графического редактора 


#20 ERASE (Ро 


В событии формы OnCreate надо зарегистрировать курсоры операторами: 


// регистрация курсоров 

Screen->Cursors([crFill] LoadCursor(HInstance, «FILL»); 
Screen->Cursors[crPlus] LoadCursor(HInstance, «PLUS») ; 
Screen->Cursors[crDraw] = LoadCursor(HInstance, «DRAW») ; 
Screen->Cursors[crErase] = LoadCursor(HInstance, «ERASE») ; 


А в общем обработчике событий OnClick инструментальных кнопок ввести 
следующий код, задающий для компонента Images тот или иной вид курсора в за- 
висимости от нажатой кнопки: 


if((Sender == SBPen) | | (Sender == SBLine) ) 
Image3->Cursor = TCursor(crDraw) ; 

else if (Sender == SBBrush) 
Image3->Cursor = TCursor(crFill); 

else if (Sender == SBErase) 
Image3->Cursor = TCursor(crErase) ; 

else if (Sender == SBColor) 


Image3->Cursor = TCursor(crDefault) ; 
else Image3->Cursor = TCursor(crPlus) ; 


5.1.7 События OnPaint 


До сих пор мы рисовали в основном Ha канве компонента Image. Но канву 
имеет не только Image. Ее имеют и многие другие компоненты, например, формы. 
Все, что ранее вы рисовали на канве компонентов типа TImage, вы могли бы рисо- 
вать и на форме. Кроме того имеется специальный компонент Рай Вох, имеющий 
канву и позволяющий рисовать на ней. Рисование на PaintBox вместо формы не 
имеет никаких преимуществ, кроме, может быть, некоторого облегчения в распо- 
ложении одного или нескольких рисунков в площади окна. 

При рисовании на канве формы или Раш Вох надо учитывать некоторые осо- 
бенности. Давайте сначала выясним на собственном опыте, о чем идет речь. 

Откройте новое приложение, перенесите на него диалог OpenPictureDialog, 
кнопку и в обработчик щелчка на ней вставьте операторы: 


void _fastcall TForml::ButtonlClick(TObject *Sender) 


{ 
if (OpenPictureDialogl->Execute () ) 
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{ 
Graphics::TBitmap *Bitmap = new Graphics::TBitmap; 
Cry 
{ : 
Bitmap->LoadFromFile (OpenPictureDialogl->FileName) ; 
Canvas->Draw(0,0,Bitmap) ; 


} 
. Sinaily 


{ 
Bitmap->Free(); 


} 
} 
} 


Эти операторы обеспечивают загрузку выбранного пользователем графическо- 
го файла и отображение изображения непосредственно на канве формы (поскольку 
оператор Canvas->Draw относится к канве формы, можно было бы это уточнить, 
написав Form1->Canvas->Draw). Запустите приложение, выберите файл и вы уви- 
дите что-нибудь вроде представленного на рис. 5.15 а. А теперь, не закрывая сво- 
его приложения, вернитесь в C++Builder и, ничего там не делая, опять перейдите в 
свое выполняющееся приложение. Если окно Редактора Кода, выступившее на 
первый план при вашем переходе в C++Builder, целиком перекрыло окно вашего 
приложения, то вернувитись в него вы увидите, что картинка в окне исчезла. Если 
же вы опять загрузите в него картинку и сдвинете окно приложения так, чтобы 
окно Редактора Кода не могло целиком его закрыть, то, повторив эксперимент с 
переходом в C++Builder и обратно вы, возможно, увидите результат, подобный 
представленному на рис. 5.15 6. 


Рис. 5.15 

Демонстрация исходного 
изображения (а) и его 
стирания (6) при перекрытии 
его другим окном 


Вы видите, что если окно какого-то другого приложения перекрывает на вре- 
мя окно вашего приложения, то изображение, нарисованное на канве формы, пор- 
тится. В компоненте Image этого не происходило, поскольку в классе TIlmage уже 
предусмотрены все необходимые действия, осуществляющие перерисовку испор- 
ченного изображения. А при рисовании на канве формы или других оконных ком- 
понентов эти меры должен принимать сам разработчик приложения. 

Если окно было перекрыто и изображение испортилось, операционная систе- 
ма сообщает приложению, что в окружении что-то изменилось и что приложение 
должно предпринять соответствующие действия. Как только требуется обновление 
окна, для него генерируется событие OnPaint. В обработчике этого события (в на- 
шем случае события формы) нужно перерисовать изображение. 

Перерисовка может производиться разными способами в зависимости от при- 
ложения. В нашем примере можно было бы вынести объявление указателя Bitmap 
за пределы приведенной выше процедуры, т.е. сделать эту переменную глобаль- 
ной: 

Graphics::TBitmap *Bitmap; 
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Тогда приведенная выше процедура загрузки файла сокращается до 


if (OpenPictureDialogl->Execute() ) 
{ 


Bitmap = new Graphics: :TBitmap; 
Bitmap->LoadFromFile (OpenPictureDialogl->FileName) ; 
Canvas~->Draw(0,0,Bitmap) ; 

} 


Оператор Bitmap->Free(), содержавшийся ранее в этой процедуре, переносит- 
ся в обработчик события формы OnDestroy. Тогда в течение всего времени выпол- 
нения вашего приложения вы будете иметь копию картинки в компоненте Bitmap и 
вам достаточно ввести в обработчик события OnPaint формы всего один оператор: 


if (Bitmap != NULL) Canvas->Draw(0,0,Bitmap) ; 


Оператор if используется, чтобы избежать ошибочного обращения к Bitmap, 
пока графический файл еще не загружался и объект Bitmap не создан. 

Сделайте это, и увидите, что изображение на форме не портится при любых пе- 
рекрытиях окон. 

Сделанный вами обработчик перерисовывает все изображение, хотя, может 
быть, испорчена только часть его. При больших изображениях это может сущест- 
венно замедлять перерисовку и вызывать неприятные зрительные эффекты. Пере- 
рисовку можно существенно ускорить, если перерисовывать только испорченную 
область канвы. У канвы есть свойство ClipRect типа TRect, которое в момент обра- 
ботки события OnPaint указывает область, которая подлежит перерисовке. Поэто- 
му более экономным будет обработчик: 

if (Bitmap != NULL) 

Canvas->CopyRect (Canvas->ClipRect, Bitmap->Canvas, 
Canvas->ClipRect); 


Он перерисовывает только область ClipRect, которая испорчена. 


5.2 Мультимедиа и анимация 
5.2.1 Звук 


5.2.1.1 Типы звуковых и мультимедиа файлов 


Так же, как существует множество рассмотренных нами форматов графиче- 
ских файлов, существует немало файлов звуковых и мультимедиа. Мы коротко 
охарактеризуем обе эти группы файлов в рамках данного раздела, так как файлы 
мультимедиа часто содержат звуковую дорожку и было бы не очень правомерно го- 
воря о звуке не упомянуть звук в мультимедиа. 

Наиболее простым звуковым файлом является волновой файл .wav. В нем за- 
писано цифровое представление информации о волновой форме электрического 
сигнала, соответствующего каждому звуку. Волновой файл «не знает» вообще ни- 
чего о том, что такое звук и что он означает; поэтому для хранения звукового кли- 
па приходится запоминать массу информации. 

Другим часто применяемым типом файлов-носителей являются файлы цифро- 
вого интерфейса музыкальных инструментов (MIDI). Файлы .midi используются 
для хранения музыкальных фрагментов. В этих файлах звук хранится в виде дан- 
ных о том, на каких инструментах исполняются определенные ноты и как долго 
они звучат. Если вы знакомы с музыкой, то можете рассматривать содержимое та- 
кого файла как цифровой эквивалент дирижерской партитуры. Одним из главных 
преимуществ MIDI является то, что файлы получаются сравнительно небольшими. 
Файлы MIDI относятся к волновым файлам примерно так же, как метафайлы — к 
файлам .bmp. В обоих случаях файлы первого типа «понимают», какие данные 
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они представляют, а файлы второго типа хранят сырые данные, просто посылае- 
мые на выходное устройство. 

Волновые и MIDI файлы могут хранить только звук или музыку. Для хране- 
ния видео информации разработан ряд форматов. Отметим среди них файлы AVI u 
МРЕС. Большинство видеофайлов поддерживают также хранение звуковой дорож- 
ки, так что звук воспроизводится синхронно с картинкой. 

Что собой представляет видеофайл, и как он работает? Человеческий мозг ин- 
терпретирует быструю последовательность изображений, незначительно отличаю- 
щихся друг от друга, как движение. Каждое из этих изображений называется ка- 
дром. Каждый следующий кадр несколько отличен от предыдущего. Чтобы мозг 
воспринимал смену кадров как плавное движение, желательно воспроизводить 
около 30 кадров в секунду. Более высокая частота не приводит к заметному росту 
качества, а более низкая производит впечатление мерцания экрана. 

Если бы каждый кадр хранился в файле в виде битовой матрицы экрана (а это 
несколько сотен килобайт), то потребовался бы огромный объем дисковой памяти. 
При такой простой схеме хранения на компакт-диск, например, можно было бы 
записать всего 72 секунды видеофильма. Реально для хранения видеофильмов ис- 
пользуется техника сжатия видеоданных. 

Если не углубляться в сложную математику методов сжатия, то суть сводится 
к следующему. Когда захватывается очередной кадр, аппаратура или программа 
сжатия задается вопросом: «Можно ли сохранить этот кадр более компактно, если 
записать только то, что в нем отличается от предыдущего, или нужно сохранить 
картинку целиком?» Чаще всего выгодно сохранять только изменившиеся части 
сцены. Но в определенных обстоятельствах, например, при переключении на дру- 
гую камеру, накладные расходы описания изменений заняли бы больше места, 
чем непосредственное сохранение кадра. 

В методах хранения мультимедиа достигнуты большие успехи. Сейчас можно 
записать целый полнометражный кинофильм на стандартном CD-ROM. 


5.2.1.2 Процедуры воспроизведения звуков Веер, MessageBeep 
и PlaySound 


Наиболее простой процедурой, управляющей звуком, является процедура 
Веер. Она не имеет параметров и воспроизводит стандартный звуковой сигнал, ус- 
тановленный в Windows, если компьютер имеет звуковую карту и стандартный 
сигнал задан (он устанавливается в программе Windows «Панель управления» по- 
сле щелчка на пиктограмме Звук). Если звуковой карты нет или стандартный сиг- 
нал не установлен, звук воспроизводится через динамик компьютера просто в виде 
короткого щелчка. 

Откройте новое приложение, введите в него кнопку, в обработчике щелчка KO- 
торой напишите одно слово: 


Beep () ; 


Можете запустить приложение, щелкнуть на кнопке и прослушать стандарт- 
ный звук Windows или просто щелчок, если стандартный звук не установлен. 
Более серьезной процедурой является функция Windows АРТ MessageBeep: 


bool MessageBeep(int аТуре); 


Параметр uType указывает воспроизводимый звук как идентификатор разде- 
ла [sounds] реестра, в котором записаны звуки, сопровождающие те или иные со- 
бытия в Windows. С помощью приложения Звук в «Панели управления» пользова- 
тель может удалить или установит соответствующие звуки. 

Параметр uType может иметь следующие значения: 
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Ca 


Значение Звук 

МВ 1СОМАЗТЕВ1$ К 
MB_ICONEXCLAMATION 
МВ 1СОМНАМО 
MB_ICONQUESTION 


| 


| 
| 
| 
| 
| 
| 
$ | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


SystemAsterisk — звездочка 


SystemExclamation — восклицание 
SystemHand — критическая ошибка 


| 
| 


SystemQuestion — вопрос 


SystemDefault — стандартный звук 

После запроса звука функция MessageBeep возвращает управление вызвав- 
шей функции и воспроизводит звук асинхронно. Во время воспроизведения прило- 
жение может продолжать выполняться. 

Если невозможно воспроизвести указанный в функции звук, делается попыт- 
ка воспроизвести стандартный системный звук, установленный по умолчанию. 
Если и это невозможно, то воспроизводится стандартный сигнал через динамик. 

При успешном выполнении возвращается ненулевое значение. При аварийном 
завершении возвращается нуль. 

Можете в своем тестовом приложении ввести еще одну кнопку и написать для 
нее обработчик: 


MessageBeep (MB OK); 


Вы услышите TOT же стандартный звук Windows, что и при выполнении про- 
цедуры Веер. Или услышите тот же тихий щелчок, если стандартный звук не уста- 
новлен. Попробуйте установить различные звуки с помощью «Панели управле- 
ния» и проверить MessageBeep при различных значениях ее параметра. 

А теперь давайте займемся более серьезной функцией PlaySound, которая по- 
зволяет воспроизводить не только звуки событий Windows, но и любые волновые 
файлы. Это функция АРТ Windows, параметры которой описаны в модуле 
mmsystem. Поэтому для использования этой функции в вашем приложении необ- 
ходимо включить директиву #include <mmsystem.cpp>, поскольку автоматически 
C++Builder ее не включает. 

Функция PlaySound определена следующим образом: 


bool PlaySound(char * pszSound, HINST hmod, int fdwSound);. 


Параметр pszSound представляет собой строку с нулевым символом в конце и 
определяет воспроизводимый звук. Параметр hmod используется, если звук берет- 
ся из ресурса. А поскольку далее звуком из ресурса мы пользоваться не будем, то 
hmod всегда можно задавать равным 0. 

Параметр fdwSound является множеством флагов, которые определяют ре- 
жим воспроизведения и тип источника звука. Полное описание возможных значе- 
ний флагов вы можете найти в главе 15 в разделе 15.7.3. Ниже приведены только 
некоторые из них, но наиболее важные для воспроизведения произвольных волно- 
вых файлов: 


SND_ASYNC Звук воспроизводится асинхронно и функция PlaySound воз- 
вращается немедленно после начала воспроизведения. Чтобы 
прекратить асинхронное воспроизведение волнового файла, 
надо вызвать PlaySound с параметром pszSound, равным 0 


SND_LOOP Воспроизведение звука постоянно повторяется, пока HE вызо- 
вется PlaySound с параметром pszSound, равным 0. Одновре- 
менно надо установить флаг ЗМО_АЗУМС асинхронного вос- 
произведения звука 


” 
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5МО_ МОТОР Если заданный звук не может быть воспроизведен, поскольку 
ресурсы, необходимые для воспроизведения, заняты воспроиз- 
ведением другого звука, функция PlaySound немедленно вер- 
нет false, не воспроизводя заданного звука. Если данный флаг 
не указан, функция PlaySound пытается остановить воспроиз- 
ведение другого звука, чтобы устройство могло быть использо- 
вано для воспроизведения нового звука 


SND_NOWAIT Если драйвер занят, функция сразу вернется без воспроизве- 
дения заданного звука 


SND_PURGE Останавливается воспроизведение любых звуков, вызванных в 
данной задаче. Если pszSound не 0, останавливаются все эк- 
земпляры указанного звука. Если pszSound равен 0, то оста- 
навливаются все звуки, связанные с данной задачей 


SND_SYNC Синхронное воспроизведение звука события. Функция PlaySo- 
und возвращается только после окончания воспроизведения 


Флаги могут комбинироваться операцией ог. 

Звук, указанный параметром pszSound, должен помещаться в доступную па- 
мять и должен подходить для установленного драйвера устройства воспроизведе- 
ния волновых файлов. Функция PlaySound ищет файл звука в следующих катало- 
гах: текущем, каталоге Windows, системном каталоге Windows, каталогах, пере- 
численных в переменной среды РАТН, в списке каталогов, предоставляемых се- 
тью. Если указанный звук не находится, функция PlaySound воспроизводит сис- 
темный звук по умолчанию. Если функция не может найти и его, то воспроизведе- 
ния не будет, а вернется значение false. 

Приведем примеры использования функции PlaySound. 

Оператор 


PlaySound("C:\\Windows\\Media\\3Byk Microsoft.wav",0,SND АЗУМС); 


воспроизводит асинхронно и однократно стандартный звук Microsoft, который вы 
обычно можете слышать при открытии Windows. В процессе воспроизведения про- 
должается выполнение приложения. 

Чтобы опробовать функцию PlaySound, введите в свое приложение диалог 
‘OpenDialog и кнопку со следующим обработчиком щелчка: 


if (OpenDialog1l->Execute() ) 
PlaySound (OpenDialogl->FileName.c str(),0,SND ASYNC) ; 


Запустите приложение, выберите файл какой-нибудь приятной музыки и pa- 
ботайте со своим приложением, наслаждаясь попутно выбранной мелодией. 

В предыдущих примерах звук задавался именем его волнового файла. Функ- 
ция PlaySound позволяет воспроизводить и системные звуки, просто называя их 
псевдонимы. Например, оператор | 


PlaySound("SystemStart",0,SND АЗУМС); 


воспроизведет тот же звук открытия Windows, что и приведенный ранее оператор, 
указывавший имя и путь к нему. 
Оператор 


PlaySound("C:\\Windows\\Media\\3Byk Microsoft.wav", 0, 
SND ASYNC | SND LOOP); 


многократно асинхронно воспроизводит стандартный звук Microsoft, начиная ero 
снова и снова, как только он заканчивается. Если вы ввели в свое приложение по- 
добный оператор (пусть даже и с очень приятной музыкой), вам надо предусмот- 
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реть еще и какую-нибудь кнопку, по которой воспроизведение прерывается зада-_ 
нием нового звука или выполнением оператора 


PlaySound(0,0, SND PURGE); 


Полезно также ввести аналогичный оператор в обработчик события формы 
OnCloseQuery, так как звучание будет бесконечным и при работе с некоторыми 
версиями Windows у вас могут возникнуть проблемы при попытке закрыть ваше 
приложение. Кстати, подобный оператор в обработчике OnCloseQuery полезен в 
этих случаях не только при заказе бесконечного воспроизведения, но и в других 
случаях, когда вы хотите прервать воспроизведение с окончанием работы прило- 
жения. 

Оператор 


PlaySound("C:\\Windows\\Media\\3Byk Microsoft.wav",0,SND SYNC); 


будет воспроизводить звук синхронно. Т.е. функция PlaySound не вернется, пока 
воспроизведение не завершится. На это время ваше приложение будет блокирова- 
но. Впрочем, ваши действия во время этого вынужденного простоя запомнятся сис- 
темой. И если вы, слушая музыку, щелкнули на той же кнопке повторно, то после 

окончания звука он будет повторен, так как ваш щелчок встал в’очередь событий. 
Все рассмотренные ранее операторы прерывали при своем выполнении звук, 
‚ который асинхронно воспроизводился в момент вызова PlaySound. Если же вы вы- 
полните оператор с флагом SND NOSTOP, например: 


PlaySound("C:\\Windows\\Media\\3Byk Microsoft.wav",0, 
SND SYNC | SND NOSTOP) 


то в случае, если в этот момент драйвер занят воспроизведением другого звука, это 
воспроизведение не будет прерываться, а функция PlaySound сразу вернет false. 
Заказанного этим оператором звука вы не услышите, т.к. в очередь он не встанет. 

Мы рассмотрели основные функции воспроизведения звука. В C++Builder 
имеется также компонент MediaPlayer — универсальный проигрыватель аудио- и 
видео-информации. Он будет рассмотрен в разделе 5.2.4. 


5.2.2 Начала анимации — создание собственной 
мультипликации 


А теперь давайте займемся движущимися изображениями. Но прежде, чем 
учится просматривать готовые видеофайлы, попробуем свои силы в создании соб- 
ственной анимации. 

Каждый примерно представляет себе принципы создания мультипликацион- 
ных фильмов, знает, что они представляют собой совокупность множества кадров, 
каждый из которых чуть-чуть отличается от предыдущего. Это при быстром пооче- 
редном просмотре кадров и создает иллюзию движения. Вам, конечно, в своей ра- 
боте не придется рисовать с помощью C++Builder мультфильмы. Для этого имеют- 
ся совершенно другие инструменты. Но некоторые простенькие анимации — 
оживление изображений, иногда желательно делать. Например, при создании ка- 
кой-нибудь обучающей программы может захотеться оживить какие-то схемы или 
условные изображения механизмов, чтобы показать в движении взаимодействие 
их отдельных составляющих. Или применить анимации типа тех, которые исполь- 
зуются в программе Windows «Проводник» при копировании и удалении файлов. 

Давайте попробуем сделать простую мультипликацию. Но, чтобы не связывать- 
ся с изображениями каких-то механизмов, сделаем нечто всем понятное: например 
условное изображение человечка, шагающего и бьющего при этом в литавры. 

Откройте новое приложение. Перенесите на форму компоненты Image, кнопку 
Button и таймер Timer. Кнопку разместите внизу формы. Основную площадь фор- 
мы должен занимать компонент Image, на котором и будет рисоваться изображе- 
ние (рис. 5.16). 
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Рис. 5.16 


|} 1; Простая мчльтипаикация ея 
Приложение с простой мультипликацией т т т НЫ 


Таймер будет задавать темп смены кадров. Поскольку в первом варианте при- 
ложения у нас будет всего два кадра, задайте значение свойства Interval таймера 
достаточно большим, например, 500 (поскольку интервалы задаются в миллисе- 
кундах, то это значение соответствует 0,5 сек). Значение параметра Enabled тайме- 
ра установите в false. Таймер у нас будет управляться кнопкой. 

Теперь размещение компонентов закончено. Надо ввести текст программы. В 
заголовочном файле добавьте строку 


void _fastcall Draw(); 


Это объявление функции; которая будет рисовать изображение. А текст само- 
го модуля может иметь вид: 


short int num = 0; 
short int H=20; // war 


short int Xpos = 2 * H; // координата туловища 
short int Ypos = 120; // «земля» 

short int Hmen = 30; // высота тела 

short int Rhead = 10; // радиус головы 

short int Rhead2 = Rhead / 2; // радиус литавров 
short int revers = 1; // направление движения 
short int L = Н * 1.341; // длина ноги 


7 чата ори 

void _ fastcall TForml: :Огам () 

{ 

short int Yhead; // координата низа головы 

switch (num) 

{ 

case 0: 
Yhead = Ypos-H-Hmen; 
Imagel->Canvas->MoveTo (Xpos-H, Ypos) ; 


Imagel->Canvas-—>LineTo (Хроз, Уроз$-Н); // нога 
Imagel->Canvas->LineTo (XpostH, Ypos) ; // другая нога 
1паде1->Сапуа$->МоуеТо (Xpos, Уро$-Н); 

Imagel->Canvas->LineTo (Xpos, Yheaq) ; // туловище 
Тпаде1->Сапуа$->МоуеТо (Xpostrevers*H, Yhead-H) ; 
Imagel->Canvas->LineTo (Xpos, Yhead+4) ; // рука 


Imagel->Canvas->Ellipse (Xpos+revers*H-Rhead2, Yhead-H-Rhead2, 

Xpost+revers*H+Rhead2, Yhead-H+Rhead2) ; 
Imagel->Canvas->LineTo (Xpos+revers*H, Yhead+H); // другая рука 
Imagel->Canvas->Ellipse (Xpos+revers*H-Rhead2, Yhead+tH~-Rhead2, 

Xpost+revers*H+Rhead2, Yhead+H+Rhead2) ; 
Imagel->Canvas->Ellipse (Xpos-Rhead, Yhead, Xpos+Rhead, 

Yhead-2*Rhead); »~ 
Imagel->Canvas->Rectangle (Xpos-Rhead, Yhead-2*Rhead-1, 

Xpos+Rhead, Yhead-2*Rhead-4); // шляпа 
break; 
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case 1: 
Yhead = Уро5-Ь-Нмеп; 
Imagel->Canvas->MoveTo (Xpos, Ypos) ; 
Imagel->Canvas->LineTo (Xpos, Yheadq) ; 
Imagel->Canvas->MoveTo (Xpos, Yheadt+4) ; 
Imagel->Canvas->LineTo (Xpost+revers*L, Yhead+4) ; 
Imagel->Canvas->Ellipse(Xpos+revers*L-Rhead2, Yhead+4-Rhead2, 
Xpos+revers*L+Rhead2, Yhead+4+Rhead2) ; 
Imagel->Canvas->Ellipse (Хроз-Вреаа, Yhead, Xpos+Rhead, 
Yhead-2*Rheadq) ; 
Imagel->Canvas->Rectangle(Xpos-H / 2,Yhead-2*Rhead-1, 
Хроз+Н / 2,Yhead-2*Rhead-4) ; 
} 
} 


т за ОН ее о ia 
void _fastcall ТРГогм1: : Т1мег1Т1мег (TObject *Sender) 
{ 
Draw(); 
if ((Xpos >= Imagel->Picture->Width-H) || (Хро$ <= Н)) 
revers = -revers; 
Xpos = Xpos + revers * H; 
num = 1 — num; 
Draw(); 
} 
ен 
void _fastcall TForml::BRunClick(TObject *Sender) 
{ 
Timerl->Enabled = ! Timerl->Enabled; 
} 
6. 4 aes eens saa nna ee aes 


void _fastcall TForml::FormCreate(TObject *Sender) 


{ 

Imagel->Canvas->MoveTo (0, Ypos+3) ; 

Imagel->Canvas->Pen->Width = 4; 

Imagel->Canvas->LineTo (Imagel->ClientWidth, 90843) // земля 
Imagel->Canvas->Pen->Width = 1; 

Imagel->Canvas->Pen->Mode = pmNotxXor; 

Draw(); 


} 


Начнем анализ этого кода с конца — с последней процедуры FormCreate, яв- 
ляющейся обработчиком события OnCreate формы. В этой процедуре рисуется ли- 
ния, отображающая «землю», по которой будет ходить Halll человечек. Затем уста- 
навливается режим пера ртМо&Хог. И в заключение вызывается процедура Draw, 
которая рисует исходное положение человечка. 

Процедура BRunClick является обработчиком события OnClick кнопки. Каж- 
дый щелчок на кнопке включает или выключает таймер, в результате чего челове- 
чек идет или останавливается. 

Процедура Типег1Типег является обработчиком события OnTimer таймера. 
Это событие означает, что надо стереть прежний кадр и нарисовать новый. Снача- 
ла вызывается процедура Draw. Поскольку позиция человечка с момента показа 
предыдущего кадра не изменилась, то этот вызов рисует на том же самом месте, на 
котором рисовался предыдущий кадр. Следовательно, предыдущий рисунок стира- 
ется. Затем анализируется позиция человечка Хроз. Если эта позиция отстоит от 
какого-либо конца холста Imagel на величину, меньшую шага H, то изменяется 
на обратный знак переменной revers, характеризующей направление движения. 
Если геуег$ = 1, человечек шагает вправо; если геуег$ = -1, человечек шагает вле- 
во. Затем позиция Хро$ изменяется на величину revers * Н, т.е. на шаг вправо или 
влево. Изменяется переменная num, которая указывает номер высвечиваемого 
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кадра: 0 или 1. В заключение вызывается процедура Draw, которая рисует указан- 
ный кадр в указанной позиции. 

Последняя процедура, которую мы рассмотрим — процедура Draw, рисующая 
кадр. Она достаточно длинная, но в ней нет ничего сложного. В зависимости от 
значения NUM рисуется один или другой кадр, причем в рисунке учитывается по- 
зиция Xpos и направление движения revers. 

Сохраните ваше приложение и выполните его. Щелкнув на кнопке вы можете 
заставить вашего человечка перемещаться. Достигнув края формы он будет пово- 
рачиваться и шагать в обратном направлении. При вторичном щелчке на кнопке 
он будет останавливаться. 

Конечно, пока движения нашего человечка очень неуклюжи. Чуть позже мы 
научим его двигаться более плавно. А пока обсудим некоторые проблемы, связан- 
ные с построением даже простеньких мультипликаций. 

Первая из них — создание фона. Наш человечек движется в пустом простран- 
стве и мы не замечаем этой проблемы. Но попробуйте вставить в программу ка- 
кой-нибудь фон. Например, вставьте в начало процедуры FormCreate следующие 
операторы, рисующие черный прямоугольник: 

Imagel->Canvas->Brush->Color = 0; 


Imagel->Canvas->Rectangle(90,0,200,100); 
Imagel->Canvas->Brush->Color = clWhite; 


Выполните теперь свое приложение. Bo время движения человечка вы увиди- 
те картину, приведенную на рис. 5.17. На черном фоне черный человечек стано- 
вится белым. Если мультипликация черно-белая, то такой результат может только 
радовать, поскольку черное на черном просто исчезало бы. Но при разноцветном 
пестром фоне картина становится безрадостной. Вы можете в этом убедиться, если 
введете в свое приложение компонент OpenPictureDialog и в начале процедуры 
FormCreate вставите оператор 


if (OpenPictureDialogl->Execute() ) 
Imagel->Picture->LoadFromFile (OpenPictureDialogl->FileName) ; 


который позволит вам перед началом работы приложения загрузить в виде фона 
какой-нибудь графический файл, например, изображение земного шара, использо- 
ванное ранее на рис. 5.1-5.3. Тогда вы увидите, что на пестром фоне земного шара 
ваш человечек будет совершенно теряться. 


Рис. 5.17 |} Простая мультипликация 
Изменение цвета мультипликации при наложении на : 
однотонный фон 


Какие возможны выходы из положения? Наиболее простой — ограничиваться 
черно-белой мультипликацией или, во всяком случае, не использовать пестрых 
фонов. Если же по какой-то причине это невозможно, то, вероятнее всего, вам при- 
дется отказаться от режима пера pmNotXor и использовать буферизацию фона. 

В нашем примере это можно было бы сделать следующим образом. Откройте 
свой предыдущий проект мультипликации и сохраните его под новым именем ко- 
мандой File | Save Project As. Затем сохраните под новым именем файл модуля коман- 
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дой File | Save Аз. Теперь вы можете вводить в модуль изменения, не опасаясь испор- 
тить свой предыдущий проект. 
Введите глобальную переменную типа ТВ тар: 


Graphics::TBitmap *BitMap; 

Это будет объект, в котором вы будете сохранять фрагменты фона, испорчен- 
ные очередным кадром. Переделайте процедуру FormCreate следующим образом: 

void _fastcall TForml::FormCreate(TObject *Sender) 


| 


i 

BitMap = new Graphics::TBitmap; 

BitMap->Width = 2 * (L + Rhead); 

BitMap->Height = L + Hmen + 2 * Rhead + 6; 

Imagel->Canvas->MoveTo (0, Ypos+3) ; 

Imagel->Canvas->Pen->Width = 4; 

Imagel->Canvas->LineTo(Imagel->ClientWidth, Уро$+3); // земля 

Imagel->Canvas->Pen->Width = 2; 

BitMap->Canvas- ~>CopyRect (Rect (0, 0,BitMap->Width, 

BitMap->Height), 

Imagel->Canvas, Rect (Xpos-L-Rhead, Ypos- (L+Hmen+2*Rhead+5), 
Xpos+L+Rhead, Ypost+1) ); 

Draw(); 


} 


Первыми операторами этой процедуры вы создаете объект BitMap и задаете 
его размеры равными максимальным размерам изображения человечка. В конце 
процедуры, перед вызовом Draw в компонент BitMap методом CopyRect копирует- 
ся фрагмент изображения, внутри которого будет расположен рисунок человечка. 
После этого процедурой Draw рисуется соответствующий кадр. Обратите внима- 
ние, что в данном приложении отсутствует оператор, задававший ранее режим 
пера рт Моё Хог. Так что по умолчанию рисунок будет делаться обычным образом. 

Поскольку приложение создало объект Bitmap, надо не забыть добавить в него 
обработчик события OnDestroy формы, в который вставить оператор 


В1ЕМар->Егее (); 


Процедуру Timer1Timer измените следующим образом: 


void. fastcall TForml::TimerlTimer(TObject *Sender) 
{ 
Imagel->Canvas->Draw (Xpos-L-Rhead, 
Ypos~L-Hmen-2*Rhead-5, BitMap) ; 


if ((Xpos >= Imagel->Picture->Width — H) | (Xpos <= H)) 
revers = -revers; 

Xpos = Хро$ +*revers * H; 

num = 1 — num; 


BitMap->Canvas- Seep yRect inact (0; 0,BitMap->Width, 
BitMap->Height), Imagel->Canvas, 
Rect (Xpos-L-Rhead, 
Ypos- (L+Hmen+2*Rheadt+5), 
Xpos+L+Rhead, Уро$+1)); 

Draw (); 


} 


Если вы сравните с тем, что было в предыдущем приложении, TO увидите, что 
вместо первого вызова процедуры Draw, который стирал предыдущий кадр, вво- 
дится оператор Imagel->Canvas->Draw, который выполняет ту же функцию, но 
путем восстановления запомненного ранее фрагмента фона под рисунком. Вторым 
отличием является наличие оператора BitMap->Canvas->CopyRect, который пе- 
ред вызовом Draw запоминает новый фрагмент фона. 

Вот и все изменения. Выполните проект. Вы увидите, что без фона приложе- 
ние работает как и прежде. Добавьте пестрый фон так же, как делали это раньше. 
Вы сможете увидеть, что изображение стало несколько лучше, но не на много. Так 
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что, как говорилось выше, все равно использовать для мультипликаций пестрые 
фоны крайне нежелательно. 

Наше изображение было очень простым и рисовалось быстро. Но при сложных 
изображениях время рисования может быть заметным и приводить к мерцанию 
картинки и другим неприятным зрительным эффектам. В этих случаях использу- 
ют буферизацию изображения. Это напоминает то, что вы только что делали с фо- 
HOM, но относится He к фону, ак рисунку. Рисование очередного кадра производит- 
ся не сразу на холсте, который видит пользователь, а на канве невидимого компо- 
нента, типа того Bitmap, с которым вы только что работали. А. после того, как ри- 
сунок сделан, он переносится на видимый холст методами Draw или CopyRect. Эти 
методы работают очень быстро и никаких неприятных мерцаний не происходит. 

Еще одна проблема анимации — определение того, какие элементы изобра- 
жаемого объекта видны, а какие — нет. Несмотря на простоту нашего примера с 
человечком, даже в нем возникла такая проблема, но мы ею пренебрегли, чтобы не 
усложнять код. Если вы внимательно посмотрите на рис. 5.16 или 5.17, то увиди- 
те, что изображение неправильное. Конец одной из рук должен быть скрыт за ли- 
таврами, которые держит человечек. Эту ошибку в данном случае не трудно было 
бы убрать, но код несколько усложнился бы. А вот в трехмерной графике при вра- 
щении изображения объекта подобная проблема встает очень остро и должна COOT- 
ветствующим образом решаться. 

Последний вопрос, который мы рассмотрим, — как сделать нашу мультипли- 
кацию более плавной. Если вы не стремитесь к лаврам Диснея, вам достаточно ог- 
раничиться в ваших мультипликациях простыми механическими движениями, 
которые всегда можно описать соответствующими функциями. Это относится к 
любым динамическим иллюстрациям работы механизмов, к любым схематиче- 
ским перемещениям. Можно применить функциональное описание движения и к 
нашему человечку. Вполне допустимо считать, что его руки и ноги движутся по 
окружностям с соответствующими центрами. Тогда легко рассчитать их положе- 
ние в любой момент времени и соответственно разбить это движение на любое чис- 
ло кадров. 

Давайте сделаем движения нашего человечка более плавными. Откройте 
опять ваше первое приложение с анимацией и опять сохраните модуль и сам про- 
ект под новыми именами. Вы можете ничего не добавлять на форму, а только изме- 
нить тексты процедур. Теперь эти тексты должны иметь следующий вид. 


#define Pi 3.1415926535897932385 


short int cadr = 0; // номер кадра 

short int H=30; // длина ноги и руки 

short int Xpos\= 3 * H; // координата опорной ноги 
short int Ypos = 120; // «земля» 

short int Hmen = 30; // высота тела 

short int Rhead = 10; // радиус головы 

short int геуегз = 1; // направление движения 
short;int =.Н* 1.41; // длина ноги 


short int Ncadr=16; // число кадров Ha шаг 


void _fastcall TForml1::Draw() 
{ 
float Angl = Pi/4*(1+(2.*cadr) /(Ncadr-1)); 
short int Yb = Ypos-H*sin(Angl); 
short int Yt = Yb-Hmen; 
short int Х = Xpos-revers*H*cos(Angl) ; 
Imagel->Canvas->MoveTo (Х- (Xpos-X) , Ypos) ; 


Imagel->Canvas->LineTo (X, Yb) ; // нога 
if (сааг != Neadr / 2-1) 
Imagel->Canvas->LineTo (Хроз, Ypos) ; // другая нога 


Imagel->Canvas->MoveTo (X, Yb) ; 
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Imagel->Canvas->LineTo(X, Yt); // ‘туловище 
short int Xl = Х — revers * (Yb-Ypos); 
Imagel->Canvas->MoveTo(X1,Yt+5- (Xpos-X) ); 
Imagel->Canvas->Ellipse(X1-Rhead / 2, 
Yt+5-(Xpos-X)-Rhead / 2, 
X1+Rhead / 2, 
Yt+5-(Xpos-X)+Rhead / 2); 
Imagel->Canvas->LineTo(X, Yt+5) ; // рука 


if (cadr != Мсааг / 2-1) 
{ 
Imagel->Canvas->Ellipse(X1-Rhead / 2, 
. Yt+5+(Xpos-X)-Rhead / 2, 
X1+Rhead / 2, 
Yt+5+(Xpos-X)+Rhead / 2); 
Imagel->Canvas~->LineTo (X1, Yt+5+ (Xpos-xX) ); // другая рука 
} 
Imagel->Canvas->Ellipse (X-Rhead, Yt-2*Rhead, X+Rhead, Yt) ; 
Imagel->Canvas->Rectangle (X-Rhead, Yt-2*Rhead-4, 


X+Rhead, Yt-2*Rhead-1) ; // шляпа 

} 

LLORAS re 
void _ fastcall TForml::BRunClick(TObject *Sender) 

: 

Timerl->Enabled = ! Timerl->Enabled; 

} 

// аи ивокаоарсвьзия 
void  fastcall TForml::TimerlTimer(TObject *Sender) 
{ 

Draw (); 

cadr = (cadrt+l1) % Ncadr; 

if (cadr == 0) - 


if ((Хроз < Imagel->Picture->Width-revers*3*H) && 
(Xpos>-revers*3*H) ) 
Xpos += revers*H*1.41; 
else revers = -revers; 
Draw(); 


void _fastcall TForml::FormCreate(TObject *Sender) 


Imagel->Canvas->MoveTo (0, Ypost+3) ; 

Imagel->Canvas->Pen->Width = 4; 

Imagel->Canvas->LineTo (Imagel->ClientWidth, Ypos+3); // земля 
Imagel->Canvas->Pen->Width = 1; | 
Imagel->Canvas->Pen->Mode = pmNotXor; 

Timerl->Interval = 600 / Neadr; 

Draw(); 


} 
В этом коде использованы математические функции sin и cos. Поэтому в код 


надо добавить директиву препроцессора 


#include <math.h> 


Рассмотрим коротко приведенный код. 
Процедура FormCreate отличается от той, что была в первом приложении, 


только оператором, задающим выдержку таймера (свойство Interval) путем деле- 
ния 600 на константу Neadr, которая задает число кадров на один цикл движе- 
ния — на один шаг человечка. Как видно, длительность одного шага выбрана рав- 
ной 600 миллисекунд. Вы, конечно, можете изменить это значение, как и значе- 
ние Neadr, выбранное равным 16. — mn 
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Процедура BRunClick не отличается от той, что была в первом приложении. 
Процедура Timer1Timer, как и в первом приложении начинается и кончается вы- 
зовами Draw, первый из которых стирает изображение предыдущего кадра, а.вто- 
рой — рисует новый кадр. После первого вызова Draw рассчитывается значение 
переменной са4г оператором 


cadr = (сааг+1) % Ncadr; 


Поскольку тут используется операция вычисления остатка OT деления садг+1 
на Neadr, то значение са4г последовательно получает значения 0, 1, 2, ..., Neadr 
—1, 0,1, .... Шаг начинается с cadr = 0. При этом проверяется, не приблизился 
ли человечек к краю формы, и если приблизился — изменяется направление дви- 
жения (знак переменной revers). 

Наиболее серьезно изменилась процедура Draw. Она начинается с определе- 
ния угла наклона ног и рук Angl, исходя из номера кадра: 


float Angl = Р1/4* (1+(2.*сааг)/ (Ncadr-1) ); 


Обратите внимание на TO, что константа 2 в этом выражении записана с точ- 
кой и произведение 2.*cadr заключено в скобки. Это принципиально, так как в 
этом случае константа воспринимается как значение с плавающей запятой и все 
выражение (2.*cadr)/(Ncadr-1) вычисляется как значение с плавающей запятой. 
Если не поставить точку после 2, то будут применяться целочисленные вычисле- 
ния и пока 2*cadr меньше, чем Neadr-1, значения этого выражения будут равны 0 
и угол изменяться не будет. 

После вычисления угла на его основе строится изображение, подобное тому, 
которое было в первом приложении. Обратите внимание на то, что вторая нога и 
вторая рука человечка рисуются только, если выполняется условие cadr != 
Neadr/2-1. Это связано с тем, что, если число кадров Neadr четное, то в этот мо- 
мент одна нога накладывается на другую и руки также накладываются друг на 
друга. Поскольку рисование идет в режиме pmNotXor, то это наложение приведет 
к тому, что у человечка вообще исчезнут в этом кадре руки и ноги. Правда, всего 
на один кадр, но все равно неприятно. 

Ваше приложение готово. Можете сохранить его и выполнить. Вы увидите, 
что движения человечка стали плавными. | 


5.2.3 Воспроизведение немых видео клипов — 
компонент Animate 


Теперь рассмотрим способ воспроизведения в приложении C++Builder стан- 
дартных мультипликаций Windows и файлов .avi — клипов без звукового сопрово- 
ждения. Это позволяет сделать компонент Animate, расположенный на странице 
Win32 библиотеки. 

Компонент Animate позволяет воспроизводить на форме стандартные видео 
клипы Windows (типа копирования файлов, поиска файлов и т.п.) и немые видео 
файлы .avi — Audio Video Interleaved. Эти файлы представляют собой последова- 
тельность кадров битовых матриц. Они могут содержать и звуковую дорожку, но 
компонент Animate воспроизводит только немые клипы AVI. Он работает только с 
неуплотненными файлами AVI или с клипами AVI, уплотненными с использова- 
нием RLE — run-length encoding. 

TAnimate может воспроизводить клипы AVI из ресурсов, из файлов или из 
библиотеки Shell32.dll, если приложение работает с Windows 95 или МТ. 

Откройте новое приложение, перенесите на форму компонент Animate и по- 
знакомьтесь с ним. 

Воспроизводимое им изображение задается одним из двух свойств: FileName 
или Соттоп АУТ. Первое из этих свойств, как ясно из его названия, позволяет в 
процессе проектирования или программно задать имя воспроизводимого файла. А 
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свойство Соштоп АУТ позволяет воспроизводить стандартные мультипликации 
Windows. Это свойство типа ТСоттоп АУТ, объявленого следующим образом: 
enum TCommonAVI {aviNone, aviFindFolder, aviFindFile, 
aviFindComputer, aviCopyFiles, aviCopyFile, 
aviRecycleFile, avilmptyRecycle, 
aviDeleteFile }; 


Tun TCommonAVI определяет множество предопределенных в Windows муль- 
типликаций типа копирования файлов, поиска файлов, удаления файлов и т.п. 
Что означает каждое значение вы увидите из тестового приложения, которое по- 
строите чуть позже. | e 

А пока установите значение CommonAVI, например, равным aviCopyFile. Это 
соответствует стандартному изображению копирования файла. Соответствующий 
начальный рисунок немедленно появится на вашей форме. Свойство Repetitions 
компонента Animate задает число повторений воспроизведения клипа. Если оно 
равно 0 (значение по умолчанию), то воспроизведение повторяется вновь и вновь 
до тех пор, пока не будет выполнен метод Stop. При выполнении этого метода гене- 
-pupyerca событие OnStop, которое можно использовать, например, чтобы стереть 
изображение — сделать его невидимым. 

Если же свойство Repetitions задать большим нуля, оно определит число по- 
вторений клипа. Задайте его, например, равным 3. А теперь установите свойство 
Active компонента Animate в true. Вы увидите (рис. 5.18), что еще в процессе про- 
ектирования ваше приложение заработает. Изображение оживет и клип будет по- 
вторен 3 раза. 


Рис. 5.18 <> Компонент Animate Patel £9 


Анимация копирования файла в процессе проектирования 


Вы можете посмотреть воспроизводимое изображение по кадрам. Для этого 
щелкните на компоненте правой кнопкой мыши и из всплывшего меню выберите 
разделы Next Frame (следующий кадр) или Previous Frame (предыдущий кадр). Это 
позволит вам выбрать фрагмент клипа, если вы не хотите воспроизводить клип 
полностью. Воспроизвести фрагмент клипа можно, установив соответствующие 
значения свойств StartFrame — начальный кадр воспроизведения, и StopFra- 
ше — последний кадр воспроизведения. 

Воспроизводить фрагмент клипа можно и методом Play, который определен 
следующим образом: 


void _fastcall Play(Word FromFrame, Word ToFrame, int Count); 


Метод воспроизводит заданную последовательность кадров клипа от FromFra- 
me до ToFrame включительно и воспроизведение повторяется Count раз. Если 
FromFrame = 1, то воспроизведение начинается с первого кадра. Значение 
ToFrame должно быть не меньше FromFrame и не больше значения, определяемо- 
го свойством FrameCount (свойство только для чтения), указывающим полное чис- 
ло кадров в клипе. Если Count = 0, то воспроизведение повторяется до Tex пор, 
пока не будет выполнен метод Stop. 

Выполнение Play идентично заданию StartFrame равным FromFrame, 
StopFrame равным ToFrame, Repetitions равным Count и последующей установке 
Active в true. 
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В компоненте Animate предусмотрены события OnClose, OnOpen, OnStart и 
OnStop, генерируемые соответственно в моменты закрытия и открытия компонен- 
та, начала и окончания воспроизведения. 

Давайте теперь построим тестовое приложение, показывающее возможности 
компонента Animate. Установите в том приложении, которое вы уже начали, 
свойство Visible компонента Animate в false. Это надо для того, чтобы изображе- 
ние возникало только тогда, когда произойдет соответствующее событие: копиро- 
вание файлов, поиск файлов и т.п. В тестовом приложении мы будем имитировать 
начало и окончание события, которое должно сопровождаться мультипликацией, 
нажатиями кнопок запуска и останова воспроизведения. Поэтому верните значе- 
ние свойства Repetitions в 0, чтобы воспроизведение длилось до окончания собы- 
тия. Свойство Active установите в false. Полезно также установить свойство 
AutoSize в false, а свойство Center в true, чтобы изображение всегда появлялось в 
центре экрана. 

А теперь добавьте в приложение 3 кнопки (рис. 5.19). Первая из них (назовите 
ее BWind) будет начинать процесс воспроизведения поочередно всех стандартных 
клипов Windows. Вторая кнопка (назовите ее BStop) пусть завершает воспроизве- 
дение очередного клипа. А третью кнопку (назовите ее ВЕПе) введем для того, что- 
бы показать, что компонент может воспроизводить изображения из заданного фай- 
ла .ау!. Чтобы пользователь мог выбрать файл изображения, добавьте на форму 
компонент OpenDialog и задайте его фильтр (свойство Filter) равным «видео 
*avil*.avi». 


Puc. 5.19 a) |, Компонент Anima 
Демонстрация возможностей компонента Animate: а 


воспроизведение стандартного клипа Windows (a) и 
воспроизведение файла .avi (6) 


6) 


Теперв все приготовления закончены и осталось только написать обработчики 


событий. Код обработчиков может иметь вид: 

int. 1}; 

ь=—————- 
void _ fastcall TForml::BWindClick(TObject *Sender) 
{ 

Animatel->Visible = true; 

ЕН, СР 

Animatel->CommonAVI = aviFindFolder; 
Animatel->Active = true; 

} 

ь———_———- 
void _fastcall TForml::BStopClick(TObject *Sender) 
{ 

Animatel->Stop(); 

} 

ff 


376 Глава 5 


void  Еаз&са11 TForml::AnimatelStop(TObject *Sender) 
{ 

it; 

Switch (1) 

{ 


case 2: Animatel->CommonAVI = aviFindFile; 


break; 

case 3: Animatel->CommonAVI = aviFindComputer; 
break; 

case 4: Animatel->CommonAVI = aviCopyFiles; 
break; 

case 5: Animatel->CommonAVI = aviCopyFile; 
break; 

case 6: Animatel->CommonAVI = aviRecycleFile; 

, break; 

case 7: Animatel->CommonAVI = aviEmptyRecycle; 
break; 

case 8: Animatel->CommonAVI = aviDeleteFile; 


} 
if (i < 9) Animatel->Active true; 
else Animatel->Visible = false; 
} 
PO Aw ceca: Srey то роте AGA SRS SE EDIE 
void _fastcall TForml::BFileClick(TObject *Sender) 
{ 
if (OpenDialogl->Execute() ) 
{ 
i= 9; 
Animatel->FileName = OpenDialogl->FileName; 
Animatel->Visible = true; 
Animatel->Active = true; 


} 


} 


Обработчик события OnClick кнопки BWind задает начальное значение свой- 
ства Соттоп А УТ, сбрасывает счетчик на 1, делает компонент Animatel видимым 
и активизирует его. 

Обработчик события OnClick кнопки BStop останавливает воспроизведение 
методом Stop. 

Обработчик события OnStop компонента Animatel увеличивает счетчик на 1, 
в зависимости от значения счетчика загружает в компонент соответствующий 
клип Windows, и активизирует компонент. Если все клипы уже воспроизведены, 
то компонент делается невидимым. 

Обработчик события OnClick кнопки BFile загружает в компонент видеофайл, 
выбранный пользователем. > 

Выполните приложение и проверьте его в работе. В качестве видео файла MO- 
жете использовать daii...\Examples\Mfc\General\Cmnctrls\dillo.avi, поставляе- 
мый с примерами C++Builder (на рис. 5.19 6 изображен момент воспроизведения 
именно этого файла), или любой другой более интересный видеофайл. 


5.2.4 Универсальный проигрыватель MediaPlayer 


В C++Builder имеется компонент MediaPlayer — универсальный проигрыва- 
тель аудио- и видео- информации. Этот медиа-плеер расположен на странице 
System библиотеки компонентов. OH инкапсулирует интерфейс управления носи- 
телями (Media Control Interface — MCI) Windows 95 и Windows NT. 

Компонент можно использовать в двух режимах. Во-первых, можно предоста- 
вить пользователю возможность управлять воспроизведением информации с помо- 
щью кнопочного интерфейса, напоминающего панель управления различными 
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проигрывателями. Во-вторых, можно сделать сам компонент невидимым и управ- 
лять воспроизведением информации с помощью его методов. 

Пользовательский интерфейс медиа-плеера представлен на рис. 5.20. Он име- ‹ 
ет ряд кнопок, управляемых мышью или клавишей пробела и клавишами со 
стрелками. 


Рис. 5.20 
Панель компонента MediaPlayer 


Назначение кнопок (перечисляются слева направо): 


Play 


Пауза воспроизведения или записи. Если медиа-плеер в момент 
щелчка уже в состоянии паузы, то воспроизведение или запись во- 
зобновляются 


| 
| 
‘Stop Останов воспроизведения или записи 
Next Переход Ha следующий трек или на конец | 


| Prev Переход Ha предыдущий трек или на начало 


Перемещение вперед на заданное число кадров 


Перемещение назад на заданное число кадров 


| Record Начало записи 
Освобождение объекта, загруженного в устройство | 


Каждой кнопке медиа-плеера соответствует метод, осуществляющий по умол- 
чанию требуемую операцию: Play, Pause, Stop, Next, Previous, Step, Back, 
StartRecording, Eject. 

Тип устройства мультимедиа, с которым работает медиа-плеер, определяется 
его свойством DeviceType. Если устройство мультимедиа хранит объект воспроиз- 
ведения в файле, то имя файла задается свойством FileName. По умолчанию свой- 
ство DeviceType имеет значение dtAutoSelect. Это означает, что медиа-плеер пы- 
тается определить тип устройства исходя их расширения имени файла FileName. 

Еще одно свойство MediaPlayer — AutoOpen. Если оно установлено в true, то 
медиа-плеер пытается открыть устройство, указанное свойством DeviceType, авто- 
матически во время своего создания в процессе выполнения приложения. 

Воспроизведение видео информации по умолчанию производится в окно, кото- 
рое создает само открытое устройство мультимедиа (см. приведенный далее 
рис. 5.21 6). Однако это можно изменить, если в свойстве Display указать оконный 
элемент, в котором должно отображаться изображение. Это может быть, напри- 
мер, форма или панель. Можно также задать в свойстве DisplayRect типа TRect 
(свойство только времени выполнения) прямоугольную область этого окна, в кото- 
рую должно выводиться изображение. Для задания свойства DisplayRect можно 
использовать функцию Rect. Однако, в данном свойстве использование этого типа 
не совсем обычно. Первые две координаты, как и обычно, задают положение лево- 
го верхнего угла изображения. А два следующих числа задают ширину и высоту 
изображения, а не координаты правого нижнего угла. Например, оператор 


MediaPlayerl->DisplayRect = Rect(10,10,200,200); 


задает для вывода область с координатами левого верхнего угла (10, 10), длиной и 
шириной, равными 200. 
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В компоненте MediaPlayer определены события OnClick и OnNotify. Первое 
из них происходит при выборе пользователем одной из кнопок медиа-плеера и оп- 
ределено как 


enum TMPBtnType {btPlay, btPause, btStop, btNext, 
btPrev, btStep, btBack, btRecord, btEject}; 


void _ fastcall Click(TObject *Sender, TMPBtnType Button, 
bool &DoDefault) : 


Параметр Button указывает выбранную кнопку. Параметр DoDefault, переда- 
ваемый по ссылке, определяет выполнение (при значении фгие по умолчанию) или 
отказ от выполнения стандартного метода, соответствующего выбранной кнопке. 

Событие OnNotify происходит после возвращения очередного метода, если 
свойство медиа-плеера Notify было установлено в true. Способ возврата любого ме- 
‚ тода медиа-плеера определяется свойством Wait. Если установить Wait равным 
false, то возвращение управления в приложение происходит сразу после вызова 
метода, не дожидаясь завершения его выполнения. Таким образом, задав Notify 
равным true и Wait равным false, можно обеспечить немедленный возврат в при- 
ложение и отображения пользователю текущего состояния объекта мультимедиа. 

Свойства Notify и Wait действуют только на один очередной метод. Поэтому 
их значения надо каждый раз восстанавливать в обработчиках событий OnClick 
или OnNotify. 

В обработчиках событий можно читать свойство Mode, характеризующее те- 
кущее состояние устройства мультимедиа. Можно также читать и устанавливать 
ряд свойств, характеризующих размер воспроизводимого файла и текущую пози- 
цию в нем. 

Вот, собственно, в конспективном виде основная информация о компоненте 
MediaPlayer. А теперь попробуйте все это на практике. Простое и в то же время 
мощное приложение можно сделать очень просто. Начните новый проект и перене- 
сите на форму компоненты MediaPlayer, MainMenu и OpenDialog. В фильтре ком- 
понента OpenDialog можно, например, задать: 


о а О В ай 


аудио и видео (*.wav,*.mid,*.avi) * wav; *.mid; *.avi 
аудио (*.wav,*.mid) * wav;*.mid 

видео (*.avi) , * avi 

все файлы *.* 


В меню достаточно задать одну команду: Файл | Открыть. Обработчик события 
OnClick этой команды может содержать оператор 


if (OpenDialogl->Execute() ) 
{ 
MediaPlayerl->FileName = OpenDialogl->FileName; 
MediaPlayerl->Open () ; 
} 


который открывает устройство мультимедиа, соответствующее выбранному поль- 
зователем файлу. При этом надо проследить, чтобы в компоненте MediaPlayer 
свойство DeviceType равнялось dtAutoSelect. Это обеспечит автоматический вы- 
бор соответствующего устройства мультимедиа исходя из расширения выбранного 
файла. 

В компоненте MediaPlayer при желании можно указать имя файла FileName, 
открываемого в момент начала выполнения приложения. Тогда надо установить 
свойство AutoOpen в true. Впрочем, это, конечно, не обязательно. 
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Вот и все. Можете выполнять свое приложение и наслаждаться музыкой или 
фильмами (если, конечно, все вопросы, связанные с настройкой мультимедиа на 
вашем компьютере решены). 

Чтобы все-таки использовать какие-то события компонента MediaPlayer, да- 
вайте немного усложним приложение. Введем в него четыре метки (рис. 5.21). В 
первой из них (Labell) укажем надпись «Файл:». Во второй (Label2) будем про- 
граммно отображать состояние проигрывателя, в третьей (Label3) — последнюю 
вызванную операцию. Четвертую метку (Label4) расположим рядом с меткой 
Labell так, чтобы она служила ее продолжением. В ней мы будем отображать имя 
загруженного файла, но в сокращенном виде с многоточиями (см. рис. 5.21), если 
имя файла не помещается в отведенном для него месте. 


Рис. 5.21 | 
Приложение универсального проигрывателя: oa 
воспроизведение аудио файла (а) и видео файла в 
отдельном окне (6) 


ГИ Универсальный проигрыватель. =] 


'1пно.а\м 


Код, обеспечивающий подобную обратную связь в приложении, может быть 
следующим. 


#include «filectrl.hpp» 
AnsiString ModeStr[7] = 
{"He готово", "Остановлено", "Воспроизведение", 
"Запись", "Поиск", "Пауза", "Открыто" } ; 
AnsiString ButtonStr[9] = 
{ "Воспроизведение", "Пауза", "Стоп", 
"Следующий", "Предыдущий", "Вперед", "Назад", 
"Запись", "Конец" }; 
им——_—_—_—_ 
void _fastcall TForml::FormCreate(TObject *Sender) 
{ 
Label4->Caption = MinimizeName (MediaPlayerl->FileName, 
Label4->Canvas,200); 
"Состояние; " + 
ModeStr[MediaPlayerl->Mode]; ; 
MediaPlayerl->Notify = true; j 


Label2->Caption 
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} 
—— | 
void _fastcall TForml::OpenClick(TObject *Sender) 


{ 

if (OpenDialogl->Execute () ) 
; 
MediaPlayerl->FileName = OpenDialogl->FileName; 
Label4->Caption = MinimizeName (MediaPlayerl->FileName, 

Label4->Canvas, 200) ; 

MediaPlayerl->Open(); 
MediaPlayerl->Notify = true; 
} 

} 

De or, Sof eC ЧЕ Gy TRS ARE TC CRS OS 

void _fastcall TForml::MediaPlayerlNotify(TObject *Sender) 


{ 
Label2->Caption = "Состояние: "+ModeStr[(MediaPlayerl->Mode] ; 

// Переустановка Notify, 

// чтобы событие произошло в следующий раз 
MediaPlayerl->Notify = true; 

} 

то ет отчете UE SR 

void _ fastcall TForml::MediaPlayerlClick(TObject *Sender, 

TMPBtnType Button, bool &DoDefault) 


{ 
Label3->Caption = "Операция: " + ButtonStr[Button]; 


// Переустановка Notify, чтобы произошло событие OnNotify 
MediaPlayerl->Notify = true; 
} 


В свойстве FileName компонента MediaPlayerl задано имя файла, загружае- 
мого в момент создания MediaPlayerl, т.е. в момент создания приложения. Соот- 
ветственно в обработчике FormCreate события OnCreate формы записаны операто- 
ры, задающие имя файла и текущее состояние проигрывателя в метки Label4 и 
Label2 соответственно. Для записи имени файла использована функция Minimize- 
Маше, которая обеспечивает сокращенное отображение пути к файлу (см. 
рис. 5.21) в случае, если полный путь не помещается в отведенном месте (в опера- 
торе указана максимальная длина — 200 пикселей). Чтобы эта функция работала, 
в модуль добавлена директива компилятора 


#include "filectrl.hpp" 


В дальнейшем отображение соответствующей информации предусмотрено в 
процедурах, соответствующих открытию файла (OpenClick), нажатии пользовате- 
лем какой-нибудь кнопки проигрывателя (MediaPlayer1Click), возвращении лю- 
бого метода проигрывателя (MediaPlayerl1 Notify). После каждого события выпол- 
няется оператор 


MediaPlayerl->Notify = true; 


обеспечивающий наличие события OnNotify после возвращения следующего MeTO- 
да проигрывателя. 

Запустите приложение и проверьте его в работе (рис. 5.21). С его помощью вы 
можете слушать музыку, смотреть немые и звуковые клипы, т.е. можете наслаж- 
даться всеми прелестями мультимедиа. 


Взаимодействие приложения 
с внешними программами 


6.1 Запуск из приложения внешних программ 


Взаимодействие приложения с внешними программами может происходить 
различными способами. Это может быть: 


Ш непосредственный запуск внешней программы из вашего приложения 
Ш запуск внешней программы, связанной с некоторым документом 

Ш обмен с приложениями сообщениями Windows 
a 


технология OLE — внедрения и связывания документов, подготовленных 
внешними программами, в ваше приложение 


использование новых компонентов C++Builder 5 — серверов COM 
Ш динамический обмен данными между приложениями — DDE 


Начнем с рассмотрения первой из этих возможностей — запуска из приложе- 
ния внешней программы. Такая необходимость может возникать в ряде случаев. 
Например, ваша задача может заключаться в создании с помощью C++Builder 
пользовательского интерфейса к какой-нибудь ранее разработанной для MS-DOS 
или Windows программе, которая представлена только своим выполняемым моду- 
лем. Исходный текст программы может быть при этом вам не известен или он MO- 
жет быть написан на языке, отличающемся от С и C++. Тогда естественным спосо- 
бом решения этой задачи является запуск загрузочного модуля программы из ва- 
шего приложения — интерфейса. Другой пример использования внешней про- 
граммы — желание предоставить пользователю, работающему с вашей програм- 
мой, какие-то дополнительные возможности. Например, вам может захотеться 
дать пользователю возможность вызвать из вашего приложения программу 
Windows «Калькулятор», чтобы просчитать какие-то данные, которые он получил 
в процессе работы с приложением, и принять решение о своих дальнейших дейст- 
виях. 

Запуск внешней программы из приложения C++Builder можно сделать не- 
сколькими способами. Ниже рассматриваются наиболее простые из них. 


6.1.1 Запуск внешней программы функцией execip 


Функция execlp позволяет выполнить из своего приложения любое указанное 
приложение, передав ему управление. Вызванная программа замещает в памяти 
вызвавшее ее приложение. Таким образом, родительское приложение завершается 
и начинается новое. 

Функция execlp определена в файле process.h (не забывайте включать его в 
приложение соответствующей директивой #include) следующим образом: 


int execlp(char>*path, char *arg0,*argl, ..., *argn, NULL) 


Параметр path определяет имя и путь к приложению, которое требуется вы- 
полнить. Если в path указан путь и имя файла с расширением, то функция ищет 
именно этот файл. Если же расширение файла не задано, то сначала ищется файл 
такой, который задан. Если он не находится, к имени добавляется расширение 
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.ехе и поиск повторяется. Если файл опять не находится, к имени добавляется рас- 
ширение .com и поиск повторяется. Если в path не задан путь, то сначала поиск 
файла производится в текущем каталоге. Если в нем требуемый файл не найден, то 
поиск продолжается в каталогах, указанных в переменной окружения РАТН. 

Аргументы функции argO — argn являются параметрами, передаваемыми в 
запускаемую на выполнение программу через командную строку. Функция долж- 
на передать в запускаемое приложение хотя бы один аргумент аг#0. По соглаше- 
нию этот аргумент — копия path. Впрочем, передача другого значения не является 
ошибкой. Остальные аргументы, если они требуются, передают в запускаемую 
программу дополнительную информацию. Если она состоит из нескольких слов, 
например, из нескольких опций, то можете каждое слово передавать отдельным 
аргументом, а может все их объединить в одну строку argl. Последний аргумент 
функции execlp — NULL является признаком окончания списка аргументов. 

Функция ехес]р возвращает 0 при успешной загрузке нового приложения, а 
при ошибке возвращает -1. 

Рассмотрим примеры использования функции execlp. Оператор 


if (execlp("Fl.exe","Fl.exe", NULL) ) 
ShowMessage ("Программа Fl.exe не выполнена"); 


завершает выполнение вашего приложения и передает управление программе с 
выполняемым файлом Е1.ехе. Этот файл должен быть расположен в рабочем ката- 
логе или в одном из каталогов, указанных в переменной окружения РАТН. Иначе 
функция execlp вернет -1 и будет выдано сообщение функцией ShowMessage. Ана- 
логичное сообщение будет выдано если, например, для загрузки Fl.exe не хватает 
оперативной памяти. 

Оператор 


ехес1р ("пс", "пс", NULL); 


передает управление программе Norton Commander (файл пс.ехе), если только 
путь к этой программе указан в переменной окружения РАТН. 
Оператор 


Char * prog = "command.com"; 
execlp(prog,prog, NULL); 


передает управление DOS, если только путь к файлу command.com указан в пере- 
менной окружения РАТН. 
Оператор 


execlp ("М1пмога", "И1пиога", "Fl.doc", "F2.doc", NULL) ) 


запускает редактор Word и передает в Hero файлы Fl.doc и F2.doc. 

Мы рассмотрели только одну функцию ехес]р — из целого семейства, вклю- 
чающего 8 подобных функций. Подробную информацию о них вы найдете в главе 
15 в разделе 15.6.2. По своим основным характеристикам все эти функции анало- 
гичны ехе р, различаясь только каталогами, в которых ищется файл, передачей в 
новое приложение переменных окружения и заданием аргументов функции. 

Рассмотренные функции могут найти достаточно ограниченное применение, 
поскольку они обеспечивают безвозвратную передачу управления из вызвавшего 
приложение в новое. И для возврата в исходное приложение надо принимать спе- 
циальные меры: например, вызванное приложение в конце своей работы должно 
аналогичной функцией ехес]р вызвать первоначальное приложение. Зато у этих 
функций есть и болышое преимущество — оверлэйная загрузка приложений. Но- 
вое приложение загружается в оперативную память на место вызвавшего его при- 
ложения. Соответственно сокращаются затраты памяти, так как не требуется дер- 
жать в ней оба приложения. 

Таким образом, сфера применения функции ехер: 
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Ш построение входного интерфейса к какому-то приложенин›, работающего толь- 
ко перед запуском этого приложения a rs 


Ш создание оверлэйных приложений, загружаемых в память по частям . 


6.1.2 Запуск внешней программы функцией $рам/итЪр. 


Функция Spawnlp подобна рассмотренной выше функции execlp, но обладает 
более широкими возможностями. Она и используемые в ней константы описаны в 
файлах process.h и stdio.h. Объявление функции: 


int spawnlp(int mode, char *path, char *ага0, argl, ..., argn, NULL) 


Функция Spawnlp отличается от execlp наличием параметра mode, задающего 
режим выполнения приложения, запускаемого на выполнение. Этот параметр мо- 
жет, в частности, принимать следующие значения (полный их список см. в главе 
15 в разделе 15.6.2): 


сы ORRIN BREE SIBLE OOO DBE oc ЗОНА ЗАЕЗДА РА КИЗ АМИ! ИАА, 


Р_ “WAIT Родительское приложение ждет завершения вызванного › при- 
ложения, после чего продолжается его выполнение 


P_NOWAIT Родительское приложение продолжает выполняться пока вы- 
полняется вызванное приложение. Этот режим недоступен в 
16-разрядных Windows и DOS 


P_DETACH Идентичен P_NOWAIT, но вызванное приложение выполняет- 
ся в фоновом режиме, так что не имеет доступа к клавиатуре 
и дисплею 


P_OVERLAY Вызванное приложение замещает в памяти родительское. To 
же, что вызов функции ехе р 


Приведем пример. Операторы 


if (spawnlp(P WAIT, "arj","arj","e doc.arj al.txt", NULL) ) 
ShowMessage ("Программа ar} не выполнена"); 

else 
{ 
Memol->Clear (); 
Memol->Lines->LoadFromFile("al.txt"); 
DeleteFile("al.txt") ; 
} 


запускают архиватор arj, извлекающий из архива doc.arj файл al.txt. Приложе- 
ние ждет, пока программа аг] закончит работу, затем загружает разархивирован- 
ный файл в окно редактирования Memol и удаляет этот файл с диска. 

В приведенном примере все аргументы, передаваемые в порождаемый про- 
цесс, объединены в одной строке. Тот же самый результат получился бы, если пе- 
редать их все в отдельности: 


1Е(зрамп1р(Р WAIT, “arj", "“arj","e",“doc.arj™","al.txt", `МОЪЬ)) 


Операции, подобные рассмотренным выше, невозможно было бы выполнить 
функцией ехе р, поскольку она не обеспечивает возвращение в исходное прило- 
жение. Нельзя было бы выполнить эти операции и функцией spawnlp при режиме, 
отличном от P_WAIT, поскольку в этом случае оператор загрузки файла в окно pe- 
дактирования выполнялся бы раньше, чем успевал распаковываться архив. 

Надо отметить, что приведенный выше пример разархивации файла обладает 
двумя недостатками. Первый из них связан с тем, что выполняется программа агу, 
предназначенная для DOS. Поэтому при ее выполнении вызывается сеанс DOS, и 
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после его окончания пользователь видит окно DOS, которое ему надо закрыть, что- 
бы продолжить работу. Это, конечно, очень неудобно. Устранить : этот недостаток 
легко, например, написанием пакетного файла arj.bat вида: 

@echo off 

arj.exe e doc $1 

exit 

В нем помимо команда разархивации предусмотрена команда exit — оконча- 
ние сеанса работы с окном DOS. Тогда обращение к разархивации в приложении 
может быть даже короче, чем раньше: 


if (spawnlp(P WAIT, "arj.bat","arj.bat","al.txt", NULL) ) 


Обращение к пакетному файлу arj.bat позволяет порожденному процессу ав- 
томатически, без вмешательства пользователя вернуться в родительский процесс. 
Но остается еще один недостаток рассмотренного примера — на время выполнения 
разархивации получаются неприятные изменения экрана, связанные с выходом в 
DOS. Этот недостаток может быть снят только функциями, рассмотренными в по- 
следующих разделах. 

Приведем еще один пример использования функции зрамщр. Пусть вы разра- 
ботали пользовательский интерфейс, в котором хотите предоставить пользователю 
возможность запускать различные приложения. Ваш интерфейс достаточно боль- 
шой и поэтому желательно запускать из него внешние приложения в оверлэйном 
режиме. Эту задачу можно решить следующим образом. 

Пусть имя вашего приложения POverlay. Создайте еще одно приложение, на- 
званное, например, OMenage. Это приложение будет управлять запуском требуе- 
мых программ. Оно может быть очень маленьким, не содержать ни одной формы и 
располагаться в оперативной памяти одновременно с запускаемыми программами. 
Весь текст его файла следующий: 

#include <vcl.h> 

#pragma hdrstop 

#include <process.h> | 

ИТМАРТ WinMain(HINSTANCE, HINSTANCE, LPSTR lpCmdLine, int) 

{ 

spawnlp(P WAIT, 1lpCmdLine, lpCmdLine, NULL); 
зрамп1р (Р. OVERLAY, "POverlay.exe","POverlay.exe", NULL); 
return 0; 


} 


Первый вызов функции spawnlp обеспечивает запуск в режиме ожидания того 
приложения, имя которого передано через командную строку IpCmdLine. Второй 
вызов spawnlp обеспечивает оверлэйный вызов вашего основного приложения 
POverlay.exe. 

Предположим, что в вашем основном приложении POverlay имя запускаемой 
программы записано в окне редактирования Editl. Тогда вызов этой программы 
может осуществляться оператором: 

if (зрамп1р (Р OVERLAY, "OMenage.exe", "OMenage.exe", Editl->Text, 

NULL) ) 
ЗпомМеззасе ("Программа " + Editl->Text + " He выполнена;"+ 
" нет файла OMenage.exe") ; 


Этот оператор прервет выполнение приложения РОуещау и загрузит Ha его Me- 
сто в памяти короткую (примерно 10 К) программу ОМепаре.ехе, передав в нее как 
параметр имя запускаемого приложения. Программа OMenage.exe вызовет в ре- 
жиме ожидания эту программу, а по окончании ее работы удалится из памяти и 
опять вызовет основное приложение POverlay. Таким образом, во время выполне- 
‚ния вызываемой программы в памяти будет находиться не ваше большое приложе- 
ние POverlay, а только маленькая программа управления OMenage.exe. 
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Описанное взаимодействие программ имеет некоторый недостаток: при воз- 
врате в РОуе! ау текст в окне Editl будет утерян. Этот недостаток легко устранить. 
Измените основной файл приложения РОуе ау следующим образом: 


#include <vcl.h> 

#pragma hdrstop 

USERES ("POverlay.res") ; 

USEFORM("UOverlayl.cpp", Forml); 

#include "“UOverlayl.h" // включение головного файла приложения 


ит 
ИТМАРТ WinMain(HINSTANCE, HINSTANCE, LPSTR lpCmdLine, int) 
{ 
try 
{ 
Application->Initialize(); 
Application->CreateForm( classid(TForml), &Forml) ; 
Forml->Editl->Text = lpCmdLine; // Загрузка окна Еа1Е1 
Application->Run(); 


} 


catch (Exception &exception) 


{ 
Application->ShowException (&exception) ; 


} 


return 0; 


} 


По сравнению CO стандартным файлом, созданным C++Builder, в него добавле- 
но две строки (отмечены комментариями): директива, включающая головной файл 
модуля UOverlayl.h, содержащего описание вашей формы Еогт1, и оператор, 3a- 
гружающий в окно Editl текст, переданный через командную строку. Еще одно 
изменение по сравнению со стандартным файлом — введение в заголовок функции 
Ут Маш параметра IpCmdLine — ссылки на командную строку. Если в файле 
приложения POverlay сделаны такие изменения, то в приложении OMenage вто- 
рой вызов функции должен быть изменен на следующий: 


spawnlp(P OVERLAY, "POVERLAY.exe", "POVERLAY.exe", lpCmdLine, NULL); 


Этот вызов отличается от того, что был раньше, передачей в программу той ко- 
мандной строки, которая была задана при вызове OMenage. Таким образом в про- 
грамму POverlay вернется имя запускавшейся программы, которое будет загруже- 
но в окно Edit1. 

Функция spawnlp принадлежит к целому семейству, включающему 8 подоб- 
ных функций. Подробную информацию о них вы найдете в главе 15 в разделе 
15.6.2. По своим основным характеристикам все эти функции аналогичны, разли- 
чаясь только каталогами, в которых ищется файл, передачей в новое приложение 
переменных окружения и заданием аргументов функции. 


6.1.3 Запуск внешней программы функцией WinExec 


Функция WinExec, в отличие от описанных в предыдущих разделах, позволя- 
ет управлять формой представления окна запускаемого приложения. Эта функция 
может работать в любых версиях Windows и выполнять любые файлы: приложе- 
ния Windows, MS-DOS, файлы PIF и т.п. Функция WinExec определяется следую- 
щим образом: 


int WinExec(const char *CmdLine, unsigned int CmdShow) ; 


Параметр CmdLine является указателем Ha строку с нулевым символом в KOH- 
це, содержащую имя выполняемого файла и, если необходимо, параметры команд- 
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ной строки. Если имя файла указано без пути, то Windows будет искать выполняе- 
мый файл в каталогах в следующей последовательности: 


. Каталог, из которого загружено приложение. 
. Текущий каталог. 


1 
2 
3. Системный каталог Windows, возвращаемый функцией GetSystemDirectory. 
4. Каталог Windows, возвращаемый функцией Get WindowsDirectory. 

5 


. Список каталогов из переменной окружения РАТН. 


Параметр CmdShow определяет форму представления окна запускаемого при- 
ложения Windows. Возможные значения этого параметра см. в главе 15 в разделе 
15.6.3.2. Чаще всего используется значение SW_RESTORE, при котором окно за- 
пускаемого приложения активизируется и отображается на экране. Если это окно 
в данный момент свернуто или развернуто, то оно восстанавливается до своих пер- 
воначальных размеров и отображается в первоначальной позиции. Для приложе- 
ний He Windows, для файлов PIF ит.д. состояние окна определяет само приложе- 
ние. 

При успешном выполнении запуска приложения функция WinExec возвраща- 
ет значение, большее 31. При неудаче могут возвращаться следующие значения: 


| Значение | Номер. Описание з 
Не хватает памяти или ресурсов системы | 


| 


ee 
| ERROR BAD FORMAT Ошибочный файл .exe (например, не | 


для Win32 .EXE) 


Указанный файл не найден 
Указанный каталог не найден | 


ERROR_PATH_NOT_FOUND 


Достоинством функции WinExec является ее совместимость с ранними Bep- 
сиями Windows. Собственно для этого она и сохраняется в Win82, хотя для Win32 
рекомендуется пользоваться функцией CreateProcess (06 этой функции см. встро- 
енную в C++Builder справку). 

Приведем примеры применения WinExec. 

Оператор 


WinExec("file.exe",SW RESTORE) ; 


запускает программу file.exe. Оператор 
WinExec("nc",SW RESTORE) ; 


запускает Norton Commander. Оператор 
WinExec ("COMMAND.COM", SW_ RESTORE) ; 


приводит к запуску MS-DOS. 
Операторы 
int i = WinExec(Edit1l->Text.c_str(),SW_RESTORE) ; 
ES te 3.7532) 
ShowMessage ("Код ошибки "+ IntToStr(i)); 


обеспечивают выполнение любой программы, имя которой пользователь набрал в 
окне редактирования Edit1. Поскольку первый параметр функции должен иметь 
тип (char *), а текст окна имеет тип AnsiString, то для приведения типов прихо- 
дится использовать метод .c_str(). 

В заключение приведем пример процедуры, обеспечивающей выполнение лю- 
бой выбранной пользователем программы. Откройте новый проект и разместите на 
форме компонент OpenDialog, задав в нем фильтр 
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Г 
OEE И ИС ААА ух ИЯ АОИ ИКИ ИА И те ОНИ 


программы * exe;*.com;*.pif;*.dat 


все файлы *.* 


Разместите на форме кнопку Button (назовите ее BExec), при щелчке Ha кото- 
рой пользователь может выбрать в окне Открыть файл программу и выполнить ее. 
Обработчик события OnClick этой кнопки может иметь вид: 


if (OpenDialogl->Execute() ) 
{ 
int i = WinExec(OpenDialogl->FileName.c str(),SW RESTORE) ; 
Switch (i) 
{ 


case 0:ShowMessage ("Не хватает памяти или ресурсов"); 


break; 

case ERROR BAD FORMAT: 
ShowMessage ("Ошибочный файл " + OpenDialogl->FileName) ; 
break; 


case ERROR PATH NOT FOUND: 
ShowMessage ("Не найден каталог " + 
ExtractFilePath (OpenDialogl->FileName) ) ; 
break; 
case ERROR FILE NOT FOUND: 
ShowMessage ("He найден файл " + OpenDialogl->FileName) ; 


Запустите ваше приложение на выполнение и попробуйте вызывать из него 
различные программы Windows и MS-DOS. 


6.1.4 Запуск внешней программы и открытие документа 
функцией ShellExecute 


Более широкие возможности по сравнению с функцией WinExec предоставля- 
ет функция ShellExecute. Она может не только выполнять заданное приложение, 
но и открывать документ и печатать его. Под термином «открыть файл документа» 
понимается выполнение связанного с ним приложения и загрузка в него этого до- 
кумента. Например, обычно с документами, имеющими расширение .doc, связан 
Word. В этом случае открыть файл, например, с именем Ше.4ос означает запус- 
тить Word и передать ему в качестве параметра имя файла Ше.4ос. Кроме описан- 
ных возможностей функция ShellExecute позволяет открыть указанную папку. 
Это означает, что будет запущена программа «Проводник» с открытой указанной 
папкой. 

Для использования функции ShellExecute в модуль надо добавить директиву 
препроцессора 

#include "ShellAPI.h" 


подключающую модуль ShellAPI, в котором описана функция. Автоматически 
C++Builder эту директиву не добавляет. 

Функция ShellExecute инкапсулирует одноименную функцию API Windows и 
определена следующим образом: 

void ShellExecute(HWnd Мпа, const char * Operation, 


const char *FileName, const char *Parameters, 
const char *Directory, unsigned int ShowCma) ; 


Параметр Wnd является дескриптором родительского окна, в котором отобра- 
жаются сообщения запускаемого приложения. Обычно в качестве него можно про- 
сто указать Handle. 
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Параметр Operation указывает на строку с нулевым символом в конце, KOTO- 
рая определяет выполняемую операцию. Эта строка может содержать текст «ореп» 
(открыть) или «print» (напечатать). Для 32-разрядных Windows определено еще 
одно значение: «explore» (исследовать) — открыть папку программой Windows 
«Проводник». Если параметр Operation равен NULL, то по умолчанию выполняет- 
ся операция «ореп». | 

Параметр FileName указывает на строку с нулевым символом в конце, кото- 
рая определяет имя открываемого файла или имя открываемой папки. 

Параметр Parameters указывает на строку с нулевым символом в конце, KOTO- 
рая определяет передаваемые в приложение параметры, если FileName определяет 
выполняемый файл. Если FileName указывает на строку, определяющую откры- 
ваемый документ или папку, то этот параметр задается равным NULL. 

Параметр Directory указывает на строку с нулевым символом в конце, кото- 
рая определяет каталог по умолчанию. 

Параметр ShowCmd определяет режим открытия указанного файла. Этот па- 
раметр может иметь множество различных значений, которые указаны в главе 15 
в разделе 15.6.3.2. Обычно, как и для функции WinExec, используется значение 
SW_RESTORE, при котором окно запускаемого приложения активизируется и 
отображается на экране. Если это окно в данный момент свернуто или развернуто, 
то оно восстанавливается до своих первоначальных размеров: и отображается в пер- 
воначальной позиции. Для приложений He Windows, для файлов PIF ит.д. состоя- 
ние окна определяет само приложение. 

Приведем примеры использования функции ShellExecute. Пусть вы хотите 
открыть файл документа с именем Ше.4ос, т.е. запустить Word (обычно именно OH 
связан с файлами .doc), загрузив в него указанный файл. Тогда вы можете напи- 
сать: 


ShellExecute (Handle, NULL, "file.doc",NULL,NULL, SW_RESTORE) ; 

Если вы хотите не открыть, а напечатать документ, записываются аналогич- 
ные операторы, но изменяется значение параметра Operation: 

ShellExecute (Handle, "print", "Е11е.аос", МОБЬ, МОБЬ, $М ВЕЗТОВЕ); 

Выполнение этого оператора будет протекать следующим образом. Запустится 
Word, связанный с файлами .doc, в него загрузится файл Ше.4ос, затем из Word 
запустится печать с атрибутами по умолчанию, после чего файл file.doc выгрузит- 
ся из Word. 

Приведенный ниже оператор открывает приложение Windows «Калькуля- 

тор»: 

ShellExecute (Handle, "open", "Calc",NULL, NULL, SW ВЕЗТОВЕ); 

Следующий пример открывает папку c:\Program Files\Borland: 


ShellExecute (Handle, "ореп", "с: \\Ргодгам Files\\Borland", 
NULL, NULL, SW_RESTORE) ; 


А оператор 


ShellExecute (Handle, "explore","c:\\Program Files\\Borland", 
NULL, NULL, SW_RESTORE) ; 


открывает программу «Проводник» с открытой папкой c:\Program Files\Borland. 


Функция ShellExecute не возвращает никакого значения. Если при вызове 
функции произошла ошибка, то ее можно узнать, вызвав функцию GetLastError: 


DWORD GetLastError(VOID) 


Эта функция возвращает нуль, если ShellExecute выполнена нормально. В 
противном случае возвращаются коды ошибок. 
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Если вы сами делаете приложение, которое будет запускаться из другого ва- 
шего приложения, то в запускаемом приложении вы можете установить код ошиб- 
ки функцией SetLastError: 


VOID SetLastError(DWORD dwErrCode) 


Заданный этой функцией код dwErrCode может затем прочесть ваша вызы- 
вающая функция. Это один из способов обмена информацией между вызывающим 
и вызываемым приложениями. 

Функция ShellExecute автоматически отыскивает приложение, связанное с 
типом открываемого документа, и запускает его. Но иногда вам может захотеться 
самому вызвать явным образом приложение, связанное с каким-то документом, 
например, чтобы передать ему какие-то дополнительные параметры. Помочь в 
этом может функция FindExecutable, которая возвращает имя и путь приложе- 
ния, связанного с указанным файлом. Использование этой функции, как и преды- 
дущих, требует включения в модуль ссылки на ShellAPI. 

Функция FindExecutable определена следующим образом: 


void FindExecutable(const char *FileName, 
const char *Directory, char *Buffer); 


Она позволяет получить имя выполняемого файла .exe, связанного с файлом, 
указанным параметром FileName. Параметр Directory определяет каталог по 
умолчанию. Оба параметра являются указателями на строки с нулевым символом 
в конце. Параметр Buffer является указателем на буфер в виде строки с нулевым 
символом в конце, в который функция заносит имя и путь приложения, связанно- 
го с файлом ЕЙеМаше. 

При успешном завершении функция FindExecutable возвращает значение, 
большее 32. Если возвращено меньшее значение, это свидетельствует об ошибке. 
Возможные значения ошибок те же, что и для приведенных ранее функций. 

Приведем пример применения функции FindExecutable. Операторы 


char APchar[254]; 
FindExecutable ("Doc.doc",NULL, APchar) ; 


приведут к тому, что в массив APchar будет занесено имя приложения, связанного 
с файлом типа Doc.doc, например: 


C:\\PROGRAM FILES\\MICROSOFT OFFICE\\OFFICE\\WINWORD.EXE 


Правда, при этом файл Doc.doc должен существовать в доступном каталоге. 

Успешность завершения функции FindExecutable можно проверить с помо- 
щью описанной ранее функции GetLastError. Если она возвращает значение не 
большее 32, то значит произошла ошибка. Эту проверку могут, например, осуще- 
ствить следующие операторы: 

int i = GetLastError(); 

2. hee see 

ShowMessage("IIporpamMa не найдена. Код ошибки "t+IntToStr(i)); 


Выше были рассмотрены наиболее простые функции, обеспечивающие выпол- 
нение каких-то программ из вашего приложения. В C++Builder и АРТ Windows 
(все приведенные выше функции относились к API Windows, хотя для единообра- 
зия изложения они были приведены в нотации, подобной C++Builder) имеется так- 
же ряд других функций, обеспечивающих более тонкое взаимодействие с запус- 
каемыми приложениями. В частности, имеются возможности запуска нескольких 
параллельно выполняемых процессов. 
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6.2 Управление внешними приложениями 


6.2.1 Определение дескриптора окна приложения 


Мы рассмотрели запуск внешних приложений. Теперь рассмотрим коротко во- 
просы управления ими. АРТ Windows предоставляет немало функций, позволяю- 
щих управлять окнами приложений. Все они требуют указания дескриптора соот- 
ветствующего окна. Поэтому прежде всего рассмотрим способы получения этих де- 
скрипторов. 

Получить дескриптор окна можно функцией Find Window, которая имеет вид: 


HWND FindWindow(const char *lpClassName, const char *lpWindowName) ; 


Параметр IpClassName указывает на строку с нулевым конечным символом, 
содержащую имя класса. Параметр lpWindowName указывает на строку с нуле- 
вым конечным символом, содержащую имя окна (это свойство Caption формы, 
отображаемое в полосе заголовка окна). Если этот параметр равен NULL, то счита- 
ется, что под критерий поиска подходит любое окно указанного класса. 

Если поиск прошел успешно, то функция возвращает дескриптор окна, имею- 
щего указанное имя класса и имя окна. В противном случае возвращается NULL. 

Эту функцию легко использовать, если вы знаете имя класса искомого окна. 
Например, если ваше приложение вызвало другое приложение, созданное вами са- 
мими, то вы знаете имя класса формы этого другого приложения. Тогда вы може- 
те, например, с помощью кода 


HWND Н = FindWindow("TForml1", "Приложение 2"); 


определить дескриптор окна приложения, класс формы которого TForm1, а значе- 
ние свойства Caption формы — «Приложение 2». 

Если же приложение, которым вы хотите управлять, создано не вами, то текст 
полосы заголовка вы легко можете увидеть, выполнив его, а вот имя класса вам не- 
известно. Пусть, например, вы запустили из своего приложения программу 
Windows «Калькулятор», чтобы пользователь смог что-то с его помощью посчи- 
тать. Как управлять в дальнейшем этим калькулятором, если требуется, напри- 
мер, его свернуть, закрыть и т.д.? 

Одна из возможностей узнать имя класса какого-то приложения — воспользо- 
ваться поставляемой вместе с C++Builder программой WinSight 32 (файл ...\Prog- 
ram Files\Borland\CBuilder5\Bin\ws32.exe). Запустите интересующее вас прило- 
жение, затем запустите WinSight 32, выполните команду Spy | Find Window и вы 
увидите список всех окон, зарегистрированных в данный момент в Windows. Луч- 
ше, чтобы в этот момент у вас было бы открыто не очень много окон, чтобы проще 
было найти среди них нужное. 

В списке, который вы увидите, для каждого окна будут указаны среди прочей 
информации имя класса в фигурных скобках «{ }» и заголовок окна — последний 
элемент данных в строке каждого окна. Например, запустив «Калькулятор», вы 
можете с помощью WinSight 32 найти, что имя класса окна этого приложения — 
«SciCalc». Следовательно, определить в своем приложении дескриптор открытого 
приложения «Калькулятор» вы можете оператором: 


HWND H = FindWindow("SciCalc", "Калькулятор"); 

Другой способ найти дескриптор окна — воспользоваться функцией 
GetNext Window API Windows. Определение этой функции: 

HWND GetNextWindow (hWnd hWnd, unsigned int wCmd) ; 

Она определяет дескриптор следующего или предыдущего окна в 7-последова- 


тельности. Параметр hWnd — дескриптор окна, от которого начинается отсчет. 
Параметр wCmd определяет направление поиска. Если wCmd = GW_HWND- 
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NEXT, то ищется следующее окно, находящееся ниже. Если мСта = GW_HWND- 
PREV, то ищется предыдущее окно, находящееся выше. 

Следующее окно в 7-последовательности — это то, которое вызывалось из ука- 
занного или к которому пользователь обращался после создания указанного окна. 
Если указано дочернее окно, то поиск ведется среди дочерних окон. 

Если искомое окно найдено, то возвращается его дескриптор. Если следующего 
или предыдущего окна нет (в зависимости от значения WCmd), то возвращается 0. 

Сейчас мы попробуем использовать функцию GetNextWindow для поиска 
окна с известным текстом. Но при этом нам потребуется еще одна функция API 
Windows — GetWindowText. Эта функция копирует текст, связанный с указан- 
ным окном, в указанный буфер. Ее объявление имеет вид: 


int GetWindowText (HWND hWnd, char *lpString, int nMaxCount) ; 


Параметр hWnd — дескриптор окна. Параметр IpString указывает на буфер, в 
который копируется текст. Параметр nMaxCount определяет максимальное число 
копируемых символов. Если число символов в тексте превышает эту величину, 
текст усекается. 

Если функция выполнилась успешно, она возвращает число скопированных 
символов, исключая завершающий нулевой символ. Если окно не имеет полосы за- 
головка или текст заголовка отсутствует, или при неверном дескрипторе возвра- 
щается нуль. 

Теперь мы можем решить задачу, поставленную нами в качестве примера: оп- 
ределить дескриптор окна выполняемого приложения «Калькулятор». Это можно 
сделать с помощью следующего кода: 

HWND Н =Handle; 

_ char Pch[128]; 
do 


{ 
Н = GetNextWindow (H, GW HWNDNEXT) ; 
GetWindowText (H, Pch,128) ; 


if (CompareText(Pch, "калькулятор") == 0) 
break; 
} while (H != NULL); 


if (H != NULL) 


Первый выполняемый оператор присваивает переменной Н значение свойства 
Handle формы вашего приложения. Далее в цикле просматриваются окна, лежа- 
щие ниже в 7-последовательности, и среди них ищется окно с текстом «Калькуля- 
тор». Для этого используется функция CompareText, сравнивающая без учета ре- 
гистра строку, на которую указывает Pch, со строкой «Калькулятор». Если строки 
совпадают, функция CompareText возвращает нуль. Пользуясь тем, что C++ по- 
зволяет оперировать с целыми значениями как с булевыми, строку оператора if 
можно было бы записать и в таком виде: 


if( ! CompareText(Pch, "Калькулятор")) 


Окно калькулятора будет найдено, если оно получало фокус после запуска ва- 
шего приложения. Таким образом, если пользователь запустил «Калькулятор» из 
вашего приложения или даже если «Калькулятор» был запущен ранее или незави- 
симо от вашего приложения, дескриптор его окна будет найден. 

Если цикл завершается со значением Н = NULL, значит приложение «Кальку- 
лятор» в данный момент не открыто. Если его все-таки надо открыть, то можно 
для этого воспользоваться функциями, описанными в предыдущих разделах. 
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6.2.2 Некоторые функции АР! Windows для управления 
окнами 


Теперь рассмотрим некоторые функции API Windows, позволяющие управ- 
лять приложениями. | 

Функция CloseWindow сворачивает указанное в ней окно до пиктограммы и 
перемещает ее в область пиктограмм экрана. Описание этой функции: 


bool CloseWindow(HWND hWnd) 


Параметр hWnd является дескриптором сворачиваемого окна. При успешном 
выполнении функции возвращается ненулевое значение. При аварийном заверше- 
нии возвращается нуль. Например, для сворачивания окна приложения «Кальку- 
лятор», дескриптор которого мы определяли в предыдущем разделе, можно вы- 
полнить оператор 


CloseWindow (FindWindow("SciCalc", "Калькулятор")); 


использующий рассмотренную ранее функцию FindWindow. 

Функция CloseWindow не уничтожает окно, а только сворачивает его. Для 
уничтожения окна можно использовать функцию Destroy Window, но она не разре- 
шает уничтожать окно из другого потока. 

Функция EnableWindow позволяет управлять доступом к окну. Ее описание 
имеет вид: 


bool EnableWindow(HWND hWnd, bool bEnable); 


Параметр hWnd определяет дескриптор того окна, которое должно быть сде- 
лано доступным или недоступным. Параметр bEnable задает устанавливаемое зна- 
чение доступности: true — доступно, false — недоступно. Функция возвращает 
нуль, если окно ранее было доступным, и возвращается ненулевое значение, если 
оно не было доступным. 

Функция EnableWindow делает указанное в ней окно доступным или недос- 
тупным для любых действий пользователя с помощью мыши или клавиатуры. 
Если окно недоступно, то предусмотренные и начатые в нем процессы продолжа- 
ются, но пользователь не может воздействовать на это окно. Такое окно можно ис- 
пользовать для демонстрации каких-то процессов пользователю, но пользователь 
не может его ни свернуть, ни уничтожить. 

Имеется еще множество функций АРТ Windows для управления окнами. Они 
позволяют переместить окно, передать на него фокус, изменить его текст ит.д. Вы 
можете посмотреть информацию об этих функциях в файлах справки ...\program 
Нез\Соттоп Files\Borland Shared\MShelp\95guide.hlp и ..\ргодгат Шез\Соттоп Н- 
les\Borland Shared\MShelp\mapi.hlp. 


6.3 Сообщения Windows и их обработка 


6.3.1 Обработка сообщений в приложениях C++Builder 


Выше мы рассмотрели некоторые функции API Windows, работающие с окна- 
ми. Все они неявно использовали различные сообщения Windows. Но взаимодейст- 
вие с другими приложениями, выполняющимися одновременно с вашим, может 
быть и явным образом организовано с помощью сообщений Windows. 

Приложения Windows состоят из множества объектов, которые взаимодейст- 
вуют друг с другом, обмениваясь сообщениями (messages). Источниками этих сооб- 
щений могут быть: пользователь, оперирующий с клавиатурой и мышью, среда 
Windows, посылающая сообщения приложениям, другие приложения, обмени- 
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вающиеся информацией с вашим приложением и, наконец, ваше приложение, по- 
сылающее сообщения компонентам. 

Большинство сообщений, которые вам могут потребоваться, C++Builder обра- 
батывает сам, так что вам достаточно использовать обработчики стандартных со- 
бытий компонентов. Но иногда вам может потребоваться самому обрабатывать со- 
общения Windows. Такая необходимость возникает, если нужное вам сообщение 
пока еще компонентами C++Builder не обрабатывается, или если вы определили 
свое собственное сообщение. 

Сообщение Windows представляет собой структуру, содержащую поля. Наибо- 
лее важное из них содержит целое значение, идентифицирующее данное сообще- 
ние. В C++Builder содержатся объявления множества идентификаторов, позво- 
ляющие оперировать с мнемоническими именами сообщений, а не с какими-то це- 
лыми значениями. Важная информация о сообщении содержится также в двух по- 
лях параметров и в поле результата. Раньше ссылки на параметры осуществля- 
лись как на WParam (word parameter — параметр типа word) и lParam (long 
parameter- параметр типа long). В ряде случаев каждый параметр содержал не- 
сколько данных, на которые надо было ссылаться, например, как на lParamHi — 
старший разряд параметра ПРагат. 

Сейчас Microsoft ввел для параметров имена, что существенно упрощает рабо- 
тусними. В C++Builder также введены мнемонические имена параметров. Так что 
теперь, например, при обработке сообщения от мыши можно ссылаться на понят- 
ные параметры XPos и YPos, а не на стандартные и ни о чем не говорящие имена 
1ParamLo и 1РагатН!. 

Последовательность обработки сообщений Windows следующая. При создании 
объекта оконного компонента — потомка TWinControl, он регистрируется в 
Windows и получает уникальный идентификатор — дескриптор (handle). Вы mo- 
жете получить к нему доступ через свойство Handle (только для чтения). При реги- 
страции окно передает Windows указатель на процедуру, которая будет вызывать- 
ся при получении им сообщений от Windows. Это метод MainWndProc. Его назна- 
чение — вызов метода обработки сообщений через свойство WindowProc и обработ- 
ка исключений, которые могут возникнуть при вызове WindowProc. По умолча- 
нию в свойстве WindowProc хранится указатель на функцию WndProc. Стандарт- 
ная функция WndProc представляет собой оператор switch, анализирующий иден- 
тификатор сообщения и производящий соответствующие действия. Разработчик 
приложения может во время выполнения заменить эту стандартную функцию на 
свою собственную. В итоге все сообщения передаются методу Dispatch, который 
просматривает таблицу методов класса объекта и извлекает из нее тот, который 
имеет требуемый идентификатор сообщения. Если требуемый метод не найден ни в 
данном классе, ни в классах-предках, то вызывается обработчик сообщения по 
умолчанию DefaultHandler. 

Таким образом, обработка сообщения Windows происходит по цепочке: 


событие => MainWndProc = WndProc => Dispatch => обработчик события 


Для сообщений, обрабатываемых компонентами C++Builder, вам достаточно 
написать свой обработчик события. Для сообщений, не предусмотренных в 
C++Builder, вам надо вмешаться в эту цепочку раньше, перегрузив метод 
WndProc. 

Если объект не имеет дескриптора, то цепочка остается той же, только сообще- 
ние получает оконный компонент, вмещающий данный объект (например, форма). 

В Windows предусмотрено множество сообщений. Описание некоторых из них 
приводится в главе 15 в разделе 15.8.2. Для дальнейших экспериментов нам потре- 
буется только два сообщения. Первое из них — WM_CLOSE, сигнализирующее, 
что окно или приложение закрывается. Это сообщение не имеет параметров. По 


394 ! Глава 6. 


умолчанию оно уничтожает окно, которому послано. Если приложение обрабаты- 
вает это сообщение, то оно должно возвращать нуль. 

При обработке данного сообщения приложение может запросить пользователя 
о необходимости закрывать окно и вызвать функцию закрытия окна только при 
положительном ответе. 

Второе сообщение, которое мы будем использовать — \УМ_АСТУАТЕ. Оно 
посылается, когда окно переводится в активное или неактивное состояние. Снача- 
ла сообщение посылается окну, переходящему в неактивное состояние, а потом — 
активируемому. 

Это сообщение определено следующим образом: 

WM ACTIVATE 

fActive = LOWORD (wParam) ; 


fMinimized = (BOOL) HIWORD(wParam) ; 
hwndPrevious = (HWND) lParam; 


Параметры этого сообщения означают следующее. 
Параметр fActive показывает, как активируется или деактивируется окно. 
Возможные значения параметра: 


ООО ОО ОО ИАН 


о ыы О а а 


WA_ACTIVE окно активируется не 2 щелчком мыши (например, функ- 
цией SetActiveWindow или клавиатурой) 


WA_CLICKACTIVE = окно активируется щелчком мыши 
WA_INACTIVE окно деактивируется 


Параметр fMinimized показывает, свернуто окно, или нет. Ненулевое значе- 
ние соответствует свернутому окну. 

Параметр hwndPrevious — это дескриптор, который указывает на окно, из KO- 
торого фокус переключился на данное окно, если оно активируется, или на окно, в 
которое передается управление, если данное окно деактивируется. 

По умолчанию, если активируемое окно не свернуто, то оно получает фокус. 
Если приложение обрабатывает это сообщение, то оно должно возвращать нуль. 


6.3.2 Посылка сообщений 


B API Windows определен ряд функций, позволяющих послать сообщение. 


6.3.2.1 Функции SendMessage, PostMessage и Perform 


Функция SendMessage посылает указанное в ней сообщение окну или множе- 
ству окон и не возвращается, пока это сообщение обрабатывается. Этим она отли- 
чается от функции PostMessage, которая возвращается сразу после передачи сооб- 
щения. 

Объявление функции SendMessage: 


Int SendMessage(HWnd hWnd, unsigned int Msg, 
WPARAM wParam, LPARAM 1]1Param); 


Параметр hWnd — дескриптор окна, которому передается сообщение. Если 
этот параметр равен HWND_ BROADCAST, то сообщение передается всем окнам 
верхнего уровня в системе, включая недоступные и невидимые, кроме дочерних. 

Параметр Msg определяет передаваемое сообщение. Параметры wParam и 
[Param могут содержать дополнительную информацию. Значение, возвращаемое 
функцией, зависит от вида сообщения. 

Функции PostMessage объявлена следующим образом: 
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bool PostMessage(HWND hWnd, unsigned int Msg, 
WPARAM wParam, LPARAM 1]Param) ; 


Эта функция похожа на SendMessage, но в отличие от нее она помещает сооб- 
щение в очередь и сразу возвращается. Таким образом, PostMessage не годится 
для передачи срочных сообщений, но зато она не блокирует вызвавшее приложе- 
ние на время обработки сообщения приемником. 

Параметры hWnd и Msg аналогичны рассмотренным для функции Send- 
Message. Если hWnd = NULL, то сообщение ставится в очередь сообщений (если 
она есть) текущего процесса. 

Функция PostMessage возвращает ненулевое значение при успешном завер- 
шении и нуль в случае аварийного завершения. В этом случае причину ошибки 
можно установить вызовом функции GetLastError. 

Имеется еще один метод, который может посылать сообщение непосредствен- 
но оконному компоненту. Это метод Perform, объявление которого имеет вид: 


Perform(unsigned int Msg, WPARAM wParam, LPARAM 1Рагам); 


Есть еще ряд функций, позволяющих передавать сообщения, HO мы на них не 
будем останавливаться, так как они реже используются в приложениях 
C++Builder. 


6.3.2.3 Пример посылки сообщений 


Давайте построим простую программу, демонстрирующую посылку сообще- 
ний. Начните новый проект, создайте в нем две формы Form] и Form2, сохраните 
проект, назвав модули форм 01Ме5$1 и U2ZMess1 соответственно, а файл проекта 
— PMess1. Форма Еогт1 будет у нас главной и она будет управлять видимостью 
формы Form2. Поэтому в ее модуль введите директиву препроцессора 


#include "U2Mess1.h" 


a свойство Visible формы Form2 должно быть равно false. 
Перенесите на форму Еогт1 две кнопки, дав им надписи «Show Еогт2» и 
«Close Form2». В обработчике щелчка первой кнопки напишите оператор 


Form2->Show(); 


а в обработчике щелчка второй кнопки — оператор 
SendMessage (Form2->Handle,WM CLOSE,0,0); 


Этот оператор посылает сообщение WM_CLOSE (второй параметр функции 
SendMessage) форме Form2. Первый параметр функции SendMessage содержит 
дескриптор окна этой формы, полученный с помощью ее свойства Handle. Сообще- 
ние WM_CLOSE не имеет параметров; поэтому параметры wParam и 1Рагашт зада- 
ны равными нулю. 

Приведенный выше оператор можно заменить на следующий: 


Form2->Perform(WM CLOSE,0,0); 


Результат будет тем же самым. 

Сохраните и запустите приложение. Вы увидите, что нажатие пользователем 
кнопки Show Гогт2 приводит к появлению на экране формы Еогт2, а нажатие 
кнопки Close Form2 — к ее закрытию. Так что посылаемое формой Еогт1 сообще- 
ние достигает своего адресата. 

Конечно, этот пример не очень интересный, поскольку сделать невидимой 
форму Form2 мы могли бы и не посылая никаких сообщений Windows, а просто 
используя метод Hide. Поэтому пойдем дальше. Откройте новый проект, задайте 
заголовок Caption ее формы равным «Приложение Pmess2» (этот текст мы будем 
далее использовать для идентификации окна этого приложения) и сохраните про- 
ект под именем РМе5$2, а модуль формы — под именем U1Mess2. Кстати, посколь- 
ку у нас будет два проекта, можете включить их в общую группу, чтобы опробо- 
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вать этот инструмент (см. раздел 2.4.3). Откомпилируйте новый проект и сохрани- 
те. В дальнейшем мы еще к нему вернемся. 

Теперь давайте попробуем управлять этим проектом из формы Form] проекта 
РМе5$1. Откройте опять проект РМе5$1 и добавьте на форму Form] две кнопки, 
сделав на них надписи «Exec Pmess2» и «Close Pmess2». В обработчике щелчка 
первой кнопки напишите оператор 


WinExec("Pmess2.exe",SW RESTORE) ; 


который, как вы уже знаете, запускает приложение PMess2 на выполнение. A Te- 
перь давайте попробуем его закрыть. Для этого в обработчике 'целчка кнопки Close 
Pmess2 напишите оператор 


SendMessage (FindWindow("TForm1", "Приложение Pmess2"), ИМ CLOSE,0,0); 


Этот оператор использует функцию FindWindow для получения дескриптора 
окна приложения, которому надо послать сообщение, а затем функцией 
SendMessage посылает сообщение WM_CLOSE. 

Сохраните и запустите приложение. Теперь, нажимая кнопку Exec Pmess2, вы 
можете выполнять приложение PMess2, причем можете создать несколько экземп- 
ляров этого приложения. А кнопкой Close Pmess2 можете закрывать приложение 
PMess2. 

Вы получили возможность управлять из своего приложения другими. Ho в 
данном случае вы знали класс окна (TForm1) внешнего приложения, поскольку 
вы сами его создавали. Поэтому вы смогли применить функцию Find Window, пе- 
редав в нее и имя класса, и заголовок окна. А как быть, если вы хотите закрыть 
какое-то чужое приложение? ` Например, вы из своего приложения выполнили 
стандартное приложение Windows «Калькулятор», пользователь посчитал, что 
ему было надо, а теперь вы хотите закрыть «Калькулятор», послав ему сообщение 
WM_CLOSE (например, пользователь уже не работает с ним, а закрыть забыл). 

При посылке сообщения другому приложению возникает задача определить 
дескриптор нужного окна. Как это можно сделать обсуждалось ранее в разделе 
6.2.1. Если вы определили имя класса необходимого вам приложение (например, 
SciCalc для приложения «Калькулятор») с помощью WinSight 32 и хотите послать из 
своего приложения сообщение о закрытии калькулятора, вы можете выполнить 
оператор: 

SendMessage (FindWindow ("5с1Са1с", "калькулятор"),ИМ CLOSE,0,0); 


Если вы определили дескриптор окна способами, изложенными в 6.2.1, TO вы 
просто посылаете сообщение окну с данным дескриптором. 


6.3.3 Обработка сообщений 


Во всех оконных компонентах предусмотрены обработчики сообщений 
Windows по умолчанию. До сих пор вы пользовались именно стандартными обра- 
ботчиками сообщений. Однако, вы можете определить и свои собственные обработ- 
чики, заменив ими обработчики по умолчанию, или дополнив их. 

Для введения собственного обработчика сообщения Windows надо сделать сле- 
дующее: 

1. Создать в объявлении класса карту (тар) сообщений и ввести в нее те сообще- 
ния, которые вы хотите обрабатывать сами. 


2. Добавить в объявление класса объявления вводимых вами обработчиков. 
3. Описать эти обработчики в вашем модуле. 


Первый шаг — объявление карты сообщений, легко осуществляется с помо- 
щью следующих макросов: 


BEGIN MESSAGE МАР 
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MESSAGE HANDLER(parameterl, parameter2, parameter3) 


END MESSAGE MAP 


Макрос BEGIN MESSAGE MAP открывает объявление карты сообщений, 
макрос ЕМО_МЕЗЗАСЕ_МАР завершает это объявление, а один или несколько 
макросов MESSAGE HANDLER вводят в карту соответствующие сообщения. В 
макросе MESSAGE HANDLER первый параметр указывает имя сообщения, BTO- 
рой — тип структуры сообщения, а третий — имя функции-обработчика. 

Имя сообщения пишется заглавными буквами и должно соответствовать пре- 
допределенному в Windows сообщению. Например, WM_CLOSE. Имя типа струк- 
туры сообщения может быть любым, но обычно принято делать его тождествен- 
ным имени обрабатываемого сообщения с исключенным из него символом подчер- 
кивания и добавленным префиксом Т. Например, TWMClose. Передаваемый в 06- 
работчик параметр этого типа представляет собой структуру, через которую в обра- 
ботчик передаются параметры сообщения, а из обработчика возвращается значе- 
ние поля Result, фиксирующее результат обработки. Имя функции-обработчика 
сообщения также может быть любым, но обычно оно образуется из имени сообще- 
ния исключением первых символов WM_ и добавлением префикса Оп. Например, 
OnClose. 

Давайте введем в рассмотренное ранее наше приложение PMess2 и в форму 
Form2 приложения РМе5$1 обработку тех сообщений \УМ_СГОЗЕ, которые мы 
посылаем им из формы Form1. Для этого поместим на форму Еогт1 приложения 
PMess2 и на форму Еогт2 приложения PMess1 метки Labell, чтобы отображать в 
них текст, свидетельствующий о том, что обработка сообщения действительно про- 
исходит. Введем в модулях этих форм следующие обработчики (текст приведен 
для Form2; для Forml все то же самое с заменой идентификатора Form2 на 
Form1): 

// модуль U2Messl.h 


class TForm2 : public TForm 
{ 
__ published: // IDE-managed Components 
TLabel *Labell; 
private: // User declarations 
void _fastcall ОпС1озе (ТИМС1о5е& Message) ; 
public: // User declarations 
__fastcall TForm2 (TComponent* Owner) ; 
BEGIN MESSAGE. МАР 
MESSAGE HANDLER(WM CLOSE, TWMClose, OnClose) 
END MESSAGE МАР (TComponent) 
}; 
// 
// модуль U2Messl.cpp 


void _fastcall TForm2::OnClose(TWMCloseé a) 

{ 

Label2->Caption = "Караул! Закрывают!"; 

if (MessageDlgPos ("Меня хотят закрыть. Согласны?", 
mtConfirmation, TMsgDlgButtons() << пруез<< mbNo << mbCancel, 


0,BoundsRect.Left, BoundsRect.Bottom) == mrYes) 
Close(); 
else Label2->Caption = "He закроюсь!"; 


a.Result = 0; 
} 


В этом коде в файле U2Mess1.h в разделе public объявлена карта сообщений, в 
которую включено сообщение WM_CLOSE. Для этого сообщения объявлен обра- 
ботчик OnClose и тип передаваемого в него параметра — TWMClose. В разделе 
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private объявлена функция этого обработчика. В нее передается параметр, назван- 
ный Message — структура сообщения. | 

В обработчике OnClose сообщения WM_CLOSE с параметром, которому дано 
имя а, производится запрос подтверждения пользователя о закрытии окна. Для за- 
проса использована процедура MessageDlgPos, позволяющая указать позицию 
окна запроса вблизи окна формы, к которой относится запрос. При положитель- 
ном ответе пользователя окно закрывается методом Close. В заключение операто- 
ром a.Result = 0 возвращается нуль, так как это действие оговорено в приведенном 
ранее описании сообщения WM_CLOSE. 

Откомпилируйте оба ваших приложения и выполните приложение РМез531. 
После Toro, как вы сделаете кнопкой Show Form2 видимой форму Еогтё и запусти- 
те кнопкой Exec Pmess2 приложение PMess2, вы увидите, что окна формы Form2 и 
PMess2 оказывают сопротивление попыткам их зарыть, независимо от того, как 
это делается: кнопками Close Гогт2 и Close Pmess2, или кнопками в полосах заго- 
ловков этих окон. В любом случае они закрываются только после подтверждения 
пользователя. | 

Кстати, вы можете наглядно посмотреть и очередь сообщений. Щелкните на 
кнопке Close Pmess2 и, пока на экране отображено окно запроса, вернитесь, ничего 
не отвечая, в окно формы Еогт1 первого приложения и щелкните еще несколько 
раз на кнопке Close Pmess2. После этого ответьте на запрос отрицательно. Вы уви- 
` дите, что окно запроса без всяких дополнительных действий с вашей стороны бу- 
дет отображаться еще столько раз, сколько раз вы щелкнули перед этим Ha Close 
Pmess2. Все сообщения, связанные с этими щелчками, запомнились в очереди и 
теперь очередь разгружается. 

Приведенный пример обработки сообщений не очень показательный, посколь- 
ку сообщение WM CLOSE не имеет параметров. Давайте усовершенствуем наши 
приложения так, чтобы поработать с сообщениями, имеющими параметры. Вос- 
пользуемся. для этого описанным ранее (раздел 6:3.1) сообщением WM_ACTIVA- 
ТЕ. Это сообщение получает любое окно при его активации или деактивации. Сооб- 
щение имеет, в частности, параметр fActive. Значение WA_INACTIVE этого пара- 
метра показывает, что окно деактивируется. Иные значения параметра показыва- 
ют, что окно активируется. 

Давайте введем во все наши формы (Еогт1 и Form2 приложения РМез$1, и 
Form1 приложения PMess2) обработчики сообщения WM_ACTIVATE. Чтобы ви- 
деть, что эти обработчики работают правильно, поместим на эти формы дополни- 
тельно метки Label2, в которых будем отображать результаты обработки. И во все 
три формы введем обработчики вида (приводится текст для формы Еогт2): 

// модуль U2Messl.h 

Class TForm2 : public TForm 


{ 


published: // IDE-managed Components 
TLabel *Labell; 
TLabel *Label2; 
private: // User declarations 
void _fastcall OnClose(TWMCloseé Message) ; 
` void _fastcall OnActivate (TWMActivateé& Message) ; 
public: // User declarations 
__fastcall TForm2 (TComponent* Owner) ; 

BEGIN MESSAGE MAP | 
MESSAGE НАМОГЕВ (ИМ CLOSE, TWMClose, OnClose) 
MESSAGE HANDLER(WM ACTIVATE, TWMActivate, OnActivate) 

END MESSAGE MAP (TComponent) 

}; 
// 
// модуль U2Messl.cpp- 


void _ Еаз®са11 TForm2::OnActivate (TWMActivateé а) 
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{ 
if (a.Active == МА ТМАСТТУЕ) 
Label2->Caption = "Меня покинули!"; 
else Label2->Caption = "Ура! Я работаю!"; 
a.Result = 0; — 
} 


Обработчик OnActivate строится по тем же принципам, что и предыдущий. В 
нем анализируется значение поля Active структуры a, передаваемой в процедуру в 
качестве параметра и содержащей параметры сообщения. В зависимости от значе- 
ния этого параметра производятся те или иные действия. 

Откомпилируйте оба ваших приложения и выполните приложение РМе5$1. 
Вы увидите (рис. 6.1), как при каждом переключении фокуса между окнами в них 
появляются сообщения, отражающие потерю и обретение ими активности. 


Рис. 6.1 
Приложения, 
обменивающиеся 
сообщениями 


[Conon SMe ee ne al 


“Mena wows закрыть Сагласны? 


Подобное приложение, дополненное еще несколькими обработчиками собы- 
THU, вы можете увидеть на диске, приложенном к книге. 

В C++Builder 5 создание собственных обработчиков исключений упростилось, 
благодаря новым возможностям Исследователя Классов ClassExplorer (раз- 
дел 2.5.3.2). Опробуйте его при создании, например, обработчика события 
OnActivate. Если окно Исследователя Классов у вас не открыто, выполните коман- 
ду View | ClassExplorer. Щелкните в окне ClassExplorer правой кнопкой мыши и во 
всплывшем меню выберите раздел New Method — новый метод. Перед вами откро- 
ется окно, представленное на рис. 6.2. 


Рис. 6.2 
Диалоговое окно задания нового метода 
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Поскольку вы создаете обработчик сообщения, надо включить индикатор 
Message Handler. Затем из расположенного правее индикатора выпадающего списка 
вы можете выбрать имя сообщения — WM_ACTIVATE. В верхнем окошке Method 
Мате вы должны написать имя создаваемого метода — ОпАсйуже. В выпадаю- 
щем списке Add to Class вы можете выбрать класс, объявленный в проекте, в кото- 
рый вводится свойство. В окошко Агдитеп!5 вам надо занести список аргументов 
функции в том виде, в котором он должен появиться в скобках ее объявления — в 
нашем случае «TWMActivate& а». Поскольку создается функция, надо включить 
радиокнопку Function. При этом становится доступным выпадающий список Function 
Result, позволяющий задать тип возвращаемого функцией значения — для нашего 
примера void. Группа радиокнопок Visibility sagaer доступ к методу: public, private, 
protected или published. Группа индикаторов Directives позволяет задать специфи- 
каторы объявления метода. Их смысл ясен из надписей около индикаторов. 

После того, как вы установили в окне рис. 6.2 всю необходимую информацию, 
можете щелкнуть на ОК для выхода из окна или на Арру для внесения в код задан- 
ных установок и продолжения работы в диалоговом окне. 

Вы увидите, что в заголовочном файле появятся все необходимые объявления, 
включая объявление карты сообщений. А в файле реализации появится код: 


void _fastcall TForml::OnActivate (TWMActivateé а) 


{ 
//TODO: Add your source code here 


} 


Это заготовка функции вашего обработчика с включенным оператором To-Do 
List (см. раздел 2.4.4.1). Он обеспечивает отображение соответствующей строки в 
окне То-Шо List, которая будет напоминать вам о необходимости завершить кодиро- 
вание обработчика. 

Приведенный пример показывает, какую большую помощь может оказать вам 
ClassExplorer в C++Builder 5 при создании обработчиков сообщений. 


6.3.4 Определение собственных сообщений 


В предыдущих разделах посылались и обрабатывались сообщения, предопре- 
деленные API Windows. Однако, вы можете описать свои собственные сообщения и 
работать с ними так же, как с предопределенными. 

Номера своих собственных сообщений вы должна отсчитывать от константы 
WM_USER, которая соответствует первому номеру сообщения пользователя. 

Например, вы можете определить в своем приложении константы 


#define ММ MyMessl WM USER 
#define WM MyMess2 WM USER + 1 


S 


и затем оперировать с сообщениями WM_MyMessl и WM_MyMess2Z как с предо- 
пределенными в Windows. Например, можете вставить в карту сообщений объяв- 
ление: | 

MESSAGE HANDLER(WM MyMessl, TMessage, OnMyMess1) 


В данном объявлении в качестве типа параметра использован тип TMessage. 
Этот тип определяет следующую структуру: 


struct TMessage 
{ 
unsigned int Msg; 
long WParam; 
long LParam; 
long Result; 
}; 
Вы можете при посылке сообщения передавать параметрами WParam и Гра- 
гат любую необходимую информацию. 
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В качестве примера давайте добавим в нашем тестовом приложении PMess1 на 
форму Еогт1 компонент CSpinEdit и кнопку, задав ей надпись Послание. В обра- 
ботчик щелчка на этой кнопке мы хотим вставить посылку сообщения второму на- 
шему приложению — PMess2, в котором в качестве кода послания передать число, 
установленное пользователем в компоненте CSpinkdit. 

Для того, чтобы сделать это, объявите в заголовочном файле UlMess1.h номер 
вашего сообщения с именем, например, WM_MyPost: 


#define ММ MyPost ММ USER 


а в обработчик события щелчка Ha кнопке Послание вставьте оператор 

SendMessage (FindWindow ("ТЕГогм1", "Приложение Pmess2"), 

WM MyPost,0,CSpinEdit1l->Value) ; 

Вот и все! Сообщение будет носылаться. Можно было даже сделать проще: He 
вводить константы, а просто в функции SendMessage указать вместо WM_MyPost 
номер сообщения — WM_USER. Но с именем сообщения код читается проще. 

Теперь осталось написать обработчик этого сообщения в приложении РМе5$2. 
Это выглядит так же, как и для других обработчиков сообщений: 

// модуль UlMess2.h 


#define ММ MyPost WM USER 
ось ie oe Gea a aati 
class TForml : public TForm 


{ 


private: // User declarations 
void _fastcall OnMyPost (TMessageé& Message) ; 
public: // User declarations 


__fastcall TForml (TComponent* Owner) ; 
BEGIN MESSAGE MAP 


MESSAGE HANDLER(WM MyPost, TMessage, OnMyPost) 
END MESSAGE МАР (TComponent) 
}; 
||} 


// модуль UlMess2.cpp 


void _ fastcall TForml::OnMyPost (TMessageé а) 
{ 


Label2->Caption = "Получено письмо " + IntToStr(a.LParam) ; 

} 

В объявлении и реализации обработчика использован тип TMessage — стан- 
дартный тип параметра сообщения Windows. , 

Можете запускать приложения и убедиться, что послание нормально переда- 
ется и воспринимается. Конечно, это просто демонстрация возможностей обмена 
собственными сообщениями. В реальных приложениях можно по номеру парамет- 
ра оператором switch выбирать тот или иной вид реакции приложения на получен- 
ное сообщение. 


6.4 Внедрение и связывание объектов — OLE 
6.4.1 Общие сведения 


Прежде, чем рассматривать реализацию в C++Builder технологии внедрения и 
связывания объектов ОГЕ (произносится «оле» с удгоением на последний слог), 
остановимся на некоторых базовых понятиях. Эта технология появилась как ОГЕ 
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1.0 в Windows 3.1 и означала, что пользователь мог создавать сложные составные 
документы, в которых содержались объекты различного происхождения. Внедрен- 
ные объекты могли редактироваться простым двойным щелчком мыши на COOT- 
ветствующем элементе данных. Например, можно было дважды щелкнуть на элек- 
тронной таблице Excel, встроенной в документ редактора Word, и в отдельном 
окне запускался Excel с загруженным рабочим листом, готовым к редактирова- 
нию. После завершения редактирования Excel позволял сохранить изменения во 
внедренном в документ Word объекте Excel. 

Другой особенностью было связывание объектов. Это позволяло связать элек- 
тронную таблицу с документом Word (по сути внутри документа Word хранился 
просто указатель на электронную таблицу). Если данные в оригинале электронной 
таблицы обновлялись, то при следующей загрузке документа Word ссылка обнов- 
ляла документ и отражала в нем проведенные изменения. 

Дальнейшее развитие внедрение и связывание получило в OLE 2.0. Основой 
этого усовершенствованного подхода явилась компонентная модель объекта 
(СОМ ). Это модель объекта в системном обеспечении, которая предусматривает 
полную совместимость во взаимодействии между компонентами, написанными 
разными компаниями и на разных языках. Ключом к успеху является модуль- 
ность этих компонентов. Они могут покупаться, модернизироваться или заменять- 
ся поодиночке или группами, причем это никак не влияет на работу целого. 

СОМ определяет двоичный интерфейс, полностью независимый от языка про- 
граммирования, использованного при. реализации компонента. Компонент, напи- 
санный в соответствии со спецификациями двоичного интерфейса СОМ, может 
вступать во взаимодействие с другим компонентом, не зная в действительности ни- 
чего о реализации последнего. 

Новая особенность, появившаяся в OLE 2.0, — это автоматизация OLE, кото- 
рая обеспечивает доступ к объектам приложения и манипуляцию с ними. извне. 
Такие объекты, предоставленные (экспонированные) для внешнего пользования, 
называются автоматными объектами OLE. Типы объектов, которые могут быть 
экспонированы, так же разнообразны, как и сами приложения Windows. Тексто- 
вый процессор может экспонировать в качестве автоматного объекта документ, аб- 
зац или предложение. Электронная таблица может экспонировать таблицу, диа- 
грамму, ячейку или группу ячеек. 

Главное отличие автоматных объектов от обычных объектов ОГЕ состоит в 
том, что автоматные объекты доступны только программно, они создаются и ис- 
пользуются при помощи программного кода и, следовательно, в принципе времен- 
ны. Они не могут быть внедрены или связаны. Они могут существовать только в те- 
чение времени выполнения ваших программ и не видны непосредственно конечно- 
му пользователю. 

Существуют два типа автоматных серверов: внутри-процесса и вне-процесса 
(их еще называют локальными). C++Builder поддерживает оба типа серверов. 

Сервер внутри процесса является DLL (динамически евязываемой библиоте- 
кой), которая экспортирует автоматные объекты. Поскольку автоматные объекты 
поставляются из DLL, а не из других приложений, они являются частью приложе- 
ния клиента. Это избавляет от больших накладных расходов, сопутствующих каж- 
дому вызову автоматного сервера. 

Сервер вне-процесса — это автономный исполняемый файл, экспортирующий 
автоматные объекты. Примером этого мог бы быть Microsoft Word. Word имеет не- 
которое количество объектов, которые он экспонирует в качестве автоматных. 
Позже будет приведен пример использования Word как автоматного сервера. 
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6.4.2 Внедрение и связывание 


Теперь рассмотрим основные приемы использования OLE в C++Builder. На 
странице System библиотеки визуальных компонентов имеется контейнер OLE 
OleContainer — компонент, обеспечивающий внедрение и связывание. Давайте по- 
смотрим его возможности сначала на очень простом примере. Разместите на форме 
контейнер OleContainer, компонент главного меню MainMenu, диалоги OpenDia- 
log и SaveDialog. Можно также разместить панель и на ней быстрые кнопки, дуб- 
лирующие основные команды меню. Но меню, как мы увидим ниже, должно быть 
обязательно. 

Панель, если вы ее ввели, выравнивается по верху формы (Align = alTop), a 
контейнер должен занимать всю оставшуюся площадь формы (Align = alClient). 
Пример такого приложения приведен на рис. 6.3. 

Рис. 6.3 [67 Простой пример OLE 
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Форма простого приложения OLE 


В MainMenu введите меню Объект и в нем разделы Новый, Открыть, Сохранить, 
Закрыть. Назовите объекты этих разделов MNew, MOpen, MSave и MClose. 

Установите в диалогах в свойстве Filter: «объекты OLE | *.ole» и «все файлы | 
*.*». Установите также в диалогах расширение по умолчанию в свойстве 
DefaultExt равным ole. 

Теперь перейдем собственно к программированию. Давайте введем в определе- 
нии класса формы глобальную переменную Епате, в которой будет храниться имя 
файла объекта ОГЕ: 


AnsiString FName; 
Процедура, соответствующая разделу меню Новый, может иметь вид: 


{ 
if (OleContainerl->InsertObjectDialog() ) 
FName = ""; 


} 


Вызываемый этим оператором метод InsertObjectDialog осуществляет обра- 
щение к стандартному окну Windows Insert Object (вставка объекта), в котором 
пользователь может указать тип вставляемого объекта, инициализирует объект 
OLE и загружает его в контейнер OleContainer1. Работу с окном Вставка объекта мы 
рассмотрим несколько позднее, а пока продолжим создание приложения. 

Процедура, соответствующая разделу меню Закрыть, может иметь вид: 


void _fastcall TForml::MCloseClick(TObject *Sender) 


{ 
OleContainerl->DestroyObject (); 


} 


Эта процедура разрушает объект в контейнере OLE. 
Процедура, соответствующая разделу меню Сохранить, может иметь вид: 


404 ет Глава 6 


void _fastcall TForml::MSaveClick(TObject *Sender) 
{ 
if (FName == "") 
if (SaveDialogl->Execute () ) 
FName = SaveDialogl->FileName; 
else return; ; 
OleContainerl->SaveToFile (ChangeFileExt (FName,".ole")); 
} 


Если имя файла не задано, TO вызывается диалог Сохранить как (SaveDialog1), 
с помощью которого пользователь задает имя файла. Затем методом SaveToFile 
объект сохраняется в файле. При этом во избежание ошибок расширение файла 
принудительно заменяется Ha .ole с помощью функции ChangeFileExt, изменяю- 
щей расширение файла (см. главу 15 раздел 15.5.5). 

Процедура, соответствующая разделу меню Открыть, может иметь вид: 


void _fastcall TForml::MOpenClick(TObject *Sender) 


{ 
if (OpenDialogli->Execute() ) 


{ 
OleContainerl->LoadFromFile (OpenDialogl->FileName) ; 
FName = OpenDialogl->FileName; 
OleContainerl->Repaint (); 
} 
} 


Она обычным образом вызывает диалоговое окно, в котором пользователь вы- 
бирает открываемый файл. Затем объект, соответствующий этому файлу, загружа- 
ется в контейнер методом LoadFromFile. Имя файла запоминается в переменной 
FName. Последний оператор методом Repaint перерисовывает окно контейнера, 
чтобы в нем немедленно отобразился открытый объект. 

Теперь посмотрим, как работает наше приложение. Запустите его на выполне- 
ние и выполните команду Новый. Перед вами откроется окно Вставка объекта (Insert 
Object), представленное на рис. 6.4. В этом окне вам предоставляются две возмож- 
ности: создание нового объекта OLE (радиокнопка Создать новый), или создать объ- 
ект из имеющегося файла (радиокнопка Создать из файла). 


Рис. 6.4 Вставка объекта 
Окно вставки объекта OLE — ЕЕ 


вставка нового объекта У 
Звукозапись 

Картинка Microsoft ClipArt 
Клип мультимедиа 
Лист Microsoft Excel 


ок Microsoft Word 


Рассмотрим сначала первую возможность. А этом случае в окне Тип объекта вы 
должны указать тип вставляемого в контейнер объекта. Это может быть документ 
Word, лист Excel, объект звукозаписи, точечный рисунок (как на рис. 6.4) и т.п. 
Правда, к сожалению, надо отметить, что не любой тип объекта и не в любой вер- 
сии Windows может быть вставлен. Так что с переносимостью подобных приложе- 
ний могут возникнуть проблемы. Если вставка не получится, вам будет выдано со- 
ответствующее сообщение. 
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После того, как вы выбрали тип объекта и щелкнули на OK, в контейнере OLE 
вашего приложения отобразится вид объекта по умолчанию. Этот вид зависит от 
типа объекта. Возможно, в первый момент вы вообще ничего не увидите. Сделайте 
двойной щелчок на контейнере, вызывая тем самым программу, обслуживающую 
объект этого типа. Вы увидите, что ваше приложение чудесным образом преобра- 
зится. В него встроится соответствующая программа вместе со своими инструмен- 
тальными панелями и меню. На рис. 6.5 вы видите встроенную программу 
Microsoft Paint, обслуживающую объекты битовых матриц — точечные рисунки. 
Вы можете нарисовать какое-то свое изображение или с помощью команды ее 
меню Правка | Вставить из файла открыть какой-то файл с битовой матрицей. На 
рис. 6.5, например, открыт файл, расположенный в каталоге \ргодгат files\Common 
Files\Borland Shared\lmages\Splash\16Color\athena.bmp. Далее вы может редактиро- 
вать загруженное изображение (правда, надеюсь, у вас не поднимется рука редак- 
тировать показанное на рис. 6.5 прекрасное фирменное изображение Borland). 


Рис. 6.5 1. Простой пример OLE 


Приложение с внедренным объектом : равка Вид 
OLE — редактирование объекта 


Обратите внимание на то, что ваша инструментальная панель сохранилась на 
экране и после загрузки объекта и начала работы с ним. И, главное, заметьте, что 
не все разделы меню программы Microsoft Paint встроились в ваше приложение. 
Нет первого меню — Файл, в котором содержатся команды открытия и сохранения 
файлов. Это не случайно, так как далее будет показано, что сохранение объекта 
OLE отличается от сохранения файла изображения. Как вы можете видеть на 
рис. 6.5, вместо меню Файл, имеющегося в Microsoft Paint, встроилось меню Объ- 
ект вашего приложения, в котором имеются соответствующие команды открытия и 
закрытия файла. Именно ради этого мы и делали в своем приложении меню. 

Мы рассмотрели одну из возможностей создания в вашем приложении объекта 
OLE. Теперь давайте вернемся к окну рис. 6.4 и рассмотрим другие возможности. 
Выполните опять команду Новый вашего приложения и в окне рис. 6.4 выберите 
радиокнопку Создать из файла (Create from File). В этом случае вы можете создать 
объект OLE на основе имеющегося файла. При этом диалоговое окно изменит свой 
вид (см. рис 6.6). В нем вы можете с помощью кнопки Обзор выбрать какой-ни- 
будь файл, например, тот же файл athena.bmp, который использован в предыду- 
щем примере. Обратите внимание на очень важный индикатор Связь (Link). Пока 
не устанавливайте этот индикатор, а просто нажмите ОК. 

В контейнер вашего приложения загрузится содержимое файла (рис. 6.7). Вы 
создали в своем приложении внедренный (но не связанный) объект OLE. Если вы 
хотите вызвать программу, обслуживающую этот объект (в нашем примере — 
Microsoft Paint), сделайте на нем двойной щелчок. Вы увидите ту же картину, с 
которой уже знакомы по рис. 6.5 — программа Microsoft Paint встроится в ваше 
приложение. 
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Рис. 6.6 тавка объект 
Окно вставки объекта OLE — 
вставка объекта из файла 


Гатадез\Зрвы\И6Соолаветаьть TT 


Рис. 6.7 

Приложение с внедренным 
объектом OLE — просмотр 
файла 


Теперь остановимся на сохранении объекта. Если вы выполните команду ва- 
шего приложения Сохранить, то с помощью обычного диалога сохранения можете 
записать объект в нужный вам каталог. Тем самым вы создадите файл, содержа- 
щий внедренный объект OLE. В дальнейшем вы можете открыть его командой 
Открыть вашего приложения. Это абсолютно автономный объект, никак не свя- 
занный с исходным файлом, из которого он был создан. Но открыть его можно 
только как объект OLE. Если вы попробуете открыть его, например, программой 
Microsoft Paint, вы потерпите неудачу, так как Microsoft Paint не поймет формата 
этого файла. 

Теперь попробуйте создать внедренный и связанный документ. Выполните 
опять команду Новый вашего приложения, в диалоговом окне Вставка объекта, пред- 
ставленном на рис. 6.4, опять выберите радиокнопку Создать из файла (Create from 
File), затем в окне рис. 6.6 выберите какой-нибудь файл, но на этот раз установите 
индикатор Связь (Link). После щелчка на ОК в окне вашего приложения снова поя- 
вится выбранный вами объект документа. Вы опять можете сохранить этот объект 
командой Сохранить. Но теперь документ в вашем объекте не просто внедрен, аи 
связан с исходным файлом. Это означает, что все изменения в исходном файле от- 
разятся в вашем объекте и наоборот. Кроме того изменяется и взаимодействие ва- 
шего приложения с документом. Если вы сделаете двойной щелчок на объекте в 
вашем приложении, то откроется отдельное, полноценное окно программы, обра- 
батывающей ваш объект, например, Microsoft Paint, с загруженным в него доку- 
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ментом. Вы можете что-то изменить в нем, напечатать его, сохранить. Как только 
он будет сохранен, в вашем приложении отразятся введенные изменения. 

Вы создали очень простое приложение, использующее ОГЕ. Его можно усовер- 
шенствовать, добавив в меню еще несколько разделов. Один из них — Открыть 
файл. В отличие от рассмотренного ранее раздела, открывающего объект OLE, в 
данном разделе можно создавать новый объект на основе какого-то существующего 
файла документа. Делается это методом CreateObjectFromFile: 


void CreateObjectFromFile(AnsiString FileName, bool Iconic); 


Аргумент FileName определяет имя открываемого файла. Второй аргумент 
функции Iconic, значение которого обычно задается равным false, показывает, что 
объект отображается в том виде, в каком он содержится в исходном файле. Если 
задать этот аргумент, равным true, то объект будет отображаться в виде пикто- 
граммы. 

Таким образом, в вашем приложении обработчик команды Открыть файл может 
иметь вид: 


void _fastcall TForml::MOpenFClick(TObject *Sender) 


{ 
if (OpenDialogl->Execute() ) 


{ 
OleContainerl->CreateObjectFromFile (OpenDialogl->FileName, false); 
FName = OpenDialogl->FileName; 
OleContainerl->Repaint (); 
} 
} 


Выполнение этой команды эквивалентно описанному ранее созданию внедрен- 
ного объекта OLE из файла, но исключает необходимость пользователю работать с 
окнами рис. 6.4 и 6.6. 

Имеется также аналогичный метод CreateLinkToFile, позволяющий создавать 
внедренный и связанный объект: 


void CreateLinkToFile(const AnsiString FileName, bool Iconic); 


Можете воспользоваться им для включения в ваше меню и такого раздела. 

Еще один раздел, который можно добавить в меню вашего приложения — Со- 
хранить файл. В отличие от рассмотренного ранее раздела, сохраняющего в файле 
объект OLE, в данном разделе можно сохранять документ, содержащийся в объек- 
те, в его натуральном виде. Это можно сделать оператором, использующим функ- 
цию SaveAsDocument: 


OleContainerl->SaveAsDocument (FName) ; 


Функции CreateObjectFromFile, CreateLinkToFile и SaveAsDocument позво- 
ляют построить фактически универсальный редактор текстовых, графических, 
музыкальных и других файлов. 


6.4.3 Автоматизация OLE 


Внедрение и связывание позволяют запустить приложение, обрабатывающее 
соответствующий документ как единое целое. Автоматизация ОГЕ позволяет уп- 
равлять этим приложением (сервером OLE), используя экспонированные им функ- 
ции и процедуры. Осуществляется связь с сервером функцией CreateOleObject. 
Приведем пример, в котором в качестве сервера используется Microsoft Word. 

Пусть вы хотите создать приложение, которое печатало бы вам идентичные 
письма, адресованные различным адресатам. Это могут быть поздравления с 
праздниками, приглашения на какие-то мероприятия, письма деловым партнерам 
ит.п. Вы хотите иметь возможность написать в вашем приложении текст письма, 
выбрать для него атрибуты шрифта, а затем писать имена адресатов и печатать по- 
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лучившиеся письма или записывать их в файлы для последующей печати или пе- 
ресылки по электронной почте. 

Создайте форму, включающую в себя окно редактирования Мето для ввода 
текста, окно редактирования Edit для ввода имени адресата, группу радиокнопок, 
определяющих пол адресата, группу радиокнопок, определяющих производимую 
операцию: запись в файл или печать, диалог FontDialog для выбора шрифта, диа- 
лог SaveDialog для задания имени сохраняемого файла и две кнопки — Шрифт для 
выбора шрифта и Выполнить для выполнения заданной операции. Пример работы 
такого приложения приведен на рис. 6.8. 


Рис. 6.8 
Приложение, использующее 
автоматизацию OLE 


| Уригташаю Bac в воскресенье 
Ha день рождения в 77 часов 


| то адресу... 


Текст приложения может иметь вид: 


#include "СомОор7 .hpp" 
Variant W; 


void  fastcall TForml::Ins(AnsiString S) 

{ 

W.Exec (Procedure ("Font") << Memol->Font->Name 

<< Memol->Font->Size) ; 

if (Memol->Font->Style.Contains (fsBold) ) 
W.Exec (Procedure ("Bold") ); 

if (Memol->Font->Style.Contains(fsItalic) ) 
W.Exec (Procedure ("Italic") ); 

W.Exec (Procedure ("Insert") << ($ + "\n")); 


} 


мо ити ит тети 49 

void _fastcall TForml::ButtonlClick(TObject *Sender) 

{ 

AnsiString s; 

W = CreateOleObject ("Word.Basic") ; 

W.Exec (Procedure ("AppShow") ) ; 

W.Exec (Procedure ("FileNew") << "Normal") ; 

if (RGSex->ItemIndex == 0) 
Тп$ ("Дорогой " + EName->Text + "!"); 

else Тп$ ("Дорогая " + EName->Text + "!"); 

for (int i = 0; i <= Memol->Lines->Count; i++) 
Ins (Memol->Lines->Strings[i]); 

if (RGOp->ItemIndex == 0) 
$ = "Записать это письмо в файл?"; 

else $ = "Напечатать это письмо?"; 
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if (MessageDlg(s, mtConfirmation, TMsgDlgButtons() << mbYes 
<< mbNo, 0) == mryYes) 
if (RGOp->ItemIndex == 0) 
{ 
if (SaveDialogl->Execute() ) 
W.Exec(Procedure("FileSaveAs") << SaveDialogl->FileName) ; 


} 
else W.Exec (Procedure ("FilePrint")); 
W.Exec (Procedure ("FileClose") << 2); 


} 


Ре TPMT een eee > отт ae ee ea 
void _fastcall TForml::BFontClick(TObject *Sender) 


{ 
if (FontDialogl->Execute() ) 
Memol->Font->Assign (FontDialogl->Font) ; 
} 


Рассмотрим приведенный код. В приложение необходимо внести директиву 
препроцессора #include “ComObj.hpp”, подключающую файл ComObj.hpp, в кото- 
ром содержится объявление используемой далее процедуры CreateOleObject. Вво- 
дится переменная W типа Variant, которая будет являться ссылкой на объект сер- 
вера. Основная функция приложения Button1Click — обработчик щелчка на кноп- 
ке Выполнить. Ее первый выполняемый оператор 


И = CreateOleObject ("Мога.Ваз1с"); 


создает ссылку на объект, соответствующий Microsoft Word. При выполнении это- 
го оператора будет запущен Word, если он еще не был запущен к этому моменту. 
Последующие операторы используют метод Exec, который выполняет процедуру 
или функцию OLE. Как параметр в нее передается конструкция Procedure(S), где 
$ — имя вызываемой процедуры WordBasic. Если в процедуру требуется передать 
параметры, они передаются операций <<. Например, во вспомогательной функции 
Ins, заносящей текст в документ Word, вы можете видеть оператор: 


И. Ехес (Procedure ("Font") << Memol->Font->Name 
<< Memol->Font->Size) ; 


Этот оператор вызывает процедуру WordBasic Font, устанавливающую 

шрифт, и передает в нее два параметра: имя шрифта и его размер. 

~ Последовательность вызываемых процедур следующая. Сначала вызывается 
процедура AppShow, которая делает окно Word видимым, поскольку по умолча- 
нию запускаемое приложение работает в фоновом режиме. Следующий оператор 
вызывает процедуру FileNew, которая создает новый документ. Затем следуют 
операторы, формирующие текст документа с учетом установок шрифта. Эти опера- 
торы, содержащиеся во вспомогательной функции Ins, обращаются к процедурам 
Font, Bold, Italic, формирующим атрибуты шрифта, и к процедуре Insert, вклю- 
чающей текст в документ Word. 

После формирования текста следуют операторы, запрашивающие пользовате- 
ля о завершении операции (это дает ему возможность отказаться от печати или со- 
хранения файла, если он заметит в письме какие-то ошибки). Заключительные 
операторы завершают заданную операцию процедурами FileSaveAs или FilePrint 
и закрывают документ Word процедурой FileClose с параметром 2, означающим, 
что файл закрывается без запроса о необходимости его сохранения. 

Запустите приложение, и вы увидите, что научились управлять таким мощным 
инструментом, как Microsoft Word. Подробное описание других процедур вы смо- 
жете найти в справке Word в разделе WordBasic. Одно замечание — если Word от- 
крыт до запуска вашего приложения, то позаботьтесь о TOM, чтобы он не был развер- 
нут на весь экран. Иначе окно Word закроет ваше приложение. и его сообщения. 
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6.4.4 Компоненты — серверы СОМ в C++Builder 5 


6.4.4.1 Компоненты — серверы в C++Builder 5 


Взаимодействие с Word, Excel и многими другими распространенными. про- 
граммами, входящими в стандартную установку Word и Microsoft Office, может 
осуществляться из приложений C++Builder 5 с помощью компонентов, размещен- 
ных в библиотеке на странице Servers. Эти компоненты отображают множество им- 
портируемых серверов СОМ. Все они являются потомками своего базового класса 
TOleServer. В этом классе объявлены абстрактные методы и свойства, позволяю- 
щие устанавливать связь с сервером. Поэтому объекты класса TOleServerg нельзя 
создавать непосредственно. В приложениях используются только потомки этого 
класса — конкретные серверы СОМ. Они создаются импортом библиотек типов, 
осуществляемым в среде C++Builder командой Project | Import. 

Серверы COM — компоненты страницы Servers слабо документированы BO 
встроенной справке C++Builder. Хотелось бы хотя бы частично восполнить этот 
пробел. Но поскольку в рамках данной книги невозможно рассмотреть подробно 
все многочисленные серверы страницы Servers, ограничимся только серверами, 
обеспечивающими связь с Word. 

Откройте новое приложение, перенесите на форму компонент WordApplicati- 
оп и посмотрите в Инспекторе Объектов его свойства. Их очень немного. Кроме 
обычных для всех компонентов Name и Tag имеется всего 4 свойства (во многих 
компонентах — серверах их всего 3). 

Свойство AutoConnect определяет, должен ли сервер автоматически загру- 
жаться с началом. выполнения приложения. Если установить AutoConnect = true, 
то соединение с сервером произойдет в момент начала выполнения вашего прило- 
жения. Если же оставить значение AutoConnect = false, принятое по умолчанию, 
то соединение с сервером можно установить вызовом метода Connect. Например: 


WordApplicationl->Connect (); 


Впрочем, совершенно не обязательно устанавливать соединение свойством 
AutoConnect или методом Connect. Соединение автоматически устанавливается, 
когда выполняется вызов какого-то метода сервера или задается значение како- 
му-то его свойству. 

При использовании свойства AutoConnect надо иметь в виду, что установка в 
фгие влияет только при запуске приложения, т.е. если это свойство установлено во 
время проектирования. Задание AutoConnect = true во время выполнения прило- 
жения ни на что не влияет. 

Свойство ConnectKind определяет, как именно осуществляется соединение с 
сервером. Это свойство может принимать следующие значения: 


ckRunningOrNew Подсоединиться к выполняющемуся серверу или создать 
новый экземпляр сервера 


ckNewlInstance Всегда создавать новый экземпляр сервера 
ckRunningInstance Только подсоединиться к выполняющемуся серверу 


ckRemote Подсоединиться к удаленному серверу. Эта опция должна 
сочетаться с заданием свойства RemoteMachineName 


ckAttachToInterface He подсоединяться к серверу. Вместо этого приложение 
обеспечивает интерфейс методом ConnectTo (06 этом ме- 
тоде будет сказано позднее). Опция ckAttachToInterface 
не может использоваться совместно с установкой в true 
свойства AutoConnect 
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По умолчанию значение ConnectKind равно ckRunningOrNew. При этом если 
в момент соединения имеется выполняющийся сервер (применительно к WordAp- 
plication — если Word открыт), то приложение соединится именно с этим выпол- 
няющимся экземпляром сервера. Если же в этот момент соответствующий сервер 
не выполняется, то будет создан новый экземпляр сервера (в нашем случае дет 
осуществлен запуск Word). 

Если значение ConnectKind равно ckRunningOrNew, то приложение всегда 
создает новый экземпляр сервера. Если значение ConnectKind равно ckRunning- 
Instance, то приложение всегда соединяется с выполняющимся сервером. В этом 
случае, если выполняющегося сервера нет, будет сгенерировано исключение 
EOleSysError. Поэтому при ConnectKind = ckRunningInstance, если нет уверенно- 
сти, что в момент соединения на компьютере имеется выполняющийся сервер, со- 
единение надо осуществлять, например, так: 

try | 


{ 
WordApplicationl->Connect (); 


} 
catch (EOleSysErroré) 


{ 

Application->MessageBox ( 
"На компьютере нет выполняющегося в данный момент Word", 
"Приложение будет закрыто", 
MB ОК + МВ ICONEXCLAMATION) ; 

Application->Terminate(); 


} 


Приведенный код перехватывает исключение EQOleSysError и выдает пользо- 
вателю соответствующее сообщение. 

Значение ConnectKind = ckRemote используется, если надо связаться с уда- 
ленным сервером. В этом случае свойство RemoteMachineName должно указывать 
компьютер, на котором выполняется удаленный сервер. 

Таким образом, итог рассмотрения свойств, обеспечивающих подключение к 
серверу, можно подвести следующим образом: | 

Ш Если вам надо, чтобы ваше приложение работало с каким-то открытым доку- 
ментом сервера, выполняющимся в момент запуска приложения, следует за- 
дать ConnectKind = ckRunningInstance 


ш Если, наоборот, вам надо, чтобы ваше приложение не испортило случайно ка- 
кой-то документ в уже выполняющемся сервере, следует задать ConnectKind 
= ckNewlInstance 


Ш Если вам необходимо связаться с удаленным сервером, надо задать Connect- 
Kind = ckNewInstance и установить соответствующее значение RemoteMachi- 
пеМате 


Ш В остальных случаях, вероятно, целесообразно сохранять заданное по умолча- 
нию значение CkRunningOrNew 


Мы не рассмотрели пока значение ConnectKind равное ckAttachTolInterface. 
Для таких серверов, Kak WordApplication, оно не применимо. Его мы рассмотрим 
несколько позднее. 

После того, как вы установили соединение с сервером, он еще не становится 
видимым пользователю. Впрочем, приложение может работать с этим сервером, 
вызывать любые его методы, изменять или читать свойства, но сам сервер останет- 
ся для пользователю за кадром. Если это нежелательно, если требуется, чтобы 
пользователь видел, что происходит на сервере, или мог бы сам переключиться на 
сервер и что-то там сделать, то надо задать свойству Visible сервера значение true. 
Например: 


WordApplicationl->Visible = true; 
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Разрыв соединения с сервером осуществляется методом Disconnect. Кроме 
того у таких компонентов СОМ серверов, как WordApplication, имеется свойство 
AutoQuit. Если установить это свойство в true, TO при завершении приложения ав- 
томатически вызовется метод, завершающий сервер. Это свойство полезно уста- 
навливать в true, если вы работаете с новым экземпляром сервера, который созда- 
ло ваше приложение, и после завершения приложения не требуется, чтобы пользо- 
ватель мог продолжать работу с сервером. Тогда можно или установить AutoQuit в 
true, или при завершении приложения выполнить оператор вида: 


WordApplicationl->Disconnect(); 


Это особенно необходимо, если в процессе работы вашего приложения с серве- 
ром пользователь не сделал сервер видимым. Если вы не закроете соединение, то 
после завершения вашего приложения сервер будет по-прежнему невидим, не бу- 
дет отображен в полосе задач, но в действительности будет выполняться. И когда 
пользователь решит закрыть Windows, он неожиданно может увидеть какое-то со- 
общение вашего сервера — невидимки, например, запрос о сохранении файла. 


6.4.4.2 Свойства и методы сервера Word 


Теперь очень коротко посмотрим, что собой представляет сервер. Любой сер- 
вер СОМ — это объект, имеющий множество свойств, методов, и реагирующий на 
какие-то события. В этом отношении он ничем не отличается от любого объекта 
C++Builder. Многие из свойств сервера СОМ в свою очередь являются объектами 
со своими методами и свойствами. Описание сервера СОМ, как правило, можно 
найти в его встроенной справке. Например, чтобы разобраться в Word как в объек- 
те, надо посмотреть встроенную в него справку. Для этого следует выполнить в 
Word команду 2 | Вызов справки и в открывшейся справке на странице Содержание 
выбрать раздел Справка no Visual Basic (для версий, младше Word 97, раздел назван 
WordBasic Reference). Изложение в справке ведется на основе языка Visual Basic, 
а для младших версий Word — на подмножестве этого языка WordBasic. Конечно, 
рассмотреть в рамках данной книги даже основы описания Word как объекта не- 
возможно. Поэтому ниже изложены только некоторые начальные сведения, впро- 
чем, достаточные для разработки многих приложений, обращающихся к Word. 

Обращение к свойствам объекта WordApplication, инкапсулирующего объект 
Application (этот объект является самим выполняющимся экземпляром Word), 
производится так же, как к свойствам любого объекта C++Builder. Например, в 
Application имеется свойство Options — опции, являющееся в свою очередь объек- 
TOM со множеством свойств. Среди этих свойств есть CheckSpellingAsYouType и 
CheckGrammarAsYouType — булевы свойства, указывающие, должен ли Word ав- 
томатически проверять синтаксис и грамматику и отмечать в тексте ошибки. Та- 
кая проверка замедляет работу Word. Если вы хотите отключить в сервере эти ав- 
томатические проверки, введите в приложение операторы: | 


WordApplicationl->Options->CheckSpellingAsYouType = false; 
WordApplicationl->Options->CheckGrammarAsYouType = false; 


Тем самым вы отключите автоматические проверки, тем более, что в случае, 
если Word невидим и работает «за кадром», то эти проверки совершенно бессмыс- 
ленны. 

Среди множества свойств Application следует отметить свойство ActiveDocu- 
ment — активный документ. Это объект Document, некоторые свойства и методы 
которого будут описаны ниже. 

Практически всегда при работе с сервером Word вам приходится иметь дело со 
свойством Documents. Это свойство представляет собой собрание всех документов, 
открытых в Word в данный момент. Каждый документ представлен в этом собра- 
нии как объект Document, имеющий в свою очередь собствееные свойства и мето- 
ды. Общее число открытых документов определяется свойством Count собрания 
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документов Documents. Это свойство только для чтения часто приходится прове- 
рять, чтобы узнать, есть ли в Word хотя бы один открытый документ. Например, 
если в вашем приложении предусмотрены действия ASave, APrint и APreview, 
обеспечивающие сохранение, печать и предварительный просмотр документа, то 
их, очевидно, надо делать недоступными, если ни одного документа в Word нет. 
Это можно осуществить следующим кодом: 


if (WordApplicationl->Documents->Count == 0) 

{ 
ASave->Enabled = false; 
APreviéw->Enabled = false; 
APrint->Enabled = false; 

} 


Создание нового документа Document и включение его в Documents осуществ- 
ляется методом Add объекта Documents. В этот метод можно передать два аргу- 
мента: Template и NewTemplate. Аргумент Template указывает шаблон, который 
используется при создании документа. Если этот аргумент не указан, то документ 
создается на основе шаблона Обычный (Normal). Аргумент NewTemplate булева 
типа определяет, открывается ли документ как шаблон (при значении true), или 
как обычный документ. По умолчанию NewTemplate = false, т.е. отрывается 
обычный документ. 

При вызове из C++Builder любого метода сервера СОМ аргументы (кроме аргу- 
ментов типа Text) передаются только как объекты типа OleVariant. Если какие-то 
аргументы не являются обязательными, то все равно они должны фигурировать в 
вызове метода. Только вместо их значений может быть указана EmptyParam — пе- 
ременная типа OleVariant, используемая вместо необязательных параметров. Эта 
переменная объявлена в модуле System. 

Таким образом, если вы хотите создать новый документ на основе обычного 
шаблона, вы можете записать оператор: 


WordApplicationl->Documents->Add(EmptyParam, EmptyParam) ; 


Но если вы хотите создать документ на основе своего шаблона 
C:\MyTemplate\My.dot, то код будет сложнее: 


TVariant Template = "C:\\MyTemplate\\My.dot"; 
WordApplicationl->Documents->Add(&Template, EmptyParam) ; 


А если требуется создать документ как новый шаблон на основе обычного шаб- 
лона, то код будет таким: 


TVariant Template = true; 
WordApplicationl->Documents->Add (EmptyParam, &Template) ; 


При передаче булевых аргументов можно использовать значение 0 вместо false 
и целое ненулевое значение (например, 1) вместо true. Поэтому, в последнем вари- 
анте кода задание значения NewTemplate можно выполнить следующим оператором: 


TVariant Template = 1; 


Таким образом, при передаче булевых аргументов и свойств можно использо- 
вать две различные формы записи значения. 

Важным свойством сервера Word является свойство Selection, являющееся 
ссылкой на объект Selection — выделенный фрагмент текста в активном докумен- 
те или, если нет выделения, то просто текущая позиция курсора в активном доку- 
менте. Этот объект имеет методы InsertBefore и InsertAfter, аргументом в кото- 
рые передается текст, вставляемый в активный документ соответственно до или 
после объекта Selection. Например, код: 

WordApplicationl->Selection->InsertAfter (TVariant('\n')); 


WordApplicationl->Selection->InsertAfter ( 
TVariant ("Дорогой " + Editl->Text + "!\n")); 
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вставляет после Selection пустую строку, а затем вставляет строку с текстом «До- 
рогой ... !», где вместо многоточия фигурирует текст окна редактирования Edit1. 
Если выделения текста не было, то все это вставляется после текущей позиции 
курсора. В результате курсор перемещается на первую позицию после вставленно- 
го текста, а весь вставленный текст выделяется, т.е. включается в Selection. 

To, что введенный текст выделяется, можно использовать для его форматиро- 
вания. Форматирование объекта Selection осуществляется рядом его свойств, из 
которых остановимся только на двух: Font — шрифт и ParagraphFormat — фор- 
мат абзаца. Конечно, можно работать с ними через компонент WordApplication. 
Но гораздо удобнее делать это с помощью специальных серверов СОМ — компонен- 
тов WordFont и WordParagraphFormat. Это серверы соответственно шрифта и 
формата абзаца. Таких серверов объектов, входящих как свойство в другие объек- 
ты, на странице библиотеки Бегуегз много. Подключение их к соответствующему 
объекту удобнее осуществлять с помощью метода ConnectTo. Как аргумент этого 
метода указывается объект, с которым связывается компонент. Например, опера- 
торы 

WordFont1->ConnectTo (WordApplicationl->Selection->Font) ; 


WordParagraphFormatl->ConnectTo ( 
WordApplicationl->Selection->ParagraphFormat) ; 


подключают компоненты WordFontl и WordParagraphFormatl соответственно к 
шрифту и формату абзаца выделенного текста. После этого свойства и методы соот- 
ветствующих объектов можно вызывать через данные компоненты. 

Объект Font имеет, в частности, следующие свойства: Name — имя шрифта, 
Bold — жирный, Italic — курсив, Size — размер, StrikeThrough — перечеркну- 
тый, DoubleStrikeThrough — перечеркнутый двойной линией, Underline — под- 
черкнутый, Shadow — с тенью, Emboss — приподнытый, Engrave — утопленный, 
Hidden — невидимый, Subscript — нижний индекс, Superscript — верхний ин- 
декс. Свойство Underline может принимать следующие значения: wWdUnderlineNo- 
пе — отсутствие подчеркивания, wWdUnderlineSingle и wdUnderlineDouble — оди- 
нарное и двойное подчеркивание сплошной линией, wdUnderlineDash, wdUnder- 
lineDotDash, wdUnderlineDotDotDash, wdUnderlineThick, wdUnderlineDotted, 
wd Underline Words, wdUnderlineWavy — различные типы линии подчеркивания. 

Например, операторы 


WordFontl->Underline = wdUnderlineSingle; 
WordFontl->Bold = 1; 


обеспечивают в выделенном тексте (если WordFontl связан с выделением) жир- 
ный подчеркнутый шрифт. Последний оператор можно заменить на эквивалент- 
ный ему: 

WordFont1l->Bold = true; 


Из свойств объекта ParagraphFormat и компонента WordParagraphFormat 
отметим только одно: Alignment — выравнивание. Оно может принимать значе- 
ния wdAlignParagraphLeft — влево, wdAlignParagraphCenter — по центру, 
wdAlignParagraphRight — вправо, wdAlignParagraphJustify — по ширине. Ha- 
пример, оператор 


WordParagraphFormatl->Alignment = wdAlignParagraphCenter; 


выравнивает текст объекта (выделенного фрагмента, если WordParagraphFor- 
matl связан с ним) по центру. 

Выше рассматривалась вставка текста с помощью методов InsertBefore и 
InsertAfter. Имеется еще один метод вставки текста — ТуреТехф. В него так же, 
как и в методы InsertBefore и InsertAfter, передается один аргумент — текст. Вы- 
полнение метода TypeText зависит от значения свойства ReplaceSelection объекта 
Options. Если оно установлено в true, то все выделение заменяется текстом, пере- 
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данным как аргумент. Если ReplaceSelection = false, то новый текст вставляется 
перед выделением. По умолчанию ReplaceSelection = true.Takum образом опера- 
торы 


WordApplicationl->Options->ReplaceSelection = true; 
WordApplicationl->Selection->TypeText (TVariant ("новый текст")); 


приведут к TOMY, что выделенный текст заменится словами «новый текст». Пер- 
вый из приведенных операторов можно не писать, если есть уверенность, что зна- 
чение ReplaceSelection, равное true по умолчанию, не изменено какими-то преды- 
дущими операторами. 

Вставку в документ нового текста или изображения можно осуществлять так- 
же методом Paste, который копирует информацию из буфера обмена Clipboard. На- 
пример, операторы 


#include <Clipbrd.hpp> 


Clipboard()->Assign(Imagel->Picture) ; 
WordApplicationl->Selection->Paste() ; 


осуществляют копирование с помощью буфера обмена в текущую позицию Kypco- 
ра в документе изображения, хранящегося в компоненте Imagel. 

Выполнение метода Paste так же, как и метода TypeText, зависит от значения 
ReplaceSelection: копируемая из Clipboard информация может или заменять вы- 
деление, или вводиться перед ним. 

Метод СоПарзе свертывает выделение к его начальной или конечной точке, 
т.е. снимает выделение, перемещая курсор к его началу или концу. Аргумент 
Direction метода-СоПарзе определяет, куда перемещается курсор. При значении 
Direction = wdCollapseStart курсор перемещается к начальной точке, а при 
Direction = wdCollapseEnd — к конечной. По умолчанию Direction = wdCollapse- 
Start. Таким образом, операторы 


TVariant Direction = wdCollapseEnd; 
WordApplicationl->Selection->Collapse (&Direction) ; 


уберут выделение и переместят курсор в позицию, следующую за бывшим выделе- 
нием. 

Теперь остановимся на объекте Document — документ, о котором уже говори- 
лось ранее. С этим объектом удобно работать с помощью специального сервера 
СОМ — компонента WordDocument. Это сервер документа, т.е. объекта, содержа- 
щегося в объекте WordApplication. Ou, как и описанные ранее компоненты 
УогаЕоп{1 и WordParagraphFormatl, подключается к соответствующему объек- 
ту с помощью метода ConnectTo. Например, оператор 


WordDocument1->ConnectTo (WordApplicationl->ActiveDocument) ; 


подключает компонент WordDocumentl к активному документу, открытому в 
Word и указанному свойством ActiveDocument, о котором уже говорилось ранее. 

Текст в документе, с которым связывается WordDocument, разбивается в 
свою очередь на объекты Range. Каждый такой объект соответствует некоторому 
непрерывному фрагменту текста. Объект Range может создаваться специальным 
методом Капре, в котором в качестве начала и конца указываются определенные 
позиции символов или параграфы. Оператор возвращает указатель на созданный 
объект. Например, операторы 

TVariant а = 0, b = 10; 

RangePtr MyRange = WordDocument1->Range (&a, &b) ; 


создают объект MyRange, включающий первые 10 символов документа. 
Свойства и методы объектов Range в основном совпадают со свойствами и ме- 

тодами объекта выделения Selection, которые мы уже рассматривали. К Range 

можно применять методы InsertBefore, InsertAfter, TypeText, Paste, Collapse. 
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Объекты Range имеют те же свойства Font и ParagraphFormat, что и Selection. 
Таким образом, оператор 


MyRange->Font->Bold = true; 


форматирует жирным шрифтом фрагмент текста, заключенный в объекте MyRan- 
‚ 5е. Если MyRange был создан приведенными выше операторами, то форматирова- 
нию подвергаются первые 10 символов. 

Объект документа Document имеет свойство Content, которое является объек- 
том, отражающим весь текст. Это тоже объект типа Range со всеми соответствую- 
щими свойствами и методами. Поэтому оператор 


WordDocumentl->Content->Font->Bold = 1; 


обеспечит форматирование всего компонента жирным шрифтом, a оператор 
WordDocument1->Content->InsertBefore (TVariant ("ЗАГОЛОВОК\п")); 


вставит перед началом текста строку «ЗАГОЛОВОК». 

В заключение остановимся коротко еще на одном свойстве сервера Word — 
Dialogs. Это собрание объектов Dialog, которые соответствуют встроенным диало- 
ram Word. Доступ к конкретному диалогу осуществляется через выражение вида 


WordApplicationl->Dialogs->Item(WdWordDialog) 
где константа WdWordDialog может принимать одно из предопределенных значе- 


ний. В приведенной ниже таблице даются некоторые из этих значений и описание 
диалогов, которым они соответствуют. 


а о О В Е а о рва 


wdDialogEditFind Найти фрагмент текста 
wdDialogEditPasteSpecial Специальная вставка из буфера обмена 
wdDialogEditReplace Заменить фрагмент текста 
wdDialogFileFind Найти файл 

wdDialogFileNew Новый файл 

wdDialogFileOpen Открыть файл 
wdDialogFilePageSetup Параметры страницы 
wdDialogFilePrint Печать файла 
wdDialogFilePrintSetup Установить принтер 
wdDialogFileSaveAs Сохранить файл как 
wdDialogFileSummaryInfo Свойства документа (Статистика) 
wdDialogFormatFont Шрифт 
wdDialogFormatParagraph Абзац 

wdDialogInsertDatabase Вставить базу данных 
wdDialogInsertFile Вставить файл 
wdDialogInsertPageNumbers Вставить номера страниц 


Из методов, которые имеют объекты Dialog, остановимся только на одном — 
методе Show. Он открывает пользователю соответствующее диалоговое окно и вы- 
полняет те команды, которые указал в нем пользователь. 

В этот метод передается один не обязательный аргумент TimeOut — время в 
миллисекундах, после которого диалог автоматически закроется. Если в качестве 
TimeOut передать EmptyParam, то диалог закрывается только пользователем. 
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Например, в коде: 


WordApplicationl->Visible = true; 
//Открытие файла 
if (WordApplicationl->Dialogs~->Item ( 
wdDialogFileOpen) ->Show(EmptyParam) == -1) 


//Сохранение файла активного документа 
WordApplicationl->Dialogs->Item(wdDialogFileSaveAs) ->Show (EmptyParam) ; 


//Печать файла активного документа 
WordApplicationl->Dialogs->Item(wdDialogFilePrint) ->Show (EmptyParam) ; 


первый оператор делает сервер видимым. Последующие операторы вызывают диа- 
лог открытия файла, диалог сохранения файла активного документа и диалог пе- 
чати активного документа. Поясним назначение первого оператора приведенного 
кода. Если в момент вызова диалога сервер был невидимый, то после выполнения 
диалога открытия файла окно Word станет видимым, но в очень урезанном виде — 
без главного меню и инструментальных панелей. Поэтому, если нет уверенности, 
что окно Word было видимо перед вызовом диалога, лучше поместить перед опера- 
торами вызова диалога оператор, обеспечивающий видимость сервера. 

Вызов диалога методом Show возвращает целое значение, позволяющее опре- 
делить, какой кнопкой пользователь закрыл диалог: 


SESE ELE BAERS LO BO LO RT О о В В а 


-2 Кнопкой Закрыть 

-1 Кнопкой ОК 

0 Кнопкой Отмена или клавишей Esc 

>0 Одной из командных кнопок: 1 — первой, 2 — второй и т.д. 


Впрочем, это общее правило, оговоренное в документации, действует не для 
всех диалогов. Например, в диалоге открытия файла нажатие кнопки Отмена, сис- 
темной кнопки Закрыть или клавиши Esc возвращает 0, а нажатие кнопки Открыть 
(т.е. командной кнопки) возвращает -1. Так что лучше для используемого вами 
диалога установить экспериментальным путем значения, возвращаемые методом 
Show при тех или иных действиях пользователя. 

Возвращенное значение можно использовать для какой-то реакции приложе- 
ния на действия пользователя. Например: 

if (WordApplication1l->Dialogs->Item(wdDialogFileOpen) -> 

Show(EmptyParam) != -1) 
Application->MessageBox("BrI не открыли файл", 


"Надо обязательно открыть один из файлов", 
MB OK + МВ ICONEXCLAMATION) ; 


Многие функции, выполняемые диалогами, могут вызываться как методы до- 
кумента Document, если от пользователя не требуется активных действий. Coxpa- | 
нение активного документа в файле с заданным именем можно осуществить мето- 
дом SaveAs, передавая в него как аргумент типа OleVariant имя файла с путем к 
нему. Если путь отсутствует, то файл сохраняется в текущем каталоге. Вызов ме- 
тода SaveAs можно оформить следующим образом: 


TVariant FileName = "My.doc"; 
Wordbocument sn о Базеля (eri hename) i 


В данном примере файл документа, с которым связан компонент WordDocu- 
mentl, сохраняется в текущем каталоге с именем «My.doc». Причем WordDocu- 
mentl может быть подключен не обязательно к активному документу. 


14 Зак. 322 
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Печать документа без отображения диалога печати может осуществляться ме- 
тодом PrintOut: 


WordDocument1->PrintOut (); 


_ Предварительный просмотр документа перед печатью осуществляется мето- 
дом PrintPreview: 


WordDocument1->PrintPreview(); 


Мы рассмотрели только малую часть свойств методов и объектов сервера 
Word, реализованную в компонентах WordApplication, WordDocument, Word- 
Font и WordParagraphFormat. Упомянем только еще один компонент из того же 
семейства — WordLetterContent. Это объект письма, обеспечивающий работу с 
шаблонами писем. 


6.4.4.3 Тестовый пример работы с сервером Word 


Давайте проверим все, рассказанное в предыдущих разделах, на сравнительно 
простом примере. Пусть мы хотим построить приложение, напоминающее рас- 
смотренное ранее в разделе 6.4.3. Приложение предназначено для составления се- 
рии каких-то писем в формате Word. Введем в приложение возможность управ- 
лять шрифтом и выравниванием текста, а также добавим в формируемый доку- 
мент какой-нибудь рисунок. Все это делается просто, чтобы проверить изложен- 
ные выше возможности управления документом Word. Конечно, то же самое мож- 
но было бы сделать и в самом Word. Но если вам надо брать данные для писем, на- 
пример, из какой-то базы данных, то просто одной программой Word обойтись 
было бы трудно. Позднее в главе 11 в разделе 11.3 будет приведен пример такой ра- 
боты с сервером Word и базой данных. 

Наше тестовое приложение может иметь вид, представленный на рис. 6.9. Со- 
ответствующее приложение имеется на прилагаемом к книге диске. Кнопка В доку- 
мент (ее имя в приведенном ниже тексте приложения BInDoc) заносит в активный 
документ Word текст, пример которого приведен на рис. 6.10. Имя адресата берет- 
ся из окна редактирования Editl, текст письма — из окна Memol, а рисунок за- 
ставки — из компонента Imagel. Форматирование вводимого текста осуществля- 
ется группами радиокнопок Шрифт (ее имя RGFont) и Выравнивание (ее имя 
RGAlighn). | 

Кнопка Новый открывает на сервере новый документ. Кнопка Открыть вызыва- 
ет стандартный диалог Word открытия файла. Кнопка Просмотр вызывает стан- 
дартный диалог Word предварительно просмотра документа перед печатью. Кноп- 
ка Печать вызывает стандартный диалог печати, а кнопка Сохранить — стандарт- 


Рис. 6.9 
Работа с сервером Word 


‚ как работника, но В: 


с сожалением должна сообщить, | о 
что через два месяца Вы и 


‚ [Наша фирма очень ценит Вас [Иван Иванович г 


_ |будете уволены. 
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ный диалог сохранения документа в файле. Кнопка Word делает видимым для 
пользователя сервер — окно программы Word. 


Рис. 6.10 

Пример документа, 
подготовленного приложением 
в сервере Word 


Уважаемый Иван Иванович ! 


Наша фирма очень ценит Вас 
как работника, но 
с сожалением должна сообщить, 
что через два месяца Вы 
будете уволены. 


С уважением 


Для того, чтобы все это работало, на форме кроме видимых на рис. 6.9 элемен- 
тов размещены компоненты WordApplication, WordDocument, WordFont и Word- 
ParagraphFormat. Все свойства этих компонентов равны значениям по умолчанию. 

Ниже приводится текст этого приложения. 

Заголовочный файл: 


class TForml : public TForm 

{ 

_ published: // IDE-managed Components 
ТТмаде *Imagel; 


private: // User declarations 
void _fastcall Connect (void); 


}; 


Файл реализации: 


#include <Clipbrd.hpp> 
void _fastcall TForml: :Connect (void) 
{ 
//Проверка наличия открытого документа 
if (WordApplicationl->Documents->Count == 0) 
{ 
Application->MessageBox("B Word нет открытого документа", 
"Команда не выполнена", 
MB OK + МВ ТСОМЕХСЬАМАТТОМ); 
Abort (); 
} ‘ 
//Соединение WordDocumentl с активным документом 
WordDocument1->ConnectTo (WordApplicationl->ActiveDocument) ; 
//Делаются доступными кнопки работы с документом 
BInDoc->Enabled = true; 
BPreview->Enabled = true; 
BPrint->Enabled = true; 
BSave->Enabled = true; 
} 
Or____——_ 
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void _fastcall TForml::BNewClick(TObject *Sender) 

{ 

//Создание в Word нового документа 
WordApplicationl->Documents->Add (EmptyParam, EmptyParam) ; 
Connect (); 

} 

и po eel 

void _ fastcall TForml::BOpenClick(TObject *Sender) 
{ 

//Открытие файла 
WordApplicationl->Visible = true; 
if (WordApplication1l->Dialogs->Item ( 

wdDialogFileOpen) - ->Show (Empt yParam) == -1) 
Connect (); 

} | 

и ВН eee meee ee nae 

void _fastcall TForml::BPreviewClick(TObject *Sender) 
{ 

//Предварительный просмотр 
Connect (); 

WordDocument1->PrintPreview(); 
WordApplicationl->Visible = true; 

} 

OL 

void _fastcall TForml::BPrintClick(TObject *Sender) 
{ 7 
//Печать 
Connect (); 

WordApplicationl->Visible = true; 
WordApplication1l->Dialogs->Item(wdDialogFilePrint) ->Show (EmptyParam) ; 

} 

Sida © ree ene ena ek a ees 

void ___fastcall TForml::BWordClick(TObject *Sender) 
{ 

//Word делается видимым 
WordApplicationl->Visible = true; 

} 

"0 orca tae a ne een 

void _fastcall TForml::BSaveClick(TObject *Sender) 
{ 

//Диалог открытия файла 
Connect (); 

WordApplicationl->Dialogs->Item ( 
wdDialogFileSaveAs) ->Show(EmptyParam) ; 

} 

Ё—————— 
void _fastcall TForml::BInDocClick(TObject *Sender) 
{ 

//Занесение в документ информации 
//Направление сворачивания выделения 
TVariant Direction = wdCollapseEnd; 

//Пустая строка 
TVariant зпем = "\п"; 

Connect (); 

//Пересылка в документ изображения из Imagel 
WordApplicationl->Selection->InsertAfter (snew) ; 
Clipboard()->Assign (Imagel->Picture) ; 
WordApplicationl->Selection->Paste(); 
WordApplicationl->Selection->InsertAfter (snew) ; 
//Снятие выделения 
WordApplicationl->Selection->Collapse (&Direction) ; 
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//Включение в документ текста заголовка 

WordApplicationl->Selection->InsertAfter (snew) ; 

WordApplication1l->Selection->InsertAfter ( 
TVariant (" [>ВЕВОХЕО " + Editl->Text +" !\n")); 

//Установка жирного курсива и выравнивание по центру 

WordFont1->ConnectTo (WordApplicationl->Selection->Font) ; 

WordFont1l->Bold = 1; 

WordFontl->Italic = 1; 

WordParagraphFormat1->ConnectTo ( 
WordApplicationl->Selection->ParagraphFormat) ; 

WordParagraphFormatl->Alignment = wdAlignParagraphCenter; 

//Снятие выделения 

WordApplicationl->Selection->Collapse (&Direction) ; 


//Включение в документ основного текста 
WordApplicationl->Selection->InsertAfter (snew) ; 
WordApplicationl->Selection->InsertAfter (TVariant (Memol->Text) ); 
WordApplicationl->Selection->InsertAfter (snew) ; 

//Установка шрифта и выравнивание основного текста 
WordFont1->ConnectTo (WordApplicationl->Selection->Font) ; 
WordParagraphFormat1->ConnectTo ( 

WordApplicationl->Selection->ParagraphFormat) ; 
if (RGFont->ItemIndex > 1) 
WordFont1l->Bold = 1; 
else WordFont1->Bold = 0; 
if (RGFont->ItemiIndex % 2 == 1) 
WordFontl->Italic = 1; 
else WordFont1l->Italic = 0; 


switch (RGAlighn->ItemIndex) 
{ 


4 


case 0: WordParagraphFormati->Alignment = wdAlignParagraphLeft; 


break; 

case 1: WordParagraphFormat1l->Alignment = wdAlignParagraphRight; 
break; 

case 2: WordParagraphFormatl->Alignment = wdAlignParagraphCenter; 
break; 


case 3: WordParagraphFormat1l->Alignment 
} 
//Снятие выделения 
WordApplicationl->Selection->Collapse (&Direction) ; 


wdAlignParagraphJustify; 


//Включение в документ текста заключительной строки 
WordApplicationl->Selection->InsertAfter ( 
TVariant ("У \>BFDRPDX\n\n") ); 

//Установка жирного курсива и выравнивание по центру 
WordFontl->ConnectTo (WordApplicationl->Selection->Font) ; 
WordFont1->Bold = 1; 
WordFontl->Italic = 1; 
ИогаРагадгарпГогма* 1->СоппесЕТо ( 

WordApplicationl->Selection->ParagraphFormat) ; 
WordParagraphFormatl->Alignment = wdAlignParagraphCenter; 
WordApplicationl->Selection->Collapse (&Direction) ; 
} 


Код содержит, Ha мой взгляд, достаточно подробные комментарии. Tak что ог- 
раничимся краткими дополнительными пояснениями. В класс добавлена функция 
Connect. Это вспомогательная функция, вызываемая во многих местах програм- 
мы. Она проверяет наличие на сервере открытого документа Word и, если имеется 
открытый документ, то с ним соединяется компонент WordDocumentl. Правда, в 
данном приложении компонент WordDocument используется только в процедуре 
BPreviewClick для предварительного просмотра документа. 
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Основная функция кода — BInDocClick, обеспечивающая передачу информа- 
ции в активный документ. Поскольку внутри этой функции изображение, переда- 
ваемое в документ, заносится в буфер обмена Clipboard, необходимо инструкцией 
#Hinclude <Clipbrd.hpp> подключить модуль Clipbrd.hpp, объявляющий функцию 
Clipboard. 

В начале функции BInDocClick производится обращение к функции Connect. 
Если вызов Connect прошел успешно, до далее следует занесение в документ через 
буфер обмена изображения, хранящегося в Imagel. После этого методом Collapse 
снимается выделение и в документ заносится требуемый текст из окна Memol с 
предварительной строкой обращения, в которой используется текст окна Editl. 
Весь этот текст оказывается выделенным. К этому выделению подключаются ком- 
поненты УогаЕоп{1 и WordParagraphFormatl1, через свойства которых осуществ- 
ляется форматирование выделенного текста жирным курсивом и выравниванием 
по центру. Затем выделение снимается, заносится основной текст документа из 
компонента Memol и он форматируется в соответствии с установками пользовате- 
ля. После этого выделение с основного текста снимается, заносится заключитель- 
ная строка и она форматируется жирным курсивом и выравниванием по центру. 

Остальные функции приведенного кода вряд ли нуждаются в дополнительных 
комментариях. Постройте это приложение (или возьмите его с ‘прилагаемого к 
книге диска) и проверьте в работе. Можете расширить его возможности, чтобы по- 
пробовать большинство свойств и методов, рассмотренных в данном разделе. 


6.5 Динамический обмен данными — DDE 
6.5.1 Общие сведения 


Динамический обмен данными (Dinamical Data Exchange — DDE) — это техно- 
логия, появившаяся в Windows ранее описанного выше OLE, но сохраняющая свое 
значение и до сих пор, поскольку предоставляет удобный способ обмена данными 
между программами. В этом диалоге программ одна, инициирующая диалог, на- 
зывается клиентом, а другая, отвечающая на сообщения клиента — сервером. 
Диалог ведется на заданную тему (topic). Данные, передаваемые от одной про- 
граммы к другой, называются элементами данных (Цетз). В диалоге могут также 
передаваться серверу некоторые команды — макросы (тасгоз). Этих основных по- 
нятий: клиент, сервер, тема, элемент данных и макрос достаточно, чтобы строить 
приложения, основанные на DDE. Всю сложную задачу обработки в процессе диа- 
лога множества сообщений Windows берет на себя C++Builder, инкапсулируя все 
необходимые процедуры в четырех компонентах, расположенных в библиотеке на 
странице System: DdeClientConv, DdeClientItem, DdeServerConv и DdeServerlItem. 
Первые два из них организуют работу клиента, a два вторые — работу сервера. 

Основным компонентом, организующим взаимодействие, является компонент 
клиента DdeClientConv. Соответствующий ему компонент сервера DdeServerConv 
играет пассивную роль, сообщая только тему, которую может поддерживать сер- 
вер. Компоненты DdeClientItem и ОдеЗегуегЦет нужны только для обмена ин- 
формацией о конкретных элементах данных. 

Взаимодействие DDE может выполнять следующие операции: 


Передача клиенту данных от сервера по инициативе клиента 
Передача клиенту данных от сервера при их обновлении 
Передача данных от клиента к серверу 

Передача команд (макросов) от клиента к серверу 

Установка клиентом данных на сервере 


В последующих разделах будут рассмотрены способы решения каждой из этих 
задач. 
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6.5.2 Установление контакта с сервером 


Начнем рассмотрение с компонента DdeServerConv, который располагается 
на форме приложения-сервера. Его единственное свойство — имя Name. Это имя 
является именем темы. Его должен знать клиент при установлении контакта с сер- 
вером. Некоторые методы компонента DdeServerConv мы рассмотрим позднее в 
следующем разделе, а теперь обратимся к компоненту DdeClientConyv, который 
располагается на форме приложения-клиента и обеспечивает установление и раз- 
рыв контакта с сервером. 

Два свойства компонента DdeClientConv — DdeService и DdeTopic определя- 
ют имена сервера и темы, соответствующих намеченному контакту. Имя сервера 
— это имя приложения-сервера, а имя темы — имя одного из компонентов 
DdeServerConv, расположенных на сервере. В процессе проектирования эти свой- 
ства задавать не обязательно, поскольку они могут быть установлены во время вы- 
полнения методом SetLink. Этот метод описан следующим образом: 


bool SetLink(const System::AnsiString Service, 
const System::AnsiString Topic); 


Параметры метода Service и Topic устанавливают соответственно значения 
свойств DdeService и DdeTopic. Установить значения этих свойств во время вы- 
полнения прямым присваиванием невозможно. 

Способ установления контакта с сервером во время выполнения зависит от 
значения свойства Соппес{ Моде, определяющего режим соединения. Это свойство 
может иметь значение ddeManual — ручной или ddeAutomatic — автоматиче- 
ский. При автоматическом режиме SetLink не только задает значения DdeService 
и DdeTopic, но и устанавливает сам контакт. При ручном режиме метод SetLink 
после установки значений DdeService и DdeTopic очищает элементы от прошлой 
информации, но самого соединения не устанавливает. Контакт с сервером в этом 
случае должен устанавливаться методом OpenLink, не имеющим параметров. 

Если сервер в момент попытки установить контакт запущен, то контакт уста- 
навливается описанными выше методами. Если это не удается, то делается попыт- 
ка запустить программу, путь и имя которой указаны в свойстве ServiceApplicati- 
оп. Если в этом свойстве ничего не указано или запуск не удался, то метод 
OpenLink возвращает false. 

Закрыть контакт с сервером можно методом CloseLink. Этот метод разрывает 
связь с сервером и очищает значения свойств DdeService и DdeTopic. 

Исходя из сказанного выше, наиболее простой способ установления связи ва- 
шего приложения с сервером (если приложение будет обмениваться информацией 
только с одним сервером) заключается в следующем. Во время проектирования 
надо установить требуемые значения свойств DdeService и DdeTopic, а затем за- 
дать свойство Соппес {Моде = ddeAutomatic. Если сервер в данный момент запу- 
щен или он доступен, то с сервером установится связь. Доступность в данном слу- 
чае означает, что выполняемый файл сервера находится в том же каталоге, в кото- 
ром находится ваше приложение, или в свойстве ServiceApplication указан вы- 
полняемый файл сервера с полным путем к нему и с указанием типа файла (расши- 
рения). В этом случае свойство ConnectMode сможет установиться в ddeAutoma- 
tic. В противном случае вам будет выдано предупреждение о невозможности KOH- 
такта. 

Если все прошло нормально, то в дальнейшем при выполнении приложения 
связь с сервером будет устанавливаться автоматически. Если в момент запуска 
приложения сервер уже запущен, контакт установится сразу. Если же сервер не 
запущен к моменту запуска вашего приложения, но его выполняемый файл досту- 
пен для приложения (в указанном выше смысле), то сервер автоматически запус- 
тится и с ним будет установлен контакт. В обоих случаях вам не надо будет забо- 
титься о контакте, т.е. не надо будет применять методы Зе лик или OpenLink. 
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Если указанные выше условия не выполнены, т.е. сервер не запущен ни зара- 
нее, ни в момент запуска вашего приложения, то даже, если он потом будет запу- 
щен, перед установлением контакта с ним вам потребуется применить метод 
Зе лик. Дело в том, что в этих условиях установленные при проектировании зна- 
чения свойств DdeService и DdeTopic стираются, а повторно установить их можно 
только методом SetLink. То же самое надо иметь в виду, если вы в своем приложе- 
нии закрыли соединение с сервером методом CloseLink или установили связь с 
другим сервером. После этого контакт прервется и его надо восстанавливать мето- 
дом SetLink. 

Если свойство ConnectMode компонента установлено в ddeManual, но в про- 
цессе проектирования вы установили свойства DdeService и DdeTopic, то для уста- 
новления контакта вам достаточно выполнить метод OpenLink. Если же 
DdeService и DdeTopic не установлены или в процессе работы приложения вы XO- 
тите переключаться на связь с другими серверами, то прежде, чем начать работать 
с сервером, надо выполнить метод SetLink, устанавливающий имена сервера и 
темы. Если при этом ConnectMode = ddeAutomatic, то автоматически устанавли- 
вается контакт с сервером. Если же Соппе {Моде = ddeManual, то для установле- 
ния контакта после SetLink надо применить метод OpenLink. 

Таким образом правила установления контакта с сервером доступным или уже за- 
пущенным к момент запуска приложения можно представить следующей таблицей. 


|ddeAutomatic |Установлены при проектировании ___ |Автоматический _ 
и Не установлены при проектировании, или 

изменены, или контакт был прерван | 
ddeManual — |Установлены при проектировании _______ OpenLink —_— 


Не установлены при проектировании, или Зе лик 
изменены, или контакт был прерван OpenLink 


| 
| 


| 
| 
| 


Приведем несколько примеров. Пусть ваше приложение будет обмениваться 
информацией только с одним заранее известным сервером и путь вы хотите в при- 
ложении иметь кнопку (назовем ee BExchange), при щелчке на которой вы хотите 
выполнить какие-то операторы обмена данными с сервером. Вы должны размес- 
тить на своем приложении компонент DdeClientConv (назовем ero DdeClient- 
Сопу1) и эту кнопку. 

Далее наиболее простой путь заключается в следующем. Вы устанавливаете в 
DdeClientConvl требуемые значения свойств DdeService и DdeTopic, а затем за- 
даете свойство Соппес Моде равным ddeAutomatic. Тогда в обработчике события 
OnClick кнопки BExchange вам достаточно просто написать операторы обмена дан- 
ными с сервером. 

Если по каким-то причинам во время проектирования сервер вам не доступен, 
то, задав при проектировании требуемые значения свойств DdeService и DdeTopic, 
вы оставляете свойство Соппес Моде, равным ddeManual. В этом случае, напри- 
мер, в обработчике события формы OnCreate вы можете поместить оператор 

if (! DdeClientConvl->OpenLink () ) 

ShowMessage ("Нет контакта с сервером '" + 


DdeClientConvl->DdeService + 
"' по теме '" + DdeClientConvl->DdeTopic + "'"); 


Этот оператор обеспечит контакт с сервером в момент запуска приложения 
или соответствующее сообщение об ошибке. Другой путь — поместить в обработ- 
чик события OnClick кнопки BExchange операторы 
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DdeClientConvl->SetLink(sServer, sTopic); 
if ( ! DdeClientConvl->OpenLink() ) 
ShowMessage ("Нет контакта с сервером "'" + 
DdeClientConvl->DdeService + 
"' по теме '" + DdeClientConvl->DdeTopic + "'"); 
< операторы обмена данными с сервером > 


‚ 


В этих операторах предполагается, что параметры SServer и sTopic содержат 
соответственно имя сервера и имя темы. Отметим, что в этом случае нельзя огра- 
ничиться только вторым оператором OpenLink. Дело в том, что в первый раз OH 
сработает нормально. Но при последующих щелчках на кнопке BExchange он бу- 
дет выдавать ошибки, поскольку метод OpenLink возвращает false не только в слу- 
чае невозможности связаться с сервером, но и в случаях, когда контакт в данный 
момент уже установлен. Впрочем, это относится только к возвращаемой величине. 
Если сообщения об ошибках вас не интересуют, то вы можете существенно сокра- 
тить приведенный код: 


DdeClientConvl->OpenLink () ; 
< операторы обмена данными с сервером > 


Аналогичное приведенному ранее последовательное обращение к методам 
SetLink и OpenLink надо применять и в приложениях, работающих с нескольки- 
ми разными серверами с помощью одного компонента DdeClientConv. Такое же 06- 
ращение используется и в случае, если вы не устанавливали в процессе проектиро- 
вания свойства DdeService и DdeTopic. 

Все сказанное ранее относилось к установлению контакта с определенным сер- 
вером по определенной теме. Но имеется еще одна возможность — установление 
контакта с заранее неизвестным сервером, который поместил информацию о себе в 
буфер обмена Clipboard. Приложение-сервер, разработанное с помощью 
C++Builder, может сделать это методом CopyToClipboard компонента DdeServer- 
Item (06 этом методе и компоненте будет подробнее рассказано в следующем разде- 
ле). Чтобы установить контакт со стороны клиента с сервером, поместившим ин- 
формацию в буфер обмена, надо выполнить метод PasteLink компонента Dde- 
ClientConv. Например: 

if ( ! DdeClientConv1->PasteLink () ) 


ShowMessage ( 
"В буфере обмена не обнаружено данных, доступных обработке."); 


Если в буфере обмена есть соответствующие данные, то метод PasteLink зане- 
сет имена сервера и темы в свойства DdeService и DdeTopic и установит контакт с 
этим сервером. Таким образом, этот метод заменяет рассмотренные ранее методы 
SetLink и OpenLink, устанавливая контакт с заранее неизвестным сервером. 


6.5.3 Обмен данными между клиентом и сервером 


6.5.3.1 Построение приложения-сервера 


Теперь перейдем к рассмотрению обмена данными между клиентом и серве- 
ром. Данные, содержащиеся на сервере, которые могут быть переданы клиентам, 
обеспечивает компонент DdeServerltem. Основные свойства этого компонента — 
Lines — набор строк, представляющий собой передаваемую информацию, и 
ServerConv — имя компонента Оде$егуегСопу, т.е. имя темы, к которой относит- 
ся данная информация. Если свойство ЗегуегСопу не установлено, то считается, 
что имя темы — заголовок (Caption) формы приложения-сервера. 

Свойство Text компонента Оде5егуегЦет автоматически устанавливается 
равным первой строке свойства Lines. Ноесли вы устанавливаете свойство Text He- 
посредственно, это значение заносится в первую строку Lines, а остальные строки 
очищаются. 
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Компонент DdeServerItem имеет метод CopyToClipboard. При выполнении 


этого метода в буфер обмена Clipboard заносится содержимое хранимой в компо- 
ненте информации в специальном формате, который содержит информацию о кон- 
такте: имена сервера и темы. 


Прежде, чем переходить к вопросу о передаче информации из сервера к клиен- 


ту, давайте построим простые серверы, чтобы мы могли проводить с ними экспери- 
менты. Откройте новое приложение и выполните следующие операции: 


A. 


2. 


ром 


Перенесите на форму компонент DdeServerConv и установите его имя Мате 
равным Topicl. Это будет названием первой темы. 


Перенесите на форму компонент DdeServerltem и установите его имя Name 
равным Itemsl, а свойство ServerConv равным Topicl. Этот компонент будет 
хранить содержание первой темы. В свойстве Strings задайте какой-нибудь 
текст, например: 


строка 1 темы Topicl сервера Server 
строка 2 темы Topicl сервера Server 


Этот текст впоследствии на стороне клиента позволит понять, с каким серве- 
и по какой теме установлен контакт. 


Перенесите на форму компонент Edit с именем Editl и задайте его свойство 
Text равным тексту первой строки свойства DdeServerltem->Strings. Этот 
компонент в дальнейшем потребуется для того, чтобы видеть, как можно на- 
блюдать со стороны клиента изменения информации на сервере. Для этого в 
обработчик события OnChange компонента Editl вставьте оператор 


Itemsl->Text = Editl->Text; 
переносящий текст из окна редактирования в компонент Цетз$1. 


Повторите пункты 1 и 2, перенеся на форму еще одну пару компонентов Dde- 
ServerConv и DdeServerltem с именами Topic2 и Items2. Они будут отражать 
вторую тему сервера. Текст темы можете сделать тем же, что и в компоненте 
Itemsl, заменив в нем слова «Topicl» на «Тор!с2». 


Добавьте на форму кнопку Button, в обработчик щелчка на которой вставьте 
оператор 
Items1->CopyToClipboard(); 


Эта кнопка будет заносить содержание темы в буфер обмена Clipboard. 
На этом проектирование сервера закончено. Его форма может иметь вид, пред- 


ставленный на рис. 6.11. 


6. 


1. 


Рис. 


Форма приложения-сервера DDE 


Сохраните проект, присвоив ему имя Server. Скомпилируйте проект, чтобы 
создать выполняемый модуль, и проверьте, что все в порядке. 


Сохраните это проект еще один раз под именем Serverl. Таким образом, у вас 
будет два сервера с разными именами, чтобы можно было проверить связь 
клиента с разными серверами. Замените в текстах компонентов Itemsl и 
Items2 этого сервера слова «Server» на «Serverl». Создайте выполняемый мо- 
дуль второго сервера. 


6.11 


[строка 1 темы Topicl сервера Server 
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6.5.3.2 Построение приложения-клиента 


Теперь рассмотрим приложение-клиент. Общий вид предлагаемого тестового 


приложения-клиента приведен на рис. 6.12. Но, разместив сразу все его компонен- 
ты, код для них мы будем писать постепенно, осваивая различные способы связи с 
сервером. 


Рис. 6.12 
Приложение-клиент DDE 


„]строка 1 темы Topicl сервера Server 
- |строка 2 темы Topic] сервера Server 


| Контакт . _ PokeData: | | 


|строка 1 темы Topicl сервера Server 


Макрос 


`|Макрос 1 Выполнить | | 


Итак, начнем с разработки формы клиента. 


Перенесите на форму компонент DdeClientConv и установите его свойство 
Соппес{ Моде равным ddeManual, поскольку мы будем связываться с разными 
серверами. 


Перенесите на форму компонент DdeClientItem и установите его свойство Dde- 
Conv равным DdeClientConvl. 


Перенесите Ha форму два компонента ComboBox. Первый из них, предназна- 
ченный для выбора сервера, назовите CBServer. В его свойство Items занесите 
список серверов: «Server» и «Serverl». Второй ComboBox, предназначенный 
для выбора темы, назовите CBTopics. В его свойство Items занесите список 
тем: «Topicl» и «Topic2». В обработчик события OnCreate формы вставьте 
операторы, задающие значения индексов обоих компонентов ComboBox рав- 
ными 0. 


Перенесите на форму компонент Memo и два компонента Edit. Тексты Memo и 
первого Edit (ЕЗИТ) очистите. Второй компонент Edit назовите ЕМасго и за- 
дайте в нем какой-нибудь текст, например, «Макрос 1». Этот компонент будет 
в дальнейшем использоваться для передачи макросов на сервер. 


Перенесите на форму четыре кнопки Button, расположите их согласно рисун- 
ку 6.12 и задайте на них надписи "Запрос", “Clipboard”, “PokeData” и “Вы- 
полнить". 


Перенесите на форму кнопку Зрее4Ви Йоп, назовите ee SBLink и установите 
на ней надпись “Контакт”. Эта кнопка должна фиксироваться в нажатом со- 
стоянии. Поэтому установите у нее свойство AllowAllUp равным true, a свой- 
ство GroupIndex равным 1. 


На этом размещение всех компонентов окончено. Теперь можно приступать к 


рассмотрению различных способов обмена информацией с сервером. 
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6.5.3.3 Запрос данных сервера 


Запросить данные сервера по инициативе клиента можно методом Request- 
Data компонента DdeClientConv. Этот метод объявлен следующим образом: 


char * RequestData(const System: :AnsiString Item); 


Здесь Item — строка, содержащая имя компонента DdeServerltem на сервере, 
в котором хранится требуемая информация. Функция Кедиез Дафа возвращает 
эту информацию в виде строки с нулевым символом в конце. 
_ Чтобы воспользоваться этой функцией вы можете в обработчике щелчка на 
кнопке с надписью Запрос написать следующий текст: 


char Info[256]; 


if (( ! DdeClientConvl->SetLink (CBServer->Text, CBTopics->Text) ) 
|| ! DdeClientConvl->OpenLink () ) 
ЗпомМез5аде ("Нет контакта с сервером '" + CBServer->Text + 
- по‘теме °" + CBTopics->Text’ + :""); 
else 


{ 
Info = DdeClientConvl->RequestData("Items" + 
IntToStr (CBTopics->ItemIndex+1) ); 
Memol->SetTextBuf (Info); 
DdeClientConvl1->CloseLink (); 


} 


В начале этого обработчика осуществляется связь методами SetLink и Open- 
Link с сервером, заданным пользователем в списке CBServer по Teme, заданной в 
списке CBTopics. Если связь осуществилась, то в переменную Info типа char зано- 
сится информация от компонента Цет$1 или Items2 на сервере в зависимости OT 
выбранной пользователем темы. Затем эта информация методом SetTextBuf зано- 
сится в компонент Memol. Последний оператор методом CloseLink разрывает 
связь с сервером. 

Отметим, что для осуществления такого запроса в приложении-клиенте вооб- 
ще не нужен компонент DdeClientItem. Он нам потребуется для иных целей. Одна- 
ко, если уж он имеется на форме, то его тоже можно использовать для получения 
информации по запросу. Для этого сделайте следующее. В свойстве Ddeltem ком- 
понента DdeClientItem1 укажите Itemsl — тему по умолчанию. В обработчик со- 
бытия OnChange списка CBTopics вставьте оператор 


DdeClientIteml->DdeItem = "Items" + IntToStr (CBTopics->ItemIndex+l) ; 


который обеспечит смену темы компонента DdeClientItem при изменении этой 
темы пользователем. В зависимости от выбора пользователя свойству Оде {ет этот 
оператор присваивает имя компонента Цет$1 или Items2 на сервере. В обработчик 
события OnChange компонента DdeClientItem1 вставьте оператор 


Editl->Text = DdeClientIteml->Text; 


Поскольку функция RequestData заносит информацию в DdeClientConv и в 
связанный с ним компонент DdeClientItem, то при изменении в результате запроса 
этой информации она отобразится в окне редактирования Edit. 

При этом мы продублировали получение информации. В действительности 
достаточно одной из двух альтернатив: 


Ш Ограничиться приведенной ранее процедурой занесения информации в Ме- 
mol, и не вводить обработчик события OnChange компонента DdeClientItem. 


Ш Ввести обработчик события OnChange компонента DdeClientItem, а в проце- 
дуре обработки щелчка на кнопке Запрос заменить два оператора чтения ин- 
формации на один: 


DdeClientConvl->RequestData("Items" + IntToStr (CBTopics->ItemIndex+l)):; 


не используя переменную Info и компонент Memol. 
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Внеся указанные тексты в приложение-клиент, запустите его на выполнение. 
Предварительно можно запустить (а можно и не запускать) серверы Зегуег и 
Зегуег1, с которыми будет осуществляться связь, HO не из C++Builder, a, напри- 
мер, программой Windows «Проводник». Запуск из C++Builder одновременно не- 
скольких приложений в режиме отладки возможен только в случае, если вы рабо- 
таете в Windows МТ. 

Проверьте наличие связи с разными серверами по разным темам. 

Мы рассмотрели запрос к серверу, посылаемый методом RequestData. Возмо- 
жен и другой способ связи с сервером — через буфер обмена Clipboard. Для того, 
чтобы можно было связаться с сервером, пославшим информацию в Clipboard, су- 
ществует метод PasteLink компонента DdeClientConv. Поместите в обработчик 
щелчка кнопки Clipboard команду 


DdeClientConvl->PasteLink(); 


Запустите опять ваше приложение на выполнение, запустив одновременно 
ваши серверы. Нажимая кнопки Clipboard того или иного сервера и затем нажи- 
мая кнопку Clipboard клиента, вы увидите, что в данном случае связь осуществля- 
ется с тем сервером, который последним поместил информацию в буфер обмена. 


6.5.3.4 Постоянное отслеживание информации на сервере 


Выше были рассмотрены варианты разовых запросов к серверам. Теперь по- 
смотрим, как можно постоянно наблюдать за сервером, осуществляя его оператив- 
ный мониторинг. Сделать это очень просто. Надо соединиться с сервером и, не за- 
крывая этого соединения, установить свойство DDEItem компонента DdeClient- 
Item равным имени того компонента DdeServerlItem на сервере, информацию OT 
которого требуется получать. До тех пор, пока соединение открыто, изменяющая- 
ся информация с сервера постоянно будет поступать на компонент DdeClientItem 
клиента. 

Чтобы осуществить это в вашем приложении-клиенте, в обработчик щелчка 
на кнопке SBLink с надписью Контакт вставьте следующий код: 

if (SBLink->Down) 

{ 


if(( ! DdeClientConvl1->SetLink (CBServer->Text, CBTopics->Text) ) 
|| ! DdeClientConvl->OpenLink () ) 
ShowMessage ("Нет контакта с сервером '" + CBServer->Text 
+ "7 По venue ”" + CBTopics->Text + "*"); 
} 
else 


{ 
DdeClientConvl->CloseLink (); 


Editl->Text = ""; 
} 


Если кнопка SBLink нажата, TO тем же способом, что и ранее, осуществляется 
связь с сервером. Эта связь разрывается только при отпускании кнопки SBLink. 
Запустите приложение, установите в списках сервер и тему, по которым хотите 
осуществить связь, и нажмите кнопку Контакт. В окне редактирования появится. 
информация, переданная с сервера. Это все было и ранее. Теперь войдите в прило- 
жение-сервер, с которым вы связались, и попробуйте изменять информацию в его 
окне редактирования. Вы увидите, что все эти изменения немедленно отображают- 
ся в окне приложения-клиента. Таким образом между двумя приложениями уста- 
новлен постоянный контакт. Он прервется только когда вы отпустите в приложе- 
нии-клиенте кнопку Контакт. 
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6.5.3.5 Передача информации от клиента к серверу 


Все ранее описанное было связано с передачей информации в направлении от 
сервера к клиенту. Однако имеется возможность передавать информацию и в об- 
ратном направлении — от клиента к серверу. Это может осуществляться методами 
PokeData, PokeDataLines, ExecuteMacro и ExecuteMacroLines компонента Dde- 
ClientConv.. 

Методы PokeData и PokeDataLines позволяют изменить информацию, храня- 
щуюся в компоненте DdeClientItem на сервере. Их можно использовать, если ком- 
понент DdeClientConv уже связан с сервером. АМ определены следующим 0о0б- 
разом: 

bool PokeData(const System::AnsiString Item, char *Data); 


bool PokeDataLines(const System::AnsiString Item, 
Classes::TStrings* Data); 


В обеих функциях параметр Item определяет имя компонента DdeServerltem 
на сервере, в который заносится информация, а параметр Вафа — тот текст, кото- 
рый должен заменить информацию на сервере. Различие между методами в том, 
что в PokeData в качестве параметра Data передается строка с нулевым символом 
в конце, а в функцию PokeDataLines — набор строк типа TStrings. 

Функции возвращают true, если передача данных прошла успешно. 

Реализовать подобное изменение информации на сервере в вашем приложе- 
нии-клиенте можно, например, вставив в обработчик щелчка на кнопке PokeData 
оператор: 

if ( ! DdeClientConvl->PokeDataLines ( 


DdeClientIteml->DdeItem, Memol->Lines) ) 
ShowMessage ("Данные не переданы, HET контакта с сервером"); 


При записи этого оператора предполагается, что прежде, чем делать щелчок 
на кнопке PokeData, пользователь войдет в контакт с сервером, нажав кнопку Кон- 
такт. В этом случае в свойстве DdeClientItem1->Ddeltem хранится имя компонента 
DdeServerltem на сервере, соответствующего теме, которая задана пользователем. 
В этот компонент DdeServerltem передается информация, которую пользователь 
задал в окне редактирования Memol. 

Запустите приложение, установите связь с сервером кнопкой Контакт, наберите 
строки в окне Memol и щелкните на кнопке PokeData. Вы увидите, что информа- 
ция в окне Editl изменится. Это будет свидетельствовать об изменении информа- 
ции на сервере. Вы можете в этом убедиться, прервав связь с сервером (отжав 
кнопку Контакт) и вновь установив связь кнопкой Контакт или Запрос. 

Выполнение методов PokeData и PokeDataLines сопровождается событием 
OnPokeData того компонента DdeServerlItem на сервере, в который передается ин- 
формация. Вы можете использовать это событие в серверах, чтобы, например, ото- 
бразить пользователю полученную информацию. Для этого добавьте в серверы 
метку Label и в обработчик событий oceans обоих компонентов DdeServer- 
Цет внесите оператор 


Labell->Caption = "Получены данные: '" + 
((TDdeServerItem *)Sender)->Text +"'"; 


Этот оператор занесет в надпись метки информацию того компонента DdeSer- 
уегЦет, в который она поступила. 


Другой способ передачи данных серверу — методы ExecuteMacro и Execute- 
MacroLines компонента DdeClientConv. Эти методы не изменяют информацию на 
сервере, а просто передают на сервер некоторый текст — макрос. Сервер может ана- 
лизировать переданный макрос и выполнять те или иные действия. Для этого ана- 
лиза используется событие OnExecuteMacro компонента DdeServerConv сервера. 
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Методы ExecuteMacro и ExecuteMacroLines можно использовать, если компо- 
нент DdeClientConv уже связан с сервером. Методы определены следующим обра- 
зом: 


bool ExecuteMacro(char * Ста, bool WaitFlg) ; | 
bool ExecuteMacroLines (Classes::TStrings* Ста, bool WaitFlg); 


Параметр Cmd содержит строку макроса (в ExecuteMacro) или набор макросов 
(в ExecuteMacroLines), которые должны передаваться на сервер. Параметр 
WaitFlg определят, должен ли клиент ждать завершения выполнения сервером 
всех макросов. Если WaitFlg = true, то последующие вызовы методов ExecuteMac- 
го, ExecuteMacroLines, PokeData, PokeDataLines и RequestData не будут успеш- 
ными, пока сервер не обработает всех переданных ему макросов. Проверить, завер- 
шил ли сервер обработку предыдущих макросов, можно, обратившись к свойству 
WaitStat компонента DdeClientConv. Пока WaitStat = true, вызов методов Exe- 
cuteMacro, ExecuteMacroLines, PokeData, PokeDataLines и RequestData не имеет 
смысла, TAK как сервер занят и эти методы все равно He будут выполнены. 

Функции возвращают true при успешной передаче макросов серверу. 

Обработчик события OnExecuteMacro компонента TDdeServerConv, которому 
передан макрос, имеет заголовок вида: 


void ...(TObject *Sender, TStrings *Msg) 


Параметр Msg содержит тексты переданных макросов. 
Чтобы ввести передачу макросов в наш тестовый пример, сделайте следующее. 
В приложении-клиенте в обработчик щелчка на кнопке Выполнить вставьте код: 


if (!DdeClientConvl->ExecuteMacro (EMacro->Text.c str(),false) ) 
ShowMessage ("Макрос не выполнен, нет контакта с сервером"); j 


Этот оператор передает Ha сервер в качестве макроса строку, набранную поль- 
зователем в окне редактирования ЕМасго. 

На серверах надо ввести обработчики событий ОпЕхесщеМасго компонентов 
TDdeServerConv. Давайте в нашем тестовом примере просто ограничимся отобра- 
жением переданного макроса в надписи метки Labell. Тогда обработчик события 
OnExecuteMacro обоих компонентов TDdeServerConv сервера может иметь вид: 

void _fastcall TFServer::TopiclExecuteMacro(TObject *Sender, 

TStrings *Msg) 
{ 


‘L£(Msg->Count == 0 ) 
ShowMessage (Application->ExeName + ": Макрос не получен"); 
else 
Labell->Caption = "Получен макрос '" + Msg->Strings[0]) + "'"; 


} 


Теперь запустите вне C++Builder ваши серверы (He обязательно), запустите на 
выполнение приложение-клиент и проверьте его работу по передаче макросов и во 
всех остальных режимах. 
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Повторное использование 
разработанных кодов 


7.1 Способы сохранения и повторного 
использования кодов 


Повторное использование кодов — важнейшая концепция объектно-ориенти- 
рованного визуального программирования. Все компоненты C++Builder — это 
коды, разработанные фирмой Borland, которые вы повторно используете, включая 
их в свое приложение. Вы используете также явно или неявно множество функций. 
и процедур API Windows, применяя многие функции и процедуры языка С++. Ho 
в данном разделе в основном речь пойдет о другом — как вам сохранить и повторно 
использовать свои собственные коды, разработанные в процессе проектирования. 

В C++Builder предусмотрено несколько механизмов сохранения и повторного 

использования кодов: 


Ш Создание и хранение в библиотеке шаблонов компонентов 
Хранение и наследование форм и фреймов в Депозитарии 
Хранение проектов в Депозитарии 

Создание новых компонентов и хранение их в библиотеке 
Создание динамически присоединяемых библиотек DLL 
Создание пакетов (packages) 


Первые четыре механизма позволяют вам включать ранее разработанные 
коды непосредственно в ваш загрузочный модуль. Два последних подхода дают 
возможность включать коды в некоторые файлы поддержки, которые должны рас- 
пространяться совместно с вашим приложением. Как увидим ниже, такой подход 
имеет свои преимущества и недостатки. 


7.2 Создание и хранение шаблонов компонентов 


Наиболее простой способ сохранения разработанных вами компонентов для 
последующего использования — запоминание в библиотеке визуальных компонен- 
тов их шаблонов. Покажем, как это делается, на простом примере. Пусть вы хоти- 
те на основе компонента Edit создать окно редактирования, в котором пользова- 
тель мог бы вводить только целые числа, т.е. не мог бы вводить никаких других 
символов, кроме цифр. Кроме того, при нажатии пользователем клавиши Enter фо- 
кус должен передаваться следующему компоненту в последовательности табуля- 
ции. Это можно сделать, например, следующим образом. 

Откройте новое приложение и перенесите на форму компонент типа Edit. В об- 
работчике его события OnKeyPress напишите оператор 

set <char, '0', '9'> Dig; 

Lf °C Dig К Sta ee eae Roe oe: Se eee a FG 

Кб RS EP Meee Eo: '9') боба (Rey) ) 
Key = 0; 


а в обработчике события OnKeyDown — оператор: 
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if (Key == УК ВЕТОВМ) 
FindNextControl ( 
(TWinControl *)Sender, true, true, false)->SetFocus(); 


Эти операторы, о которых подробнее рассказано было в разделе 4.3.2.2, 3ame- 
няют все символы, кроме цифр, нулевым символом, который не будет отображать- 
ся в окне, и при нажатии Enter передадут фокус очередному компоненту. 

Измените также текст в окне (свойство Text) на «0». 

Пусть мы хотим сохранить шаблон этого компонента в библиотеке визуаль- 
ных компонентов, чтобы в дальнейшем включать подобный компонент в другие 
свои приложения. Для этого надо, выделив предварительно данный компонент, 
выполнить команду Component | Create Component Template (создать шаблон компо- 
нента). В открывшемся диалоговом окне Component Template Information (рис. 7.1) вы 
можете задать имя компонента (в верхнем окне редактирования), которое будет 
появляться на ярлычке подсказки, если пользователь задержит курсор мыши над 
пиктограммой этого компонента в библиотеке визуальных компонентов. На 
рис. 7.1 это имя — EditNum. В выпадающем списке в средней части окна вы може- 
те выбрать страницу библиотеки визуальных компонентов, на которой вы хотите 
разместить пиктограмму компонента. Вы можете также указать новое имя 
(MyTemplates на рис. 7.1) и тогда в библиотеке визуальных компонентов будет 
создана новая страница с этим именем. Можно также изменить пиктограмму дан- 
ного компонента (кнопка Change). Пиктограмма, если вы ее хотите сменить, долж- 
на быть подготовлена заранее в виде файла .bmp размером 24 на 24. Как это можно 
сделать, рассказано в разделе 5.1.2.2 главы 5. На рис. 7.1 как раз загружается 
пиктограмма, создание которой описано в разделе 5.1.2.2. После выполнения всех 
описанных операций щелкните на кнопке ОК. 

Ваш шаблон появится в библиотеке. Вы можете убедиться в этом, посмотрев 
на указанную вами страницу библиотеки. 


Рис. 7.1 
Окно ввода информации о новом шаблоне компонента 


Теперь попробуйте создать новое приложение и перенести на форму созданный 
вами компонент. Вы увидите, что он появится на форме в том виде, в котором вы 
его записали в библиотеку. Посмотрев на страницу событий этого компонента в 
Инспекторе Объектов, вы увидите, что на ней указаны обработчики событий 
OnKeyDown и OnKeyPress, а в процедурах этих обработчиков уже записаны Te 
операторы, которые вы написали, перед созданием шаблона. 

Правда, у такого подхода имеется определенный недостаток. Если вы размес- 
тите на форме несколько созданных вами компонентов, то для каждого из них в 
текст модуля включатся соответствующие обработчики событий. Это явная избы- 
точность, поскольку написанные вами операторы обработки универсальны и хва- 
тило бы одного обработчика события OnKeyDown и одного обработчика события 
OnKeyPress на все размещенные компоненты. Чтобы избежать избыточности, же- 
лательно будет оставить в модуле по одному обработчику каждого вида, остальные 
удалить из текста, а во всех окнах редактирования сослаться на оставшиеся обра- 
ботчики. 

Таким образом вы можете создать себе немало шаблонов компонентов, кото- 
рые кочуют из приложения з приложение. Аналогичным образом можно создавать 
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шаблоны не только отдельных компонентов, но и групп компонентов. Например, в 
разделе 4.1.6.2 описано создание достаточно универсального меню и инструмен- 
тальной панели. Эту группу компонентов целесообразно сохранить в виде шабло- 
на. Вообще целесообразно сделать шаблоны всех тех фрагментов, которые часто 
используются вами при проектировании форм. Это сэкономит вам немало времени 
при разработке новых проектов. 

Если в дальнейшем вам перестанет нравиться созданный вами шаблон, вы мо- 
жете удалить его из библиотеки. Описание этой процедуры вы найдете в разделе 
14.2.2 главы 14. 


7.3 Создание новых компонентов и включение 
‚ их в библиотеку 


7.3.1 Начало создания и установка компонента 


Создание новых компонентов дает, конечно, неизмеримо больше возможно- 
стей, чем построение шаблонов имеющихся компонентов. При создании компонен- 
тов, наследующих каким-либо имеющимся в C++Builder компонентам, вы можете 
добавить новые свойства, в том числе и отображаемые в Инспекторе Объектов, до- 
бавить новые события ит.п. Однако, создание новых компонентов — это непростой 
процесс, требующий хорошего понимания тонкостей наследования и хорошего 
знания свойств, методов и событий родительских компонентов. Подробное рас- 
смотрение этих вопросов выходит за рамки настоящей книги. Тем не менее некото- 
рые основы этого будут рассмотрены ниже. 

Давайте поставим перед собой сравнительно простую задачу: создать окно ре- 
дактирования, в котором по желанию во время проектирования и во время выпол- 
нения можно будет разрешать ввод только цифр (например, если предполагается, 
что пользователь должен вводить целое число), запрещать ввод цифр (например, 
при вводе пользователем фамилии, имени и отчества) или разрешать ввод любых 
символов. Кроме того предусмотрим очистку содержимого окна и свойство, пока- 
зывающее, был ли модифицирован пользователем текст с момента последней очи- 
стки. В момент очистки определим генерацию соответствующего события, которое 
пользователь при желании может обрабатывать. 

Построим наш компонент как наследника класса TEdit и назовем наш новый 
класс TEditLetNum. В компонент, помимо свойств, обычных для TEdit, желатель- 
но добавить два новых свойства: EnableNum и EnableLet. Тип обоих свойств — 
bool. Первое из них разрешает или запрещает ввод цифр, а второе разрешает или 
запрещает ввод каких-либо символов, кроме цифр. Таким образом, если 
EnableNum = true и EnableLet = true, то это будет обычное окно редактирования. 
Если EnableNum = true, а EnableLet = false, получим окно, в котором можно BBO- 
дить только цифры. Если EnableNum = false, а EnableLet = true, то в окно, запре- 
щено вводить цифры. Hy а ситуацию, когда EnableNum = false и EnableLet = 
false, надо запретить, поскольку в такое окно ничего ввести невозможно. 

Предусмотрим в компоненте метод Clear — очистку текста в окне и свойство 
Modified, которое будет показывать, был ли модифицирован текст с момента по- 
следней очистки. В момент очистки будем генерировать событие OnClear. 

Если вы хотите, чтобы ваш новый компонент фигурировал на страницах па- 
литры компонентов с новой оригинальной пиктограммой, то начните с ее созда- 
ния. Необходимые для этого действия описаны в разделе 5.1.2.4 главы 5. 

Компоненты в C++Builder компилируются в пакеты. Поэтому, если вы еще не 
создали пакет, в который хотите компилировать ваш новый компонент, то можете 
начать с его создания (впрочем, это можно сделать и позднее). Для создания нового 
пакета: 
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1. Выполните команду File | New и в диалоговом окне New Items на странице New 
выберите пиктограмму Package — пакет. После этого вы попадете в окно Дис- 
петчера Пакетов (Package Manager), показанное на рис. 7.2. В этом окне Сото- 


ins — содержимое пакета, a Requires — список других пакетов, требующихся 
для поддержки вашего. 


2. Сразу сохраните пакет в файле с расширением .dpk, выполнив команду Fi- 
le | Save As или выбрав команду Save из меню, всплывающего при щелчке пра- 
вой кнопкой мыши. 


Рис. 7.2 
Окно Диспетчера Пакетов, готовое для 
внесения нового компонента 


Я 


3. Щелкнув на кнопке Add (добавить), вы попадете в окно, позволяющее вам 
включить в пакет модуль (Add Unit), компонент (New Component) или ActiveX (т- 
port ActiveX). В данном случае вам надо включить в пакет свой новый компо- 
нент. Для этого вы открываете соответствующую страницу, которая имеет 
вид, представленный на рис. 7.3. Укажите в этом окне родительский тип (вы- 
берите TEdit из выпадающего списка Ancestor type), имя нового класса в окне 
Class Мате (для нашего примера — TEditLetNum), страницу в библиотеке 
компонентов (Palete Page), на которой хотите разместить пиктограмму вашего 
нового компонента. Можете указать новую страницу и она будет создана. Про- 
верьте также путь и имя модуля вновь создаваемого компонента (окно Unit file 
пате). | 


Рис. 7.3 
Окно ввода информации о 
включаемом в пакет компоненте 


‘\Tests\NewComp2\E ditL etNum.cpp 
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4. Щелкните на ОК и вы вернетесь в окно Диспетчера Пакетов, но в нем уже поя- 
вится имя вашего компонента. А если вы заранее создали файл ресурса компо- 
нента .4сг с его новой пиктограммой, то Диспетчер Пакетов включит в пакет и 
этот файл. | 


5. Щелкните на кнопке Install (установка) и компонент будет установлен на ука- 
занной вами странице библиотеки компонентов. Можете открыть эту страни- 
цу и увидеть его там. Выполнив в окне Диспетчера Пакетов двойной щелчок 
на имени файла компонента, вы можете перейти в окно редактирования и уви- 
деть, что в нем появилась заготовка модуля вашего компонента. ‚Сохраните ее 
в файле (File | Save). 


6. Чтобы скомпилировать модуль вашего компонента, можно щелкнуть в окне 
Диспетчера Пакетов на кнопке Сотрйе (компиляция). Но в данном случае мо- 
дуль уже скомпилирован во время его установки. 


При выходе из Диспетчера Пакетов вам будет задан вопрос о сохранении ин- 
формации в файле пакета (расширение этого файла .dpk). Ответьте на вопрос ут- 
вердительно. 

Возможно и другое начало проектирования нового компонента. 


7. Выполните команду Component | New Component и попадете в почти такое же, 
как описано выше, окно New Component. 


8. Занеся в него необходимую информацию, щелкните на кнопке Install (установ- 
ка) и перед вами появится диалоговое окно (рис. 7.4) с двумя закладками: Into 
existing package (устанавливать в существующий пакет) и Into new package (уста- 
навливать в новый пакет). Выберите файл пакета из существующих или, луч- 
ше, укажите имя нового файла и строку его описания на странице Into new 
package. Вам будет задан вопрос: «File... will be built then installed. Continue?» 
(«Dain ... будет сначала построен, a потом установлен. Продолжать? »). Отве- 
тьте на заданный вопрос утвердительно и файл будет установлен в пакет, заре- 
гистрирован на указанной странице в библиотеке, а его модуль появится в 
окне редактирования. На экране появится рассмотренное ранее окно Диспет- 
чера пакетов (рис. 7.2). 


Рис. 7.4 
Окно ввода информации о 
новом пакете 


ИР 


Мы рассмотрели пути создания новых пакетов и включения в них новых ком- 
понентов. Если в дальнейшем вы захотите удалить зарегистрированный вами пакет, 
это можно сделать одним из двух способов: Выполнить команду Component | Install 
Packages или команду Project | Options. В первом случае вы сразу попадете в диалог ра- 
боты с пакетами. Во втором случае этот диалог вы найдете на странице Packages. 
Диалог работы с пакетами будет подробно рассмотрен в разделе 7.6.2 (рис. 7.16). В 
этом диалоге вы можете удалить ваш пакет кнопкой Кетоуе. Впрочем, если вы в 
дальнейшем передумаете, вы опять можете зарегистрировать его кнопкой Add. 

Итак, вы создали прообраз вашего компонента и зарегистрировали его. По 
умолчанию пиктограмма компонента на соответствующей странице библиотеки 
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будет взята тождественной пиктограмме родительского типа. A если вы заранее, 
как указывалось в разделе 5.1.2.4 главы 5, создали файл ресурсов компонента и 
включили в него новую пиктограмму, то именно ею вы сможете любоваться в па- 
литре компонентов. на указанной вами странице. 


7.3.2 Структура класса компонента 


Заготовка модуля компонента, созданная в результате указанных ранее дейст- 
вий, имеет следующий вид. 


Файл EditLetNum.h: 


#ifndef EditLetNumH 
#define EditLetNumH 
// 
#include <SysUtils.hpp> 
#include <Controls.hpp> 
#include <Classes.hpp> 
#include <Forms.hpp> 
#include <StdCtrls.hpp> 
| ss: Seal, eae Gea acd ORR a LG ER A 
class PACKAGE TEditLetNum : public TEdit 
{ 
private: 
protected: 
public: 
__fastcall TEditLetNum(TComponent* Owner) ; 
__ published: 
}; 
et 
#endif 


Файл EditLetNum.cpp: 


#include <vcl.h> 
#pragma hdrstop 


#include «EditLetNum.h» 

#pragma package(smart init) 

"т Е" a 

// ValidCtrCheck is used to assure 

// that the components created do not have 
// any pure virtual functions. 


Static inline void ValidCtrCheck(TEditLetNum *) 
{ 

new TEditLetNum(NULL) ; 
} 
A Sie AN REE SE ROMANS SANS Aad ORICA TSW BE 
__fastcall TEditLetNum: :TEditLetNum(TComponent* Owner) 

TEdit (Owner) 

{ 
} 
// 
namespace Editletnum 
{ 

void _fastcall PACKAGE Register () 

{ , 
TComponentClass classes[1] = {_classid(TEditLetNum) }; 
RegisterComponents («MyComponents», classes, 0); 


} 
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Собственно говоря, в этой заготовке пока только каркас класса будущего моду- 
ля. Файл EditLetNum.cpp содержит три процедуры: ValidCtrCheck, конструктор 
TEditLetNum и Register. Процедура ValidCtrCheck носит вспомогательный ха- 
рактер и вводится, чтобы проверять, не содержит ли компонент чистых виртуаль- . 
ных функций. Тело конструктора TEditLetNum пока пустое. Позднее мы запол- 
ним его. А процедуру Register, регистрирующую компонент на заданной странице 
библиотеки, давайте рассмотрим подробнее. 

Код регистрации компонента начинается с оператора namespace. Ключевое 
слово Namespace устанавливает локальность имен данной процедуры регистрации. 
После этого ключевого слова следует имя файла, содержащего компоненты. Имя 
пишется символами в нижнем регистре, кроме первой заглавной буквы. 

В процедуре регистрации Register первый оператор создает массив регистри- 
руемых компонентов Classes типа TComponentClass и заносит в него регистрируе- 
мый компонент. Если бы вы создали два компонента (пусть имя второго из них 
ТЕЗ 2), регистрируемых на одной странице библиотеки, вы могли бы занести их в 
массив оператором: 


TComponentClass classes[2] = {  classid(TEditLetNum), 
__Classid(TEdit2) }; 


Следующий оператор процедуры регистрации регистрирует функцией 
RegisterComponents компоненты, занесенные в Classes (второй параметр функ- 
ции) на странице MyComponents (первый параметр). Последний параметр является 
последним индексом массива регистрируемых компонентов. 

Теперь рассмотрим коротко описание класса в заголовочном файле Edit- 
LetNum.h. Вы видите в нем разделы private, protected, public и published. Они 
определяют четыре варианта доступа к переменным, процедурам и функциям: 


NEES SOLED LIS SE LEE LE ILE SERIES SAL GELEBELILES ITED ИИ ELLER BE: ани 


private (закрытые) _ oF Процедуры и функции, определенные таким 
образом, доступны только в пределах данного 
модуля 

protected (защищенные) Процедуры и функции, определенные таким 


образом, доступны в классах потомков 
public (открытые) Эти процедуры и функции доступны везде 


_ published (опубликованные) Процедуры и функции доступны везде и име- 
ют связь со средой разработки C++Builder, 
обеспечивающую вывод на экран в Инспекторе 
Объектов страниц информации о свойствах и 
событиях 


Вспомним (см. раздел 1.2 главы 1) наше определение объекта (компонент — 
это объект) как совокупности свойств, методов и обработчиков событий. Причем 
свойства — это совокупность полей данных и методов их чтения и записи. Вспом- 
ним также принцип скрытия информации. Исходя из этого,. разработчик KOMIIO- 
нента должен продумать, в какие разделы вставить вводимые им поля данных, 
свойства и методы. 


7.3.3 Задание свойств 


Поля данных всегда должны быть защищены от несанкционированного досту- 
па. Поэтому их целесообразно определять в private — закрытом разделе класса. В 
редких случаях их можно помещать в protected — защищенном разделе класса, 
чтобы возможные потомки данного класса имели к ним доступ. Традиционно 
идентификаторы полей совпадают с именами соответствующих свойств, но с до- 
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бавлением в качестве префикса символа ‘F’. Таким образом, в нашем примере вы 
можете занести в раздел private объявления трех необходимых нам полей данных: 


Class PACKAGE TEditLetNum : public TEdit 
{ 
private: 
// Закрытые элементы-данные класса 
bool FEnableNum; 
bool FEnableLet; 
bool FModified; 


}; 
Теперь надо объявить свойства — методы чтения и записи этих полей. Свойст- 
во объявляется оператором вида: 
_ property <тип> <имя> = {геаа=<имя поля или метода чтения> 
write=<uma поля или метода записи> 


<директивы запоминания 
и значения по умолчанию>; 


Если в разделах read или write записано имя поля, значит предполагается 
прямое чтение или запись данных. 

Если в разделе read записано имя метода чтения, то чтение будет осуществ- 
ляться только функцией с этим именем. Функция чтения — это функция без пара- 
метра, возвращающая значение того типа, который объявлен для свойства. Имя 
функции чтения принято начинать с префикса Get, после которого следует имя 
свойства. 

Если в разделе write записано имя метода записи, то запись будет осуществ- 
ляться только процедурой с этим именем. Процедура записи — это процедура с од- 
ним параметром того типа, который объявлен для свойства. Имя процедуры запи- 
си принято начинать с префикса Set, после которого следует имя свойства. 

Если раздел write отсутствует в объявлении свойства, значит это свойство 
только для чтения и пользователь не может задавать его значение. 

Директивы запоминания определяют, как надо сохранять значения свойств 
при сохранении пользователем файла формы .dfm. Чаще всего используется ди- 
ректива = 


default = <значение по умолчанию> 


Она не задает начальные условия. Это дело конструктора. Директива просто 
говорит, что если пользователь в процессе проектирования не изменил значение 
свойства по умолчанию, то сохранять значение свойства не надо. 

Итак, для нашего примера объявления свойств могут иметь вид: 

public: 

fastcall TEditLetNum(TComponent* Owner) ; 


// Свойство только времени выполнения 
_ property bool Modified = {read=FModified, default=false}; 


__published: 
// Свойства компонента, включаемые в Инспектор Объектов 
_ property bool EnableLet = {read=FEnableLet, 


write=SetEnableLet, 
default=true}; 

_ property bool EnableNum = {read=FEnableNum, 
write=SetEnableNum, 
default=true}; 


Объявление свойства Modified помещается в раздел public, поскольку это 
свойство должно быть доступно только во время выполнения. Свойства 
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EnableNum и EnableLet помещаются в раздел __ published, так как они должны 
отображаться в Инспекторе Объектов во время проектирования. 

Свойства EnableNum и EnableLet имеют прямой доступ к полям для чтения. 
Но для записи они имеют методы Зе Е паеМит и SetEnableLet соответственно. 
Это связано с тем, что при записи свойств надо проверять, не окажутся ли значе- 
ния обоих этих свойств равными false. Подобное задание значений надо предотвра- 
щать, поскольку в этом случае в окно редактирования вообще ничего нельзя будет 
ввести. 

Свойство Modified вообще не имеет метода записи, поскольку оно предназна- 
чено только для чтения. 

Указанные в объявлениях методы записи могут быть реализованы обычными 
функциями, объявления которых помещаются в private — закрытый раздел клас- 
са, а их реализация включается в тело модуля. Для того, чтобы задать свойствам 
начальные значения, надо еще включить соответствующие операторы в тело кон- 
структора. В итоге в данный момент модуль компонента может иметь следующий 
вид. 


Файл EditLetNum.h: 


class PACKAGE TEditLetNum : public TEdit 
{ 
private: | 
// Закрытые элементы-данные класс 
bool FEnableLet; 
bool FEnableNum; 
bool FModified; 
protected: 
// Защищенные методы записи 
void _fastcall SetEnableLet (bool AEnableLet) ; 
void _fastcall SetEnableNum(bool AEnableNum) ; 
‚ public: 
// Объявление конструктора 
__fastcall TEditLetNum(TComponent* Owner) ; 
// Свойство только времени выполнения 


_ property bool Modified = {read=FModified, default=false}; 
__ published: : 
// Свойства компонента, включаемые в Инспектор Объектов 

_ property bool EnableLet = {read=FEnableLet, 


write=SetEnableLet, 
default=true}; 

__ property bool EnableNum = {read=FEnableNum, 
write=SetEnableNum, 
default=true}; 

}; 


Файл EditLetNum.cpp: 


static inline void ValidCtrCheck(TEditLetNum *) 
{ 


} 

ие ВО СИ KT ck 

__fastcall TEditLetNum: : TEditLetNum(TComponent* Owner) 
TEdit (Owner) 


new TEditLetNum (NULL) ; 


{ : 
FEnableLet true; 
FEnableNum = true; 
FModified = false; 

} 
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| ana a se A 
namespace Editletnum 


{ 
void _fastcall PACKAGE Register () 


{ 
TComponentClass classes[1] = {_classid(TEditLetNum) }; 


RegisterComponents («MyComponents», classes, 0); 


} 
LLP TCR ELA I IO 
void _ fastcall TEditLetNum: :SetEnableNum(bool AEnableNum) 


{ 
//Присваивание значения полю FEnableNum 
FEnableNum = AEnableNum; 


// Если значения FEnableNum и FEnableLet = false, 
// то полю FEnableLet присваивается true 

if (! AEnableNum) 

if (! FEnableLet) FEnableLet = true; 


} 
р аль eA REL Oe a is 
void  fastcall TEditLetNum: :SetEnableLet (bool AEnableLet) 


{ 
//Присваивание значения полю FEnableLet 
FEnableLet = AEnableLet; 


// Если значения FEnableNum и FEnableLet = false, 
// то полю FEnableNum присваивается true 

if (! AEnableLet) 

if (! FEnableNum) FEnableNum = true; 
} 


Процедуры, реализующие методы записи, присваивают полю переданное в 
них значение параметра и в случае, если передано значение false, проверяют зна- 
чение другого поля. Если и другое поле имеет значение false, то оно исправляется 
на true. 

Объявления процедур записи включены в раздел protected. Это означает, что 
они закрыты для внешнего пользователя, но доступны для возможных потомков 
вашего класса. 

Конструктор объявлен в открытом разделе класса public и имеет имя 
TEditLetNum, совпадающее с именем класса. В реализации конструктора задают- 
ся начальные значения новым свойствам, которые вы добавили в компонент. 

Теперь давайте сохраним подготовленные файлы, откомпилируем их (кнопка 
Compile в Диспетчера Пакетов рис. 7.2) и построим тестовое приложение для отлад- 
ки установленного компонента. Хотя он еще не до конца создан, кое-что уже мож- 
но увидеть. 

Откройте новый проект и внесите в него с соответствующей страницы ваш но- 
вый компонент. Откройте (командой Ее | Ореп) файл вашего компонента, чтобы 
можно было вносить в него какие-то изменения. Сохраните проект под каким-ни- 
будь именем (например, Test). Откомпилируйте ваше приложение (команда Project | 
Make All Projects). Если все прошло без ошибок, выделите на форме ваш компонент и 
взгляните на его свойства в Инспекторе объектов. Вы найдете там добавленные 
вами свойства EnableNum и EnableLet. Оба свойства имеют по умолчанию задан- 
ные в конструкторе значения true. Попробуйте изменить оба значения Ha false. 
Это вам не удастся сделать, так как сработают написанные вами методы записи. 

Свойство Modified в Инспекторе объектов вы не увидите, так как это свойство 
может использоваться только во время выполнения. 


РТМ 
; 
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7.3.4 Создание методов 


Методы включаются в открытый раздел класса — раздел public, поскольку 
иначе их нельзя было бы использовать. Собственно один метод — конструктор 
TEditLetNum, вы уже написали. Теперь вам нужно написать метод Clear, очи- 
щающий содержимое окна редактирования и устанавливающий значение поля 
FModified равным false. Генерировать событие OnClear мы пока не будем. A по- 
скольку базовый класс TEdit уже имеет метод Clear, очищающий текст, занесен- 
ный в окно редактирования, то вы можете в вашем переопределенном методе вы- 
звать наследуемый метод Clear и добавить задание значения FModified. Чтобы 
точно знать, как выглядит объявление метода Clear в классе-предке, полезно обра- 
титься к справке C++Builder и точно воспроизвести в вашем новом классе объявле- 
ние переопределяемого метода. Это объявление в классе TCustomEdit имеет вид: 


virtual void _fastcall Clear(void); 
Таким образом, объявление и реализация переопределенного метода Clear мо- 
жет иметь вид: 


class PACKAGE TEditLetNum : public TEdit 
{ 


public: 
virtual void _fastcall Clear(void); 
}; 


void _fastcall TEditLetNum: :Clear (void) 
{ 


TEdit: :Clear(); // Вызов родительского метода 
FModified = false; 
} 


Как видно из приведенного кода, для вызова родительского метода достаточно 
просто указать явным образом класс (в нашем случае ТЕЗ), метод которого вызы- 


‚вается. 


Впрочем, в данном случае вы могли бы и не обращаться к родительскому мето- 
ду, а просто очистить текст в окне: 


void _fastcall TEditLetNum: :Clear (void) 
{ 


Text = «»; 
FModified = false; 
} 


Теперь запишем главную процедуру, ради которой мы и создавали свой KOM- 
понент: процедуру, разрешающую или запрещающую ввод символов того или ино- 
го типа. Для этого нам надо анализировать вводимый пользователем символ. Это 
можно делать при обработке события OnKeyPress. Значит нам надо переопреде- 
лить стандартную функцию генерации (т.е. стандартный обработчик) в родитель- 
ском компоненте TEdit. Стандартные обработчики имеют то же имя, что и собы- 
тия, но без префикса Оп. То есть обработчик события OnKeyPress имеет имя 
KeyPress. Передаваемые в стандартный обработчик параметры те же, что вы MO- 
жете видеть в заготовке процедуры обработки события, если щелкнете на этом со- 
бытии в Инспекторе Объектов, но без параметра Sender. Например, щелкнув в Ин- 
спекторе Объектов на событии OnKeyPress любого компонента, вы увидите, что в 
процедуру обработки передаются параметры: 


(TObjJect *Sender, char &Key) 
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Значит в создаваемом нами обработчике и при вызове родительского обработ- 
чика надо использовать только один параметр: char &Кеу. 

Впрочем, поскольку вам надо будет точно воспроизвести объявление переопре- 
деляемой функции в классе-предке, обратитесь к справке C++Builder. Вы увидите, 
что функция KeyPress наследуется из класса TWinControl и объявлена в нем сле- 
дующим образом: 


DYNAMIC void _fastcall KeyPress(char &Кеу); 


Это объявление надо в точности воспроизвести в своем классе-наследнике. Ha- 
пример, если вы пропустите в объявлении спецификатор DYNAMIC, вы получите 
при компиляции сообщение: 


[С++ Error] ЕЧ1ЕЬееМит.В (24): E2113 Virtual function ' fastcall 
TEditLetNum: :KeyPress(char &)' conflicts with base class 'TWinControl' 


Ero смысл заключается в TOM, что возник конфликт с функцией KeyPress, 
объявленной в базовом классе TWinControl. В результате компиляция не будет 3a- 
вершена. т 

Таким образом, введение в модуль компонента требуемой нам функции может 
свестись к включению в раздел класса protected приведенного выше объявления и. 
написанию в файле модуля реализации функции: 


void _ fastcall TEditLetNum: :KeyPress(char &Кеу) 
| 
нае сосна, 0,904; 
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if ((! FEnableNum) && (Dig.Contains (Кеу))) 
Кеу = 0; 

if ((! FEnableLet) && ! (Dig.Contains (Кеу))) 
Key = 0; 

if (Key != 0) FModified = true; 


TEdit: :KeyPress (Key) ; 

} 

Эта функция сначала заменяет недопустимые символы нулевыми. Если сим- 
вол допустимый, то задается значение true полю свойства FModified. В конце вы- 
зывается метод КеуРгез$ родительского класса. 

Можете скомпилировать (быстрая кнопка Compile — слева на рис. 7.2.) и про- 
тестировать полученный компонент. Проще всего это сделать, создав группу про- 
ектов (см. раздел 2.4.3), включающую ваш пакет и тестирующее приложение. Вы- 
полните команду View | Project Manager и перед вами откроется окно Менеджера 
Проектов, показанное на рис. 2.17 в главе 2. В нем будет вершина, соответствую- 
щая вашему пакету. С помощью кнопки New вы можете включить в группу новый 
проект, выбрав в окне New Нет; пиктограмму Application. В этом проекте и созда- 
вайте тестирующее приложение, возможный вид которого представлен на рис. 7.5. 
Форма содержит компонент EditLetNum, кнопку Button с надписью Clear (при ее 
нажатии выполняется метод Clear), метку Label, в которой отображается значение 
свойства Modified компонента EditLetNum1, и три индикатора типа TCheckBox. 


Рис. 7.5 
Тестовое приложение вашего нового компонента 
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Два из них (назовите их CBNum и CBLet) указывают допустимость ввода цифр и 
букв. О третьем речь пойдет в следующем разделе. 
Обработчик события OnCreate формы может иметь вид: 


void _fastcall TForml::FormCreate(TObject *Sender) 


{ 
if (EditLetNuml->Modi fied) 
Labell->Caption = «Modified = true»; 
else Labell->Caption = «Modified = false»; 


} 


Этот обработчик заносит в метку Labell сообщение о текущем значении свой- 
ства Modified. 

В обработчике события OnKeyUp компонента EditLetNum напишите опера- 
тор: 

FormCreate (Sender) ; 


Этот оператор вызывает TOT же приведенный выше обработчик события 
OnCreate формы для отображения текущего значения Modified. 

Обработчик события OnClick индикатора СВМит может иметь вид: 

EditLetNuml->EnableNum = CBNum->Checked; 


CBLet->Checked = EditLetNuml->EnableLet; 
EditLetNuml->SetFocus(); 


Первый оператор этого обработчика устанавливает значение параметра 
EnableNum в зависимости от состояния индикатора СВМит. Второй оператор ус- 
танавливает состояние индикатора CBLet равным значению параметра EnableLet. 
Это надо, поскольку если, например, сбрасывается в false значение параметра 
EnableNum, а значение параметра EnableLet в этот момент тоже было равно false, 
то компонент EditLetNum1 установит значение EnableLet равным true. И надо, 
чтобы это новое значение отобразилось в индикаторе CBLet. 

Аналогично может выглядеть обработчик события OnClick индикатора CBLet: 

EditLetNuml->EnableLet = CBLet->Checked; 


CBNum->Checked = EditLetNuml->EnableNum; 
EditLetNuml->SetFocus(); 


В обработчике события OnClick кнопки Clear напишите: 


EditLetNuml->Clear (); 
FormCreate (Sender) ; 


Эти операторы проверят работу введенного вами метода Clear и отобразят на 
экране изменение значения свойства Modified. 

Оттранслируйте компонент. В вашем тестовом приложении установите свой- 
ства EnableNum и EnableLet в соответствии с тем, какие исходные установки ин- 
дикаторов СВМиш и CBLet вы задали. Активизируйте в окне Менеджера Проектов 
вершину вашего тестового приложения (см. раздел 2.4.3), запустите его на выпол- 
нение и проверьте в работе при различных значениях свойств EnableNum и 
EnableLet. 

Если в написанных файлах вашего нового компонента что-то не в порядке, TO 
вам может захотеться ввести в файл реализации компонента какие-то точки пре- 
рывания. Но это у вас не получится. При запуске теста на выполнение точки пре- 
рывания, введенные в файл компонента, окажутся недоступными. А если вы акти- 
визируете в окне Менеджера Проектов вершину пакета и попробуете выполнить 
его, то получите сообщение: «Cannot debug project unless a host application is defined. Use 
Run|Parameters... dialog box». Это означает, что вы сначала с помощью команды Run | 
Parameters должны определить хост — тестирующее приложение. Выполните эту 
команду, предварительно активизировав в окне Менеджера Проектов вершину па- 
кета. Перед вами откроется диалог, представленный на рис. 7.6. В верхнем окошке 
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вы должны указать файл тестирующего приложения. Для этого можете воспользо- 
ваться кнопкой поиска Browse. Кнопка Load позволяет вам загрузить тестирующее 
приложение и начать его выполнение по шагам. Затем можете запускать выполне- 
ние обычной командой Кип | Run (Е9). Впрочем, после того, как вы один раз задали 
хост для пакета в окне рис. 7.6, вы можете в дальнейшем запускать пакет на вы- 
полнение обычным образом. 


Рис. 7.6 Run Parameters 
Задание приложения, тестирующего ван 
DLL 


‘\Tests\NewComp2\PT est] exe 


7.3.5 Создание событий 


В нашем примере требуется ввести событие OnClear, происходящее в момент 
очистки окна методом Clear. В C++Builder событие — это просто специальное 
свойство, являющееся указателем функции. Тип обобщенного указателя на функ- 
цию, которой передается один параметр типа ТСотропеп (обычно this), — 
TNotifyEvent. Подобный тип используется в C++Builder для событий типа 
OnClick и многих других, которые передают в обработчик только один параметр — 
TObject *Sender. Подойдет этот тип и нам для события Оп еаг. 

В этом случае объявления нашего события могут иметь вид: 


private: 
TNotifyEvent FOnClear; 
__ published: 


_ property TNotifyEvent OnClear = {read=FOnClear, 
write=FOnClear}; 


Эти объявления создают поле FOnClear типа TNotifyEvent, соответствующее 
событию. А само событие объявляется точно так же, как любое свойство. Только в 
read и write записываются не функции чтения и записи, а само поле. 

Остается только вызвать в нужный момент обработчик события пользователя, 
если пользователь его предусмотрел. Проверка, имеется ли обработчик пользовате- 
ля, осуществляется проверкой соответствующего события как булевой величины, 
возвращающей true, если пользователь предусмотрел свой обработчик. В нашем 
случае эта проверка и вызов обработчика пользователя осуществляется добавлени- 
ем в начало написанной ранее процедуры метода Clear оператора: 


if (OnClear) OnClear(this) ; 
который вызывает обработчик пользователя OnClear. 
Внесите указанные изменения в файлы компонента, откомпилируйте их, вы- 


делите на форме тестового приложения компонент EditLetNuml и посмотрите 
страницу событий в Инспекторе Объектов. Вы увидите, что в списке его событий 


‘ 
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появилось событие OnClear. Дважды щелкните на его правом окне и вы увидите в 
тексте модуля заготовку для обработчика этого события: 


void,  fastcall TForml::EditLetNum1lClear(TObject *Sender) 


{ 
} 


Внесите в этот обработчик какой-нибудь оператор, который бы отображал на 
экране факт свершения этого события, например: 


ShowMessage ("Событие ОпС1еаг"); 


Проверьте ваше тестовое приложение в работе. 

Мы рассмотрели простейший вариант задания события типа TNotifyEvent. 
Попробуем несколько усложнить это событие. Пусть мы будем передавать в это со- 
бытие параметр CanClear, который по умолчанию равен true, что будет означать 
разрешение очистить текст окна редактирования. Но предоставим пользователю 
возможность в своем обработчике события задать этому параметру значение false, 
что будет означать отказ от очистки. 

Чтобы решить эту задачу, вам надо объявить новый тип события. Это объявле- 
ние делается с помощью ключевого слова __Cclosure. Пусть, например, вы хотите 
дать вводимому новому типу событий имя TClear. Тогда объявление указателя на 
этот тип может иметь вид: 


typedef void _fastcall ( с1озиге *TClear) 
(System: :TObject *Sender, bool& CanClear) ; 


Приведенный код объявляет указатель на функцию, принимающую два пара- 
метра: традиционный для всех обработчиков параметр Sender и булев параметр 
CanClear, который пользователь сможет изменять. 
| Приведенное выше объявление типа должно помещаться перед описанием 
класса. Тогда в объявлениях свойства и его поля надо ссылаться на этот тип, сле- 
дующим образом изменив соответствующие операторы: 


TClear FOnClear; 


__property TClear OnClear = {read=FOnClear, write=FOnClear}; 


Осталось изменить метод Clear так, чтобы в нем учитывался новый параметр 
CanClear: 


void _fastcall TEditLetNum: :Clear() 
{ 
bool CanClear = true; 
if (OnClear) OnClear(this,CanClear) ; 
if (CanClear) 
{ 
TEdit::Clear(); // Вызов родительского метода 
FModified = false; 
} 
} 


В этой функции вводится булева переменная CanClear. При наличии обработ- 
чика пользователя он вызывается и CanClose передается в этот обработчик в каче- 
стве второго параметра. Затем в зависимости от значения CanClose вызывается 
или не вызывается родительский метод очистки OnClear. 

Теперь ваш компонент завершен. Полный текст его файлов имеет следующий вид. 


Файл EditLetNum.h: 


// Объявление типа события 
typedef void _fastcall ( closure *TClear) 
(System: :TObject *Sender, boolé CanClear) ; 
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class PACKAGE TEditLetNum : public TEdit 
{ 
private: 
// Закрытые элементы-данные класса 
bool FEnableLet; 
bool FEnableNum; 
bool FModified; 
TClear FOnClear; 
protected: J 
// Защищенные методы записи 
void _fastcall SetEnableLet (bool AEnableLet); 
void _fastcall SetEnableNum(bool AEnableNum) ; 
// Переопределение метода KeyPress 
DYNAMIC void _fastcall KeyPress(char &Кеу); 
public: 
// Объявление конструктора 
__fastcall TEditLetNum(TComponent* Owner) ; 
// Объявление метода Clear 
virtual void __fastcall Clear (void) ; 
// Свойство только времени выполнения 
_ property bool Modified = {read=FModified, default=false}; 


__ published: 
// Свойства компонента, включаемые в Инспектор Объектов 

_ property bool EnableLet = {read=FEnableLet, 
; write=SetEnableLet, 
default=true}; 
{read=FEnableNum, 
write=SetEnableNum, 
default=true}; 
{read=FOnClear, write=FOnClear}; 


_ property bool EnableNum 


_ property TClear OnClear 
}; 


Файл EditLetNum.cpp: 


static inline void ValidCtrCheck(TEditLetNum *) 
{ 

new TEditLetNum(NULL) ; 
} 


= 
__fastcall TEditLetNum: : TEditLetNum(TComponent* Owner) 


TEdit (Owner) 
{ 
FEnableLet = true; 
FEnableNum = true; 
FModified = false; 
} 
ии 
namespace Editletnum 
{ 
void _fastcall PACKAGE Register () 
{ 3 
TComponentClass classes[{1] = {__classid(TEditLetNum) }; 
RegisterComponents («MyComponents», classes, 0); 


} 
ито ион 
void _fastcall TEditLetNum: :SetEnableNum(bool AEnableNum) 
i 
//Присваивание значения полю FEnableNum 
FEnableNum = AEnableNum; 
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// Если значения FEnableNum и FEnableLet = false, 
// то полю FEnableLet присваивается true 
if (! AEnableNum) 
if (! FEnableLet) FEnableLet = true; 
} 
НЕЕ ОЗ аа 
void  fastcall TEditLetNum: :SetEnableLet (bool AEnableLet) 
{ 
//Присваивание значения полю FEnableLet 
FEnableLet = AEnableLet; 


// Если значения FEnableNum и FEnableLet = false, 
// то полю FEnableNum присваивается true 
if (! AEnableLet) 
if (! FEnableNum) FEnableNum = true; 
} 
0 0 eee 
void _fastcall TEditLetNum: :Clear (void) 
{ 
bool CanClear = true; 
if (OnClear) OnClear(this,CanClear); 
if (CanClear) 
{ 


TEdit: :Clear (.) ;° // Вызов родительского метода 
FModified = false; 
} 
} 
[LOI IEEE 
void _fastcall TEditLetNum: :KeyPress(char &Кеу) 
{ | 
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if ((! FEnableNum) && (Dig.Contains (Кеу))) 
Кеу = 0; | 

if ((! FEnableLet) && ! (Dig.Contains (Key) )) 
Key = 0; 

if (Key != 0) FModified = true; 


TEdit: :KeyPress (Key) ; 

, 

Откомпилируйте этот код. Теперь надо изменить тестирующее приложение. 
Возможный вид его уже был представлен ранее на рис. 7.5. Только раньше не по- 
яснялось назначение еще одного индикатора CheckBox (назовем ero CBClear), око- 
ло которого написано «Очистка». Он предназначен для задания значения Сап еаг 
в обработчике события OnClear. Поэтому по сравнению с прежним приложением 
надо изменить обработчик Оп Щеаг, добавив в него анализ того, установлен фла- 
жок в индикаторе СВ еаг, или нет (анализ свойства Checked). Но тут вы столкне- 
тесь с трудностью, если тестовое приложение делаете не заново, а изменяя преды- 
дущее. По сравнению с прошлым вариантом компонента в функцию обработчика 
добавился параметр. Поэтому прежний обработчик события OnClear будет выда- 
вать вам синтаксические ошибки. Надо или уничтожить его и написать новый, 
или вручную исправить заголовки в объявлении обработчика и в его реализации, 
которая может иметь вид: 


void _fastcall TForml::EditLetNumlClear(TObject *Sender, 
bool &CanClear) 


{ 
. ShowMessage ("Событие OnClear") ; 
CanClear = CBClear->Checked; 
EditLetNuml->SetFocus () ; ` 
} 


15 Зак 322 
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В этом обработчике значение параметра CanClear, разрешающего или запре- 
щающего очистку, задается в зависимости от того, установлен или нет индикатор 
CBClear. 

Вот и все. Не забудьте только согласовать исходные значения параметров 
EnableNum и EnableLet с исходными состояниями индикаторов CBNum и CBLet. 
Если, например, вы установили EnableNum в true, a EnableLet в false, то индика- 
тор CBNum должен быть включен (свойство Checked = true), а индикатор CBLet — 
выключен. 

Запустите приложение и убедитесь в правильной работе вашего компонента. 


7.3.6 Автоматизация разработки классов в C++Builder 5 


Выше было рассмотрено, как вводить новые свойства и методы в компонент 
вручную. Однако в C++Builder 5 появился инструмент, который помогает автома- 
тизировать этот процесс. Этот инструмент встроен в окно Исследователя Классов 
ClassExplorer (см. раздел 2.5.3.2). Опробуйте его в работе. Чтобы не портить соз- 
данный вами полезный компонент, начните все с начала: создайте новый пакет ив 
нем — новый компонент (см. раздел 7.3.1). А теперь попробуйте создать в нем но- 
вые свойства, методы события, пользуясь возможностями Исследователя Классов. 

Если окно Исследователя Классов у вас не открыто, выполните команду View | 
ClassExplorer. Щелкните в окне ClassExplorer правой кнопкой мыши. Bo всплыв- 
шем меню вы увидите новые разделы контекстного меню: New Field (новое поле), 
New Property (новое свойство), New Method (новый метод). Давайте начнем с раздела 
New Property и попробуем с его помощью ввести в класс компонента свойство 
EnableLet, которое мы вводили раньше вручную. После выбора раздела New 
Property перед вами откроется окно, представленное на рис. 7.7. Введите в нем в 
BepxHeé окошко Property Мате имя свойства — EnableLet. В выпадающем списке 
Туре выберите тип вводимого свойства — в нашем случае тип bool. В выпадающем 
списке Add to Class вы можете выбрать класс, объявленный в проекте, в который 
вводится свойство. Группа радиокнопок Visibility sagaer доступ к свойству: public, 
private, protected или published. В нашем случае надо включить кнопку published. 


Рис. 7.7 
Окно задания нового свойства 
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Установка‘ индикатора ‘create field приводит к; автоматическому созданию в 
классе зарытого (private) поля, соответствующего вводимому свойству. Имя поля 
по умолчанию соответствует имени свойства с добавленным ля символом "Е". 
Впрочем, вы можете изменять это имя, как вам угодно. 

Чтение свойства может быть задано несколькими оное ыыы Если вы устано- 
вите индикатор use this field for the read spesifier (установив предварительно create 
field), то значение свойства будет определяться значением созданного поля без вве- 
дения в класс функции чтения. Вы можете вместо этого установить индикатор 
create Get method. Тогда в класс будет включено объявление закрытого (private) ме- 
тода чтения. При этом надпись индикатора use this field for the read spesifier сменится 
на use this field for implementing the Get method — использовать данное поле для реали- 
зации функции чтения. Если вы установите этот индикатор, то в созданный метод 
чтения автоматически занесется оператор, возвращающий значение поля. Третья 
возможность задания функции чтения, если она вами уже реализована или если 
результат должен быть равен значению какого-то из ранее веденных полей (пере- 
менных) — выбрать функцию или поле из выпадающего списка’ Reads. | 

Одна из указанных выше возможностей должна быть реализована вами. Ина- 
че кнопка ОК окна рис. 7.7 не станет доступна и вы не сможете Sane pIRET работу 
по созданию свойства. 

В нашем случае мы не собираемся создавать специальную ‚функцию. чтения. 
Поэтому надо включить индикатор use this field for the read spesifier, 

Запись значения свойства также может быть задана несколькими способами. 
Если вы, установив предварительно create field, установите затем индикатор use this 
field for the write spesifier (Ha рис. 7.7 этот идентификатор не виден, так как реализо- 
ван другой вариант записи), то значение свойства будет равно значению созданно- 
го поля без введения в класс функции записи. Если вы вместо этого установить ин- 
дикатор create Set method, то в класс будет включено объявление закрытого 
(private) метода записи. При этом, как и для случая чтения, надпись индикатора 
use this field for the write spesifier сменится на use this field for implementing the Set method — 
использовать данное поле для реализации функции записи. Если вы установите 
этот индикатор, то в созданный метод записи автоматически занесется вариант 
реализующего его оператор, который будет рассмотрен позднее. Третья возмож- 
ность задания функции записи; если она вами уже реализована или если результат 
должен быть равен значению какого-то из ранее веденных полей (переменных) — 
выбрать функцию или поле из выпадающего списка Writes. Если вы не восполь- 
зуетесь ни одним из этих способов задания записи значения свойства, то свойство 
будет только для чтения. 

Если при задании способов чтения и записи свойства вы используете списки 
Reads и Writes, вы можете предварительно кнопкой с многоточием около надписи 
Implement т выбрать файл, в котором реализованы функции, если это не TOT файл, в 
котором объявлен класс. Можно также просто исправить имя hia щелкнув 
курсором на его имени около этой надписи. 

Если при задании функций чтения или записи вы воспользовались индикато- 
рами create Get method или create Set method, вам станет доступен соответственно HH- | 
дикатор Implement Get using member usu Implement Set using member. Включив ero, вы 
можете выбрать реализацию из выпадающего списка данных-элементов и функ- 
ций-элементов класса. 

В нашем случае следует включить индикатор create Set method и индикатор use 
this field for implementing the Set method. 

Окошко Array используется для задания свойства типа массива. Окошко Index 
используется для индексированных свойств. В окошко Stored может заноситься 
значение директивы спецификации класса памяти. Окошко Default используется 
для задания в свойстве директивы запоминания default. 
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После того, как вы установили в окне рис. 7.7 всю необходимую информацию, 
можете щелкнуть на ОК для выхода из окна или на Арру для внесения в код задан- 
ных установок и продолжения работы в диалоговом окне. В окне Исследователя 
Классов отобразятся созданные вами поле, свойство и функция записи. 

В нашем случае это будет выглядеть так. В заголовочный файл в объявление 
класса внесутся операторы: 


class PACKAGE TEditLetNum : public TEdit 
{ 


private: 
bool FEnableLet; 
void _fastcall SetEnableLet (bool value); 


__ published: 
_ property bool EnableLet = { read=FEnableLet, write=SetEnableLet, 
default=true }; 


}; 

Как видите, объявления, которые мы раньше записывали вручную, создались 
автоматически. Отличие только в том, что функция записи включилась в раз- 
дел private, а мы вносили ее в раздел protected. Если требуется, ее объявление лег- 


ко перенести в protected вручную. 
В файл реализации занесутся операторы: 


void _fastcall TEditLetNum: :SetEnableLet (bool value) 
{ 
if(FEnableLet != value) { 
FEnableLet = value; 
} 
} 


Это заготовка реализации функции записи с уже внесенным в нее оператором 
записи. Конечно, вы можете дополнить этот оператор необходимыми действиями 
или вообще вместо автоматически созданного оператора ввести свои операторы. 
Появление оператора в реализации функции связано с тем, что в окне 7.7 был 
включен индикатор use this field for implementing the Set method. Если бы мы его не 
включали, то заготовка реализации функции записи имела бы вид: 


void _ fastcall TEditLetNum: :SetEnableLet (bool value) 


{ , 
//TODO: Add your source code here 


} 


В этом случае на месте, где должен быть код реализации функции, занесся бы 
оператор To-Do List (см. раздел 2.4.4.1). Он обеспечит отображение соответствую- 
щей строки в окне То-Шо List, которая будет напоминать вам о необходимости завер- 
шить кодирование функции SetEnableLet. 

Теперь рассмотрим другой раздел всплывающего меню С]аззЕхр]огег. — New 
Method (новый метод). Используем его для объявления в нашем компоненте метода 
Clear. При выборе раздела New Method перед вами откроется окно, показанное на 
рис. 7.8. 

В верхнем окошке Method Мате вы должны написать имя создаваемого мето- 
да — в нашем случае Clear. В выпадающем списке Add to Class вы можете выбрать 
класс, объявленный в проекте, в который вводится свойство. В окошко Arguments 
вам надо занести список аргументов функции в том виде, в котором он должен поя- 
виться в скобках ее объявления. Радиокнопки группы Method Туре позволяют за- 
дать тип создаваемого метода: Function — функция, Constructor — конструктор, 
Destructor — деструктор. 
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Рис. 7.8 
Окно задания нового метода 


Если вы включили кнопку Function, то становится доступным выпадающий 
список Function Result, позволяющий задать тип возвращаемого функцией значения 
(в нашем случае void). Для конструкторов и деструкторов этот список недоступен, 
поскольку эти методы не возвращают никаких значений. 

Если вы включили кнопку Constructor или Destructor, то имя в окошке Method 
Мате автоматически заменится на принятое соответственно для конструктора или 
деструктора. 

Группа радиокнопок \У!5Ну задает доступ к методу: public, private, protected 
или published. 

Группа индикаторов > et Meat позволяет задать спецификаторы объявления 
метода. Их смысл ясен из надписей около индикаторов. Если вы включите индика- 
тор Message Handler, это будет означать, что вы хотите создать обработчик сообще- 
ния Windows. Тогда станет доступен выпадающий список, содержащий перечень 
сообщений Windows, в котором вы можете выбрать нужное сообщение. Пример, 
использующий индикатор Message Handle, приведен в разделе 6.3.3. 

Группа индикаторов Implementation details позволяет установить особенности 
реализации метода. Индикатор Call inherited позволит автоматически внести в реа- 
лизацию метода оператор вызова наследуемого метода с тем же именем. Индика- 
тор Inline обеспечивает создание функции со спецификацией inline — встраивае- 
мая. При включении этого индикатора становится доступным индикатор Implicit 
Inline. Если этот индикатор оставить не включенным, то в объявление функции в 
классе добавится спецификатор inline, а реализация функции буде помещена в 
файл реализации модуля. Если же вы включите индикатор Implicit Inline, то описа- 
ние функции будет совмещено с ее объявлением в классе. Вообще говоря, это пло- 
хой стиль программирования, так как следует избегать смешения открытого ин- 
терфейса класса, содержащегося в его объявлении, и реализации класса. 

Давайте посмотрим, к чему приводит работа с описанным окном. При установ- 
ках, показанных на рис. 5.8, в описание класса компонента будет включено объяв- 
ление нового открытого метода: 


class PACKAGE TEditLetNum : public TEdit 
{ 
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public: 


virtual void _fastcall Clear(); 
}; 
В файл реализации будет включена заготовка нового метода: 


void _fastcall TEditLetNum2::Clear() 
{ 
TEdit::Clear(); 
} | 
Как видите, в реализацию уже внесен оператор вызова метода базового класса. 
Это следствие включенного в окне рис. 7.8 индикатора Call inherited. Если бы этот 
индикатор не был включен, то вместо этого оператора появилась бы строчка: 


//TODO: Add your source code here 


Это оператор To-Do List (см. раздел 2.4.4.1). Он обеспечивает отображение со- 
ответствующей строки в окне То-ОШо List, которая будет напоминать вам о необходи- 
мости завершить кодирование функции. 

Рассмотрим некоторые дополнительные возможности окна рис. 7.8. Если бы 
вы задали создание некоторой защищенной функции FProtect с возвращаемым ти- 
пом void и включили индикатор inline, не включая Implicit Inline, то в раздел ргофес- 
ted класса включилось бы объявление 


void inline FProtect(); 
а в файл реализации модуля записался бы текст: 
void inline TForml::FProtect () 


{ 


} 


т.е. была бы создана встраиваемая функция, в которой ее объявление отделено OT 
описания. А если бы для этой функции вы включили индикатор Implicit Inline, то для 
нее в раздел protected объявления класса включился бы код: 

protected: 


void FProtect () 
{ 


//TODO: Add your source code here 


//TODO: Add your source code here 
} 


Таким образом, в этом случае функция также была бы объявлена как встраи- 
ваемая, но ее объявление и реализация были бы объединены. 

Мы рассмотрели команды New Property и New Method контекстного меню 
ClassExplorer. Команда New Field позволяет ввести в описание класса новое поле. 
Она очень проста, так что ее использование не вызовет у вас проблем. 

Рассмотренные команды ClassExplorer показывают, какой прекрасный инст- 
румент подарила нам фирма Borland в C++Builder 5, введя новые возможности в 
Исследователь Классов. Он, несомненно, позволит экономить нам немало времени 
при разработке новых классов и избегать множества случайных ошибок. 


7.4 Депозитарий — хранилище форм, 
фреймов и проектов 


В Депозитарий (хранилище — Repository) вы попадаете, когда выполняете ко- 
манду File | New. При этом открывается диалоговое окно New Нетз, в котором вы мо- 
жете выбрать включенные в C++Builder готовые формы или воспользоваться раз- 
работанными фирмой Borland мастерами. Все эти возможности подробно рассмот- 
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рены в главе 2. А в данном разделе мы остановимся на использовании Депозитария 
для хранения собственных разработок. 

Нередко создание сложной формы с множеством размещенных на ней компо- 
нентов требует немалого времени. Причем однажды разработанная удачная форма 
может пригодиться вам в последующих приложениях. Конечно, можно сохранить 
ее в каком-либо каталоге и, когда возникнет необходимость, использовать в оче- 
редном проекте. Но если разработка этого нового проекта будет не скоро, вы, воз- 
можно, потратите много времени на поиск каталога с необходимой вам формой, 
если вообще найдете ее. Хотелось бы иметь возможность как-то зарегистрировать 
свои удачные разработки в C++Builder, чтобы в дальнейшем без труда повторно их 
использовать. Такую возможность и предоставляет вам Депозитарий. Кроме того в 
Депозитарии можно хранить фреймы (см. раздел 3.7.8) — фрагменты, включаю- 
щие в себя какие-то компоненты. 

Депозитарий позволяет не просто хранить формы, но и наследовать их, т.е. 
создавать иерархию форм. Это важно, поскольку в сложном приложении, содер- 
жащем много форм, все эти формы должны быть спроектированы в едином стиле, 
с единообразным расположением органов управления, ввода и редактирования 
данных, в единой цветовой гамме и т.п. Это легко делается созданием иерархии 
форм. 

Пусть, например, вы решили, что основные окна вашего приложения должны 
иметь вид, представленный на рис. 7.9. Окна состоят из двух панелей с перемещае- 
мыми границами, в которых будут размещаться окна редактирования и списки, 
ниже них — панель, в которой будут располагаться кнопки управления, а внизу 
окна должна быть панель состояния. На форме должен также размещаться невизу- 
альный компонент ApplicationEvents, в обработчике события OnHint которого за- 
писан оператор, обеспечивающий отображение подсказок в панели состояния (под- 
робнее об этом см. в разделе 4.1.9). Все необходимые свойства панелей установле- 
ны, написаны операторы, обеспечивающие вывод на панель состояния подсказок, 
Задано имя формы (Name) — FBase. 

Имеет смысл сохранить эту форму в Депозитарии и в дальнейшем использо- 
вать для создания на ее основе различных конкретных форм вашего приложения. 
Но перед этим сохраните модуль вашей формы. Для этого можно выполнить ко- 
манду File | Save As. Сам проект можно не сохранять. При сохранении укажите имя 
файла ОЕВазе. 


Рис. 7.9 
Вид основного окна приложения, включаемого в 
Депозитарий 


Записать форму в Депозитарий можно следующим образом. Прежде всего 
щелкните на вашей форме правой кнопкой мыши и выберите во всплывшем кон- 
текстном меню раздел Add To Repository. Откроется диалоговое окно, вид которого 
приведен на рис. 7.10. В верхнем окне Title вы должны написать название вашей 
формы — подпись под ее пиктограммой при входе в Депозитарий. В следующем 
окне — Description можете написать более развернутое пояснение. Его может уви- 
деть пользователь, войдя в Депозитарий, щелкнув правой кнопкой мыши и выбрав 
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BO всплывшем меню форму отображения View Delails. В выпадающем списке Page 
вы можете выбрать страницу Депозитария, на которой хотите разместить пикто- 
грамму своей формы. Впрочем, вы можете указать и новую страницу с новым заго- 
ловком (Мои формы на рис. 7.10). В результате она появится в Депозитарии. 

В окне Author вы можете указать сведения о себе как об авторе. Наконец, если 
стандартная пиктограмма вас не устраивает, вы можете выбрать другую, щелкнув 
на кнопке Browse. После выполнения всех этих процедур щелкните на кнопке ОК и 
ваша форма окажется включенной в Депозитарий. 


Рис. 7.10 Add То Repository 
Окно добавления формы в 
Депозитарий 


{3 панели,разделитель, панель состояния.подсказки 


Теперь вы можете использовать ее в последующих ваших приложениях. Для 
этого вам надо будет выполнить,команду File | Мем и в открывшемся диалоговом 
окне New Items отыскать вашу форму (рис. 7.11). 


Рис. 7.11 < Мен Items — 
Окно New Items с включенной новой формой 5 


В нижней части окна расположены три радиокнопки, которые определяют, 
как именно вы хотите заимствовать форму из Депозитария: Сору — копировать, 
Inherit — наследовать, Use — использовать. Если включена кнопка Copy, то файлы 
формы просто будут скопированы в ваше приложение. При этом никакой дальней- 
шей связи между исходной формой и копией не будет. Вы можете спокойно изме- 
нять свойства вашей копии и это никак не отразится на форме, хранящейся в Де- 
позитарии. А если вы в дальнейшем что-то измените в форме, хранящейся в Депо- 
зитарии, то эти изменения никак не затронут вашего приложения, куда вы до это- 
го скопировали форму. 

При включенной кнопке Inherit вы получите в своем проекте форму, наследую- 
щую размещенной в Депозитарии. Это значит, что если вы что-то измените в фор- 
ме, хранящейся в Депозитарии, то это отразится при перекомпиляции во всех про- 
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ектах, которые наследуют эту форму. Однако, изменения в наследуемых формах 
никак не скажутся на свойствах формы, хранящейся в Депозитарии. 

При включенной кнопке Use вы получите режим использования. В этом слу- 
чае в ваш проект включится сама форма, хранящаяся в Депозитарии. Значит лю- 
бое изменение свойств формы, сделанное в вашем проекте, отразится и на храня- 
щейся в Депозитарии форме, и на всех проектах, наследующих или использующих 
эту форму (при их перекомпиляции). 

Таким образом, режим Inherit целесообразно использовать для всех модулей ва- 
шего проекта, а режим Use — для изменения базовой формы. Тогда усовершенство- 
вание вами базовой формы будет синхронно сказываться на всех модулях проекта 
при их перекомпиляции. 

Давайте построим приложение, которое позволит все это продемонстрировать. 
Если вы проделали процедуры по включению формы в Депозитарий, то можете 
приступать к построению тестового проекта. А если нет — проделайте эти процеду- 
ры сейчас. Если не хочется делать форму такую, как было описано, сделайте более 
простую, но содержащую 2 панели — они нам потребуются для дальнейшего. 
Только сотрите надписи на них (Caption). 

Итак, построим проект, демонстрирующий различные режимы извлечения 
формы из Депозитария. 


1. Откройте новый проект. 


2. Выполните команду Project | Remove from Project и удалите модуль Unitl и ero 
форму из проекта. 


3. Выполните команду File | New и в окне New Items отыщите вашу форму. Вклю- 
чите индикатор Сору (он включен по умолчанию) и щелкните на кнопке ОК. 


4. Измените имя новой формы вашего приложения на ЕСору (переименование 
формы необходимо, т.к. без этого далее невозможно будет заимствовать из Де- 
позитария аналогичные формы). 


5. Повторите команду Не | New, в окне New Items опять отыщите вашу форму. 
Включите индикатор Inherit и щелкните на ОК. 


6. Измените имя новой формы вашего приложения Ha FInherit. 


7. Повторите в третий раз команду File | New и поиск в окне New Items вашей фор- 
мы. На этот раз включите индикатор Use и щелкните на ОК. 


Теперь взгляните на имена модулей, появившихся в вашем проекте. Для двух 
первых форм модули имеют традиционные имена — Unitl и Unit2. A вот имя 
третьего модуля совпадает с тем, под которым вы сохранили модуль формы перед 
записью в Депозитарий — UFBase. Это значит, что C++Builder в режиме Use вклю- 
чил в ваше приложение исходный модуль хранящейся в Депозитарии формы. И, 
значит, любые изменения в нем приведут к изменению хранящейся формы. 

Давайте сохраним проект, чтобы задать первым двум модулям более осмыс- 
ленные имена. 


8. Сохраните проект, задав имя файла первого модуля — UCopy, а имя второ- 
го — UInherit. Имя файла проекта можете задать любым. 


9. Разнесите формы на экране так, чтобы видеть хотя бы заголовки каждой (на- 
пример, каскадом). . 

10. Выполните команду Project | Options. Установите все формы проекта автомати- 
чески создаваемыми. 


11. Во всех формах установите значение свойства Visible в true, чтобы при запус- 
ке приложения все они были видны. 


Приложение завершено. Сохраните его и запустите. Вы увидите на экране три 
одинаковые окна, различающиеся только заголовками. Закройте приложение 
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(окно FCopy). Измените что-нибудь в форме ЕСору. Например, введите текст «Ле- 
вая» в надпись (Caption) левой панели. Сохраните проект и запустите опять прило- 
жение. Вы увидите, что на форме ЕСору появилась введенная вами надпись, а па- 
нели остальных форм по-прежнему пустые. Это очевидный результат, поскольку 
форма FCopy содержится в модуле UCopy, являющемся изолированным от всех ос- 
тальных, хотя и создан как копия базового модуля UBase. 

Закройте приложение, сотрите надпись на панели в форме ЕСору и сделайте 
аналогичную надпись «Левая» на панели формы FInherit. Сохраните и запустите 
опять приложение. Вы увидите, что на форме FInherit появилась введенная вами 
надпись, а панели остальных форм по-прежнему пустые. 

Опять закройте приложение и, не стирая надпись в левой панели формы 
FInherit, сделайте надпись «Правая» в правой панели третьей формы FBase. Со- 
храните и запустите приложение. Вы увидите (рис. 7 12), что на форме ЕВазе поя- 
вилась введенная вами надпись. А на форме Finherit имеются надписи на обеих 
панелях. Надпись на левой введена в модуле этой формы; а надпись на правой па- 
нели наследуется из’базового модуля UBase. Таким образом, в наследуемых фор- 
мах те свойства, которые были изменены в процессе проектирования, так и оста- 
ются неизменными. А остальные наследуются из базовой формы. 


Рис. 7.12 
Тестирование различных режимов 
заимствования форм из Депозитария 


В этом и заключаются положительные стороны наследования форм. Если вы 
построили различные формы вашего приложения (настоящего, а не этого тестово- 
го) наследованием, то изменив родительскую форму (например, изменив в ней раз- 
меры панелей или добавив какие-нибудь кнопки), вы автоматически внесете эти 
изменения и во все производные формы. Правда, эти изменения проявятся только ' 
при перекомпиляции вашего приложения. 

Но у наследования есть и отрицательные свойства. Попробуйте в вашем при- 
ложении удалить в форме Е тег одну панель. Сделать это невозможно, так как 
C++Builder выдаст сообщение об ошибке. Однако, этот недостаток можно обойти. 
В производной форме можно сделать ненужные компоненты невидимыми 
(Visible = false) и недоступными (Enabled = false). Тогда они как бы исчезнут с 
формы. 

‚Мы рассмотрели включение в Депозитарий форм и их использование. Точно 
так же, начиная с C++Builder 5, можно включать в Депозитарий и аналогичным 
образом использовать фреймы (см. главу 3 раздел 3.7.8). Это дает дополнительные 
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возможности организовывать иерархию не только форм, но и типовых фрагментов 
форм — панелей. 

В Депозитарий можно включать не только формы и фреймы, но и целые про- 
екты. Если вы хотите включить в него ваш проект, откройте его и выполните ко- 
манду Project | Add To Repository. Дальнейшие действия аналогичны тем, которые вы 
выполняли при включении в Депозитарий формы. Отличие проекта от формы при 
их заимствовании из Депозитария состоит в том, что проект можно взять оттуда 
только в режиме Сору, т.е. скопировать его и далее сохранить под другим именем. 
Если вы хотите взять проект, хранящийся в Депозитарии, то начать работу надо не 
с привычной команды File | New Application, а с команды File | New. Вы выбираете 
проект из Депозитария и сразу же открывается диалоговое окно с предложением 
указать каталог, в котором вы хотите сохранить копию проекта. После этого може- 
те обычным образом работать с этой копией и менять в ней все, что вам захочется. 

Если какие-то формы и фреймы, хранящиеся в Депозитарии, стали вам не 
нужны, вы можете удалить их в диалоговом окне, открывающемся при выполне- 
нии команды Tools | Repository (см. раздел 14.2.3 главы 14). В этом же окне вы може- 
те при желании сделать свою форму или проект, хранящиеся в Депозитарии, соот- 
ветственно формой или проектом по умолчанию. 


7.5 Динамически присоединяемые библиотеки DLL 


7.5.1 Назначение DLL 


Динамически присоединяемая библиотека DLL — это еще одна возможность 
повторного использования разработанных вами кодов. DLL — это специального 
вида исполняемый файл с расширением .dll, используемый для хранения функций 
и ресурсов отдельно от исполняемого файла. Обычно, когда вы пишете программу 
и создаете функции, ресурсы и т. п., все они компонуются в ваш исполняемый 
файл. Это называется статическим связыванием. Когда же вы используете DLL, 
то вызываемые из нее функции используются вашим модулем в процессе его вы- 
полнения. DLL делает полезные, часто используемые функции доступными сразу 
для многих приложений одновременно, хотя работа ведется только с одной ее ко- 
пией на диске и в памяти. Обычно DLL не загружается в память, пока это не станет 
необходимым, но, будучи однажды загружена, она делает свои функции и ресурсы 
доступными для любой программы. 

В этой книге неявным образом уже многократно использовались DLL. Напри- 
мер, именно в DLL хранятся все процедуры и функции АРТ Windows, которые 
очень часто применяются или непосредственно, или косвенно через аналогичные 
функции C++Builder, инкапсулирующие те или иные функции API Windows. В 
DLL хранятся также все стандартные диалоги Windows, которые вы, наверняка, 
постоянно используете чуть ли не в любом своем приложении. Так что с DLL вы 
уже знакомы очень тесно, хотя, может быть, и не подозреваете об этом. Но в этом 
разделе речь пойдет о других DLL — о библиотеках, создаваемых вами для хране- 
ния собственных кодов. 

Предположим, вы разработали различные полезные процедуры и функции и 
используете их в различных своих приложениях. Конечно, вы можете просто ско- 
пировать эти процедуры и функции в каждый ваш проект. Но тогда, если несколь- 
ко ваших приложений работает на компьютере одновременно, то копии ваших 
процедур загружены в память в выполняемом модуле каждого приложения и па- 
мять, таким образом, расходуется неэффективно. Да и затраты пространства на 
дисках также избыточны, поскольку эти процедуры в составе выполняемых моду- 
лей также тиражируются. Если же вы поместили свои процедуры в DLL, то все эти 
проблемы снимаются. 
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Создание DLL повышает также гибкость вашей программы. Например, вы мо- 
жете создать несколько библиотек, содержащих все используемые вашим прило- 
жением тексты — надписи, подсказки и т.п. Каждая из этих библиотек может со- 
держать тексты на том или ином языке: русском, английском, немецком. Тогда в 
зависимости от того, какую из этих библиотек будет применять пользователь, про- 
граммы будут общаться с ним на том или ином языке. 

Еще одним преимуществом DLL является то, что они могут использоваться 
приложениями, написанными на других алгоритмических языках. Например, вы 
можете использовать библиотеки, написанные Ha Object Pascal, Visual Basic, 
Access Basic и др. А ваши библиотеки, созданные в C++Builder, смогут использо- 
вать любые системы, которые умеют вызывать DLL, независимо OT того, на каких 
алгоритмических языках они написаны. 


7.5.2 Статическое и динамическое присоединение 
DLL к приложению 


Библиотеки DLL могут связываться с вашим приложением двумя путями: 
статическим присоединением или динамическим присоединением. 

Статическое присоединение означает, что DLL загружается сразу, как только 
начинает выполняться приложение, которое будет ее использовать. Это наиболее 
простой способ использования DLL. Вызов функций в приложении, использующем 
подобную DLL, почти не отличается от вызова любых других функций. Некоторы- 
ми недостатками такого подхода можно считать увеличение времени загрузки ва- 
шего приложения (ведь кроме выполняемого модуля приложения в этот момент 
грузятся и модули соответствующих DLL) и невозможность выполнения приложе- 
ния пользователем, у которого нет соответствующего файла DLL. Последнее труд- 
но назвать существенным недостатком, поскольку, конечно, вы должны распро- 
странять приложение вместе с DLL. Но ведь некоторые действия приложение мог- 
ло бы делать и без DLL, т.е. оно могло бы в урезанном виде функционировать и при 
отсутствии DLL. Однако, при статическом присоединении это невозможно. Еще од- 
ним недостатком статического присоединения является то, что DLL занимает па- 
мять все время, в течение которого выполняется приложение, независимо от того, 
вызываются ли в данном сеансе работы с приложением какие-то функции библио- 
теки, или нет. 

Статическое присоединение подразумевает, что для DLL создан специальный 
файл описаний импортируемых функций (import library file). Этот файл имеет TO 
же имя, что и соответствующая DLL, и расширение .lib. Этот файл .lib должен 
быть связан с вашим приложением на этапе компиляции. 

Динамическое присоединение отличается от статического тем, что библиотека 
DLL загружается только в тот момент, когда необходимо выполнить какую-то хра- 
нящуюся в ней функцию. Затем эту библиотеку можно выгрузить из памяти. Это 
обеспечивает, конечно, более эффективное использование памяти. Но зато вызов 
соответствующих функций библиотеки существенно усложняется, да и время вы- 
зова тоже увеличивается из-за необходимости загружать и выгружать библиотеку. 

Для вызова библиотечной функции из библиотеки, присоединяемой подобным 
образом, надо прежде всего загрузить библиотеку функцией LoadLibrary API 
Windows. Затем с помощью функции GetProcAddress надо получить указатель на 
интересующую вас функцию библиотеки. Только после этого можно выполнять 
функцию. А затем с помощью функции FreeLibrary надо выгрузить библиотеку из 
памяти. Пусть, например, вы создали библиотеку туаП.ай, содержащую некото- 
pyro функцию MyFunction(). Тогда для использования этой функции при динами- 
ческом присоединении библиотеки вам надо. предусмотреть в своем приложении 
следующее. Вы должны объявить указатель на эту функцию. Например: 


void (_ stdcall *MyFunction) (HWIND) 
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Тогда операции с библиотекой могут строиться по следующей схеме: 


// загрузка DLL 
HINSTANCE dllInstance = LoadLibrary («mudll.dll») ; 


// получение адреса функции 
MyFunction = (void(_stdcall*) (HWIND) 
GetProcAddress(dllinstance, « MyFunction») ; 


// вызов функции 
MyFunction (Application->Handle) ; 


// выгрузка DLL 
FreeLibrary(dllinstance) ; 


Как видите, все это достаточно громоздко. Tak что если только нет острой He- 
обходимости использовать именно динамическое связывание, лучше всегда ис- 
пользовать статическое связывание. 


7.5.3 Создание DLL 


Создание своей DLL начинается с выполнения команды File | New и выбора в 
окне New Items на странице New пиктограммы DLL Wisard — Мастера DLL. Вы no- 
падете в небольшое диалоговое окно, представленное на рис. 7.13. В нем вы може- 
те выбрать язык DLL — С или С++. Индикатор Use VCL позволит вам создать DLL, 
которая может содержать компоненты библиотеки VCL. При этом в модуль вклю- 
чится файл VCL.h и установятся опции компоновки, обеспечивающие совмести- 
мость с объектами УСГ. Индикатор Multi Threaded позволит работать с несколькими 
потоками (нитями) выполнения. А индикатор VC++ Style DLL обеспечит создание 
DLL в стиле Microsoft Visual C++. 


Puc. 7.13 
Окно задания опций создания DLL 


После установки всех опций и щелчка на ОК вы попадете в окно Редактора 
Кода, в котором появится (при установках, показанных на рис. 7.13) следующий 
текст: 


#include <vcl.h> 

#pragma hdrstop 

7 a. aS У сое 

// Important note about DLL memory management when your DLL 
// uses the static version of the RunTime Library: 


// If your DLL exports any functions that pass String objects 
// (or structs/ classes containing nested Strings) as parameter 
// ог function results, you will need to ааа the library 

// MEMMGR.LIB to both the DLL project and any other projects 

// that use the DLL. You will also need to use MEMMGR.LIB 

// if any other projects which use the DLL will be perfomring 
// new or delete operations on any non-TObject-derived classes 
// which are exported from the DLL. Adding MEMMGR.LIB to your 
// project will change the DLL and its calling EXE's to use the 
// BORLNDMM.DLL as their memory manager. In these cases, the 
// file BORLNDMM.DLL should be deployed along with your DLL. 

// 
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‚ f/,TO,avoid:using. BORLNDMM.DLL,. pass string information using 
х // «char *» or ShortString parameters, 
// 7 
// If your DLL uses the dynamic version of the RTL, you do not 
// need to explicitly add MEMMGR.LIB as this will be done 
// implicitly for you 


(Комментарий гласит: Важноё замечание об организации памяти DLL, если 
ваша DLL использует статическую: версию библиотеки времени выполнения 
RunTime Library: 


Если ваша DLL экспортирует какие-то процедуры или функции, которым 
передаются в виде параметров или от которых получаются как результат 
объекты строк String (или структуры и классы, содержащие вложенные 
`’ строки), вы должны добавлять библиотеку MEMMGR.LIB как в прект DLL, так 
и в любой проект, использующий эту DLL. Вы должны также включать 
MEMMGR.LIB в’ любой проект, использующий операции создания (new) и 
удаления (delete) объектов экспортируемых из данной DLL классов, не 
‚ наследующих TObject., Добавление MEMMGR.LIB в ваш проект изменит DLL и 
`’ее вызовы’ Так, чтобы‘ для’распрёделения' памяти использовалась библиотека 
''ВОВЬМОММ. DLL — диспетчер разделяемой памяти. В этих случаях файл 
BORLNDMM:DLL ‘должен распространяться вместе с файлом вашей DLL. 
Чтобы избежать использования BORLNDMM.DLL, передавайте строковую 
информацию посредством параметров типа «Char *» или ShortString. 
Если ваша DLL использует динамическую версию RTL, то вам не надо явным 
образом ‘добавлять MEMMGR.LIB, так как это добавление будет сделано 
неявно.) 


0 ou FATS Wy Ета ON 
int WINAPI DllEntryPoint (HINSTANCE hinst, unsigned long reason, void*) 


| is 
return 1; 
} 
| Прежде всего обратите в этом коде внимание на длинный комментарий. Его 

суть сводится к тому. что при передаче в функцию и из функции строк желательно 
использовать тип (char *), а не, например, AnsiString. Это избавит и вас, и пользо- 
вателей вашей DLL от сложностей, связанных с необходимостью использовать 
borlndmm.dll. Например, пусть вы хотите включить в вашу DLL функцию, кото- 
рая воспринимает строку и ключ типа Char, и возвращает ее закодированной этим 
ключом. Кодировка проводится самая примитивная: сложением каждого символа 
строки с ключом по операции исключающее ИЛИ. Кстати, такая кодировка легко 
поддается декодированию: достаточно с закодированной строкой выполнить ту же 
операцию с тем же ключом, и вам вернется исходная строка. 

Эту функцию можно реализовать следующим образом: 

AnsiString Code(AnsiString $, char Key) 

{ 


for (int i = 1; i <= s.Length(); i++) 
$[1] = s[{i] * Key; 
return s; 


} 
Ho для включения в DLL лучше использовать другой тип строк: 
char * Code(char *s, char Key) 


{ 
for (int i = O; ; i++) 


=.'\0') break; 
$[1] = s[{i] ^ Key; 


return $; 


} 
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Обе приведенные функции выполняют аналогичные операции, но вторая He 
вызывает никаких сложностей при включении ее в DLL. 
Теперь обратите внимание в заготовке модуля DLL на строку 


#include <vcl.h> 


Она подключает заголовочный файл vel.h. Этот файл нужен, если вы исполь- 
зуете какие-то классы, формы, функции, связанные с библиотекой визуальных 
компонентов. В противном случае вы можете удалить этот оператор из текста DLL. 

В конце приведенного текста заготовки DLL используется функция ОИЕпйту- 
Point, необходимая для загрузки и выгрузки библиотеки. Она создает дескриптор 
hinst вашей DLL. Он требуется при выполнении некоторых функций, например, 
LoadIcon, LoadCursor и др. В этих случаях вы можете использовать параметр 
hinst для создания соответствующей глобальной переменной. 

Для того, чтобы уяснить последовательность построения и использования 
DLL, давайте теперь создадим DLL с именем MyDLL и включим в нее приведенную 
выше функцию Со4е. Выполните последовательно следующие шаги. 


1. Выполните команду File | New и выберите в окне New Items на странице New 
пиктограмму DLL Wizard. Сделайте в диалоговом окне установки, показанные 
на рис. 7.13. Вы попадете в окно Редактора Кода, куда будет загружен приве- 
денный ранее текст. 


2. Удалите из текста комментарий. 
3. Вставьте перед описанием директиву включения головного файла: 


#include «MyDLL.h» 
Файла MyDLL.h пока нет, но скоро вы ero создадите. 


4. Вставьте после описания DilEntryPoint приведенное выше описание своей 
функции Code. 


5. Сохраните ваш проект под именем MyDLL. 


В результате рассмотренных действий файл MyDLL.cpp примет следующий 
вид: 


#include <vcl.h> 

#pragma hdrstop 

И? 

#include «MyDLL.h» 

int WINAPI DllEntryPoint (HINSTANCE hinst, unsigned long reason, void*) 
{ 


return 1; 
} 
слоне чае Бот ореола навек 
char * Code Dec(char *s, char Key) 
{ 

for. (int 4 = 0; ; i++) 

{ 

if ($[1] == '\0') break; 

s{i] = s[{i] ^ Key; 

} 

return s; 


} 


Теперь давайте создадим заголовочный файл библиотеки. 


6. Выполните команду File | New и выберите в окне New ltems на странице New 
пиктограмму Header File. Вы попадете в окно Редактора Кода, куда будет за- 
гружен текстовый файл. 


7. Запишите в файл следующий код: 
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#ifndef MYDLL H 
#define MYDLL H 


#ifdef DLL _ 

# define DLL EI _declspec(dllexport) 
#else 

# define DLL EI — declspec(dllimport) 
#fendif 


extern «C» char * DLL EI Code Dec(char *s, char Key); 
#endif 


8. Сохраните файл командой File | Save с именем MyDLL.h. 


Давайте всмотримся в приведенный текст заголовочного файла. Посмотрите 
на фрагмент, начинающийся с директивы #ifdef. Использованный в нем иденти- 
фикатор DLL_EI может быть любым — это просто произвольный идентификатор. 
А логика работы данного фрагмента следующая: если определен идентификатор 
__DLL__, To идентификатор DLL_EI раскрывается как __declspec(dllexport); если 
же _ ПИТ _ не определен, то идентификатор DLL_EI раскрывается как __4ес- 
Ispec(dllimport). C++Builder автоматически определяет _DLL__ в случае, если 
создается проект DLL, и не определяет этот идентификатор при создании объекта 
приложения. Таким образом, в зависимости от того, включается ли заголовочный 
файл в библиотеку или в приложение, он будет выглядеть по-разному. При компи- 
ляции библиотеки строка, определяющая нашу функцию Code_Dec, после раскры- 
тия макроса будет восприниматься как | 


extern «С» char * _,declspec(dllexport) Code Dec(char *s, char Key); 


Здесь конструкция __ declspec(dllexport) означает, что функция может экс- 
портироваться из библиотеки, то есть может вызываться внешними приложения- 
ми. Подобным образом должны быть перечислены все функции DLL, предназна- 
ченные для прямого использования в приложениях. Помимо таких функций в 
DLL могут быть вспомогательные функции-утилиты, предназначенные только для 
использования другими функциями. Подобные утилиты не должны определяться 
как экспортируемые. 

Когда тот же заголовочный файл включается в приложение, то эта же строка 
после раскрытия макроса имеет другой вид: 


extern «С» char * _ аес1зрес (dllimport) Code Пес (спаг *s, char Key); 


Здесь конструкция __declspec(dllimport) означает, что функция импортирует- 
ся, то есть вносится в модуль из DLL. Таким образом один и тот же заголовочный 
файл может использоваться и при создании DLL, и в приложениях, обращающих- 
ся к данной DLL. 

Продолжим создание нашей DLL: 


9. Выполните команду Project | Options и в окне опций проекта на странице Linker 
убедитесь, что включен индикатор опции Generate import library. Эта опция 
обеспечит при создании DLL автоматическую генерацию файл .lib, необходи- 
мого для описанного ранее статического присоединения DLL к проектам. 


10. Выполните команду Project | Build MyDLL. В результате будут созданы файлы 
MyDLL.dll и MyDLL.I|ib. 


Если вы захотите теперь протестировать вашу DLL и выполните команду Run | 
Кип (F9), то получите сообщение: «Cannot debug project unless a host application is 
defined. Use Run|Parameters... dialog box». Это означает, что вы сначала с помощью KO- 
манды Run | Parameters должны определить хост — тестирующее приложение. Эта | 
процедура уже была нами рассмотрена при тестировании нового компонента (см. 
раздел 7.3.4 рис. 7.6). 
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Тестирующее приложение вы можете строить обычным способом, независимо 
от вашей DLL. Но мы рассмотрим ниже более удобный путь — объединение с помо- 
щью Менеджера Проектов модуля DLL и тестирующего проекта в одну группу. Это 
позволяет более гибко переключаться между отлаживаемой библиотекой и кодом 
теста. Итак, продолжим нашу работу с DLL и напишем тестирующее приложение. 


11. Выполните команду View | Project Manager. Перед вами откроется окно Менед- 
жера Проектов, представленное на рис. 7.14, но пока только с одной вершиной 
MyDLL. 


12. Нажмите кнопку New и в открывшемся окне Депозитария Ha странице New 
выберите пиктограмму Application. В окне Менеджера Проектов появится 
вершина, соответствующая создаваемому вами тестовому приложению 


13. Выполните команду File | Save Project As и сохраните ваш проект под каким-то 
именем (например, PTestDLL). 


14. Выделите в окне Менеджера Проектов вершину группы, щелкните правой 
кнопкой мыши и из всплывшего меню выберите команду Save Project Groupe 
As. Сохраните группу, например, под именем TestDLL. 


Рис. 7.14 
Окно Менеджера Проектов с 
загруженной DLL и тестом 


Fre) MyDLL E:\ARHS\SPRACBUILDER\Tests\DLL 
| 2] MyDLL.dill E:\ARH\SPRACBUILDER\Tests\DLL | 


BME Тез exe E:\ARH\SPRACBUILDER\Tests\DLL | 


15. Разместите на форме окно редактирования и кнопку (рис. 7.15). В обработчик 
щелчка на кнопке поместите, например, такой оператор: 


Еа91$1->Техе, = Code Dec (Editl->Text.c: str(),"A'); 


Он берет текст, занесенный пользователем в окно редактирования ЕЧИТ, коди- 
рует его с помощью нашей функции Code_Dec и возвращает закодированную стро- 
ку в Editl. 


Рис. 7.15 


Тестовое приложение DLL: исходный текст 


сходная строка текста 
в окне (а) и результат кодировки (6) 


16. Включите в модуль после директивы препроцессора #pragma hdrstop дирек- 
тиву, подключающую заголовочный файл библиотеки: 


#include "MyDLL.h" 


17. Осталось подключить к тестирующему приложению файл .lib, обеспечиваю-_ 
щий статическое присоединение библиотеки. Для этого прежде всего активи- 
зируйте в окне Менеджера Проектов ваше приложение. Это можно сделать 
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двумя способами: двойным щелчком на вершине тестирующего проекта, или 
выделением этой вершины и нажатием кнопки Activate (см. рис. 7.14). Затем 
щелкните правой кнопкой мыши и выберите из всплывшего меню команду 
Add. Во всплывшем диалоговом окне выберите шаблон файлов «Library file 
(.lib)» и выберите файл Му0!Т.. 15. Это обеспечит при запуске вашего прило- 
жения статическое присоединение библиотеки. Вы можете посмотреть, как 
это делается, выполнив команду View | Project Source. В появившемся в окне Pe- 
дактора Кода головном файле проекта вы увидите оператор 


USELIB("MyDLL.lib"); 


Именно этот оператор и обеспечивает статическое присоединение библиотеки 
MyDLL. 


Теперь все завершено. Вы можете сохранить проект, откомпилировать и вы- 
полнить его. Результаты работы этого приложения были показаны на рис. 7.15. За- 
несите в окно редактирования какой-то текст и нажмите кнопку. В окне появится 
абракадабра (рис. 7.15 6) — это закодированная, зашифрованная исходная строка. 
Нажмите кнопку повторно. В окне опять появится исходный текст (рис. 7.15 а) — 
результат декодирования (расшифровки) текста. 


7.6 Пакеты 


7.6.1 Общее описание концепции пакетов 


Вы уже использовали пакеты в предыдущих разделах, создавая новые компо- 
ненты. Но теперь давайте рассмотрим этот инструмент более подробно. 

Одним из основных достоинств C++Builder является то, что в результате про- 
ектирования создаются автономные выполняемые файлы .exe, т.е. приложение и 
все его ресурсы размещаются в одном выполняемом файле. Причем по сравнению с 
рядом других систем, позволяющих создавать автономные модули, размеры фай- 
лов в C++Builder достаточно небольшие. Автономный файл не требует наличия на 
компьютере пользователя не только среды C++Builder, но и каких-либо специаль- 
ных библиотек C++Builder. Так что при разработке отдельного проекта, конечно, 
целесообразно создавать такой автономный выполняемый файл. 

Однако, если у вас создано много выполняемых файлов или если вам надо пе- 
редавать их по сети множеству пользователей, то размеры файлов становятся су- 
щественным критерием разработки. Стремление уменьшить затраты на хранение 
и распространение выполняемых файлов привело фирму Borland к концепции па- 
кетов. 

Пакеты (Packages) — это специальные динамически присоединяемые библио- 
теки DLL, содержащие библиотеки визуальных компонентов и другие объекты, 
функции, процедуры и т.д. Эти DLL позволяют вам создавать очень небольшие вы- 
полняемые модули, обращающиеся за поддержкой к пакетам. Вы можете также 
скомпилировать в пакеты свои собственные компоненты и библиотеки. Файлы па- 
кетов имеют расширение „р! (Borland package library), чтобы отличать их от обыч- 
ных DLL. 

Пакеты разделяются на два типа: пакеты времени проектирования и пакеты 
времени выполнения. 

Пакеты времени проектирования C++Builder вызывает в процессе проектиро- 
вания. Эти пакеты используются для установки компонентов в палитре компонен- 
тов среды разработки C++Builder или для создания специализированного редакто- 
ра свойств для заказных компонентов. Пакеты времени проектирования не ис- 
пользуются приложениями; они используются только самой средой C++Builder. 
Так что на этих пакетах далее мы останавливаться не будем. _ 
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Пакеты времени выполнения содержат библиотеки визуальных компонентов 
C++Builder. Ниже будет рассказано, как вы можете узнать состав отдельных паке- 
тов и понять, какие пакеты используются в вашем приложении, а какие нет. 

Пакеты времени выполнения содержат библиотеки визуальных компонентов 
C++Builder. Вы можете добавить к C++Builder заказные пакеты, разработанные 
вами или где-то приобретенные. При использовании пакетов времени выполнения 
вы должны передавать пользователю не только ваш выполняемый модуль, но и все 
пакеты времени выполнения, которые используются им. За счет того, что большая 
часть кодов помещается в этих пакетах, размеры ваших выполняемых модулей су- 
щественно сокращаются. Например, модуль в 350 КБ может быть сокращен при- 
мерно до 22 КБ. Вы передаете пользователям один раз все пакеты и устанавливае- 
те их на компьютерах клиентов. А затем, когда вы делаете новые приложения, вам 
достаточно передавать только небольшие исполняемые модули. 

Так что у вас есть две альтернативы: 


Ш создавать законченные, автономные выполняемые модули 
Ш использовать поддержку пакетов времени выполнения 


Отдельно следует сказать об использовании пакетов времени выполнения в 
процессе разработки приложения. Значительный выигрыш в размерах файлов де- 
лает целесообразным в процессе разработки и отладки приложения использовать 
режим поддержки пакетов, чтобы не иметь дело с большими файлами. А при за- 
ключительной компиляции проекта можно принимать решение: допустимо ли по 
условиям эксплуатации вашего приложения использовать поддержку пакетов, 
или надо компилировать автономный модуль. 


7.6.2 Поддержка пакетов’ 


Чтобы использовать пакеты в вашем приложении, вы должны сначала обра- 
титься к поддержке пакетов, а затем компилировать и строить свое приложение. 
Поддержка пакетов определяется настройками соответствующих опций проекта. 
Для установки этих опций выполните команду Project | Options и в появившемся 
диалоговом окне опций проекта Project Options выберите страницу Packages — паке- 
ты. Ее вид показан на рис. 7.16. 


Рис. 7.16 Project Options 
Страница Packages окна опций проекта 
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В верхнем окне Design packages вы можете увидеть список используемых паке- 
тов времени проектирования. В частности, вы видите на рис. 7.16 строку пакета, 
созданного вами при проектировании нового компонента в разделе 7.3 (если, ко- 
нечно, вы его создавали). Вы можете добавить в список новые пакеты (кнопка Ада) 
или удалить пакет (кнопка Кетоуе или щелчок на окне индикатора рядом с выде- 
ленным пакетом). Впрочем, удалять системные пакеты вряд ли стоит. Лишние па- 
кеты никак не повлияют на ваше приложение. Но зато, когда вы захотите создать 
новое приложение с компонентами, хранившимися в удаленном пакете, вам это не 
удастся сделать. Впрочем, в этом случае вы можете вновь установить требуемый 
пакет кнопкой Add. 

Кнопка Edit (редактировать) доступна только если в окне Design packages выде- 
лен пакет, созданный вами. Для системных пакетов эта кнопка не доступна. 

Кнопка Components позволяет вам просмотреть список компонентов, храня- 
щихся в выделенном вами пакете. 

Индикатор Built with runtime packages устанавливает режим поддержки пакетов. 
Если этот индикатор установлен, то выполняемый модуль вашего приложения бу- 
дет требовать поддержки пакетов времени выполнения. При выключенном инди- 
каторе Built with runtime packages вы создадите полностью автономный выполняемый 
модуль. 

Индикатор Default позволяет принять установленную вами конфигурацию па- 
кетов по умолчанию для всех новых проектов. 

При изменениях списка в окне Design packages одновременно будет меняться и 
перечень пакетов времени выполнения Runtime packages в окне редактирования 
внизу. Для каждого конкретного приложения вы можете удалить из списка Design 
packages очень многие пакеты времени проектирования. Но никакого выигрыша в 
размере выполняемого модуля вы за счет этого не получите, поскольку C++Builder 
в любом случае не включит в модуль ничего лишнего. Однако, удаляя из этого спи- 
ска все лишнее и повторяя создание выполняемого модуля вы можете установить 
тот минимальный набор пакетов, который вы должны поставлять вместе с вашим 
приложением (конечно в случае, если вы используете поддержку пакетов). 

Чтобы почувствовать, что дают пакеты времени выполнения, проведите не- 
большой эксперимент. Постройте простейшее приложение C++Builder с пустой 
формой: 


1. Откройте новый проект. Сохраните его под именами по умолчанию рго- 
jectl.dpr и unitl.cpp. 


2. Выполните команду Project | Options. 


3. В раскрывшемся окне опций проекта Project Options выберите страницу Linker и 
выключите на ней индикатор Use dynamic RIL (использовать динамическое свя- 
зывание). Перейдите на страницу Packages и выключите на ней индикатор Built 
with runtime packages (строить с пакетами времени выполнения). Перейдите на 
страницу Сотйег и нажмите кнопку Release, обеспечивающую создание файла 
без отладочной информации (см. раздел 14.2.9.2 главы 14). 


4. Выполните команду Project | Build. B результате будет создан выполняемый мо- 
дуль projectl.exe без поддержки пакетов. 


5. Посмотрите размер получившегося файла, воспользовавшись для этого, на- 
пример, программой Windows «Проводник» или выполните команду Project | In- 
formation for project. Команда открывает окно информации о проекте, в котором 
вы сможете увидеть, что размер вашего выполняемого файла 359936 байт (351 
КБ). Это достаточно внушительный размер, поскольку файл включает в себя 
все скомпилированные в него коды библиотеки компонентов. 
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6. Опять выполните команду Project | Options, и в окне опций проекта Project Орн- 
ons на странице Linker включите индикатор Use dynamic RTL, а на странице Packa- 
ges включите индикатор Built with runtime packages. 


7. Перестройте ваш выполняемый модуль, выполнив команду Project | Build (как в 
пункте 4). 


8. Посмотрите теперь размер вашего файла projectl.exe с поддержкой пакетов. 
Размер сократился до 22528 байт (22 Кб). 


Как видите, выигрыш весьма значительный: без поддержки пакетов размер 
файла составляет 359936 байт (351 KB), а с поддержкой — 22528 байт (22 Кб), т.е. 
примерно в 16 раз меньше. Вроде бы прекрасно! Но учтите, что прежде, чем поль- 
зователь сможет на своем компьютере применить ваше приложение, на этом ком- 
пьютере надо поставить используемые приложением пакеты. 

Узнать, какие пакеты и DLL нужны для распространения вашего приложения 
можно с помощью программы tdump.exe, поставляемой вместе с C++Builder и на- 
ходящейся в каталоге ...\bin. Эта программа работает в DOS. Чтобы воспользовать- 
ся ею, перейдите в DOS в каталог, в котором расположен файл вашего приложения 
Projectl, и выполните, следующую команду: 


tdump Projectl.exe > dump.txt 


В результате tdump проанализирует ваш файл и занесет результаты анализа в 
указанный вами текстовый файл dump.txt. Посмотрев этот файл, вы найдете в 
нем, наряду с прочими сведениями, строки вида 


Imports from VCL50.BPL 
__fastcall System: :initialization() 


Imports from BORLNDMM. DLL 
(ord. =, 2) 

Imports from KERNEL32.DLL 
FreeLibrary 


Imports from CC3250MT.DLL 
operator delete(void *) 


Таким образом вы получите полный список пакетов и DLL, используемых Ba- 
шим приложением. Эти пакеты и библиотеки должны быть на компьютере пользо- 
вателя, чтобы он мог работать с вашим приложением. Впрочем, импортируемые 
DLL обычно типичны для Windows и имеются на любом компьютере. К тому же их 
объем, как правило, невелик. A файл пакета VCL50.BPL, который, как видно из 
приведенного выше текста, требуется для работы приложения, имеет размер 
2023424 байта (1976 КБ или 1.93 МБ). Это, конечно, внушительный размер. Но 
дело в том, что этот файл вам надо поставить пользователю один раз и он обеспечит 
поддержку подавляющего большинства ваших приложений, файлы которых будут 
небольшими. 

Давайте прикинем, когда это становится выгодным. Предположим, что сред- 
ний размер файла приложения с поддержкой пакетов времени выполнения — 25 
КБ, а без поддержки в 16 раз больше — 400 КБ. Тогда, если пользователь исполь- 
зует в своей работе М приложений, то без поддержки пакетов ему потребуется для 
хранения файлов N*400 КБ дискового пространства, a при поддержке пакета 
VCL50 — (1976 + N*25) КБ. Нетрудно посчитать, что уже при М = 6 поддержка 
пакетов становится выгодной. 

Таким образом, в каждом конкретном случае надо решать, создавать ли вам 
автономный выполняемый модуль, или использовать поддержку пакетов времени 
выполнения. Очевидно, что при создании отдельной прикладной программы луч- 
ше делать автономный модуль. А при создании большой серии приложений, кото- 
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рые будут использоваться одними и теми же пользователями, возможно вариант с 
поддержкой пакетов может быть предпочтительнее. 

Использовать, или не использовать поддержку пакетов времени выполне- 
ния — вопрос, возникающий только при заключительной компиляции уже готово- 
го приложения. Сам процесс проектирования никак не изменяется от того, будете 
или не будете вы использовать поддержку пакетов. А поскольку поддержка паке- 
тов позволяет существенно уменьшить затраты дискового пространства под хране- 
ние выполняемых модулей, то можно дать следующий совет. 


Coney АЕ СЧА, 
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Для экономии места на диске при параллельной разработке нескольких проектов или неско- 
льких вариантов одного проекта имеет смысл в процессе разработки включить поддержку 
пакетов времени выполнения. Это позволит вам более чем на порядок сократить размеры 
генерируемых выполняемых модулей. 
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Для использования этой возможности выполните команду Project | Options. В 
раскрывшемся окне опций проекта выберите страницу Packages и включите на ней 
индикатор Built with runtime packages. Одновременно полезно включить в TOM же окне 
(рис. 4.1) индикатор Default, что обеспечит статус этой установки как установки по 
умолчанию для всех ваших будущих проектов. 

Только не забудьте при заключительной компиляции законченного проекта 
выключить опцию поддержки пакетов, если вы намерены передавать пользовате- 
лям автономный выполняемый модуль. 


Разработка справочной 
системы (создание файлов .hip) 


8.1 Проектирование справочной системы 


Разработка справочной системы осуществляется не C++Builder, а средствами 
Windows. Просмотр ее также осуществляется программой Windows WinHelp. 
C++Builder только позволяет встроить справочную систему в приложение (см. раз- 
дел 4.1.9). Однако, поскольку полноценное приложение немыслимо без хорошо 
разработанной справочной системы, мы коротко рассмотрим некоторые основные 
вопросы, связанные с ее созданием. 

Разработка справки состоит из двух основных этапов: 


Ш Создание файла или нескольких файлов, содержащих темы справок, Это дела- 
ется с помощью любого текстового редактора, например, с помощью Microsoft 
Word. 


ш Компиляция справки в один или несколько файлов .hlp и отладка всей спра- 
вочной системы. Это осуществляется с помощью специальных программ: 
HCRTF — Microsoft Help Workshop для Windows 95/98/2000 и МТ и программ 
HC31 или HCP для Windows 3.x. При этом создаются вспомогательные файлы 
проекта и некоторые другие. 


Рассмотрим указанные этапы работы. В основном будет рассмотрена методика 
создания справок для Windows 95/98/2000 и МТ с помощью такого инструмента, 
как Microsoft Help Workshop 4. Соответствующие программы и файлы, необходи- 
мые для этого, обычно расположены в C++Builder каталоге .../Help/Tools. Особенно- 
сти справок для Windows 3.x рассмотрены в разделе 8.4. 

Прежде, чем создавать тексты справок, надо продумать систему в целом. Надо 
рептить, как должно выглядеть основное окно, какую информацию выносить в до- 
полнительные окна, что выносить во всплывающие окна, как должен выглядеть и 
какие разделы включать предметный указатель и окно содержания (это окно в 
виде дерева, содержащего изображения книг и документов каждый из вас видел, 
работая с какими-нибудь справками). В отношении основного окна надо решить, 
какие кнопки в своем заголовке оно должно иметь, нужна ли начальная часть, не 
поддающаяся прокрутке, и что в нее должно входить, продумать общий стиль 
справки. При решении вопроса о дополнительных окнах и распределении функ- 
ций между основным и дополнительными окнами надо иметь в виду, что дополни- 
тельное окно не имеет полосы меню и не обеспечивает доступ к истории и содержа- 
нию. С другой стороны у основного окна тоже имеется ограничение: оно не может 
быть сделано автоматически подстраивающим свои размеры под объем текста в 
нем. Не останавливаясь на подробностях процесса составления проекта справки, 
следует сказать, что этот процесс, конечно, трудно формализовать и любой перво- 
начальный проект подвергнется переделкам в процессе его реализации. Но все-та- 
ки помните, что от удачного или неудачного планирования справки во многом за- 
висит удобство пользователя, а, значит, и его отношение к вашему приложению, 
для которого готовится справка. 
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8.2 Создание файла тем справок 


8.2.1 Написание текстов тем 


Файл тем справок создается с помощью текстового редактора, например, с по- 
мощью Microsoft Word. Каждая тема или кадр (в дальнейшем он будет отобра- 
жаться в отдельном окне) занимает одну страницу. Друг от друга темы отделяются 
символом разрыва страницы. В Word это осуществляется или командой Встовка | 
Разрыв и выбором в диалоговом окне опции Начать Новую страницу, или нажатием 
‘клавиш Ctrl-Enter. 

Порядок расположения тем в файле безразличен, кроме одной темы — Содер- 
жание, которая по умолчанию располагается в файле первой и содержит ссылки на 
другие темы. Ha этот кадр передает управление WinHelp при щелчке пользователя 
на кнопке Содержание. Впрочем, если вы включаете в свой проект специальный 
файл Содержания, то именно этот файл будет определять, что увидит пользователь 
при щелчке на кнопке Содержание. 

При написании темы можно использовать многие возможности Word: выбор 
атрибутов шрифта (полужирный, курсив), цвет шрифта, табуляцию, подчеркива- 
ние, включение в текст таблиц (правда, без сетки и без разноцветной заливки) и 
т.п. Шрифты тоже можно использовать различные. Но увлекаться этим не стоит, 
так как если у пользователя на компьютере не окажется соответствующего шриф- 
та, OH не сможет прочесть ваших текстов. Так что лучше всего использовать обыч- 
ные системные шрифты (для Windows 95/98 и NT это MS Sans Serif). 

В кадр могут специальным образом включаться рисунки, кнопки и т.д. 

Каждая тема содержит ряд рассмотренных ниже CHOCOK, определяющих ee 
отображение в WinHelp. 

Темы могут содержать так называемые горячие области (hotspot): выделенные 
слова или кнопки, позволяющие пользователю переходить из данной темы в дру- 
гие (позднее мы рассмотрим, как организуются эти выделения). При этом сущест- 
вует несколько возможностей переходов: прямой переход на заданную тему, пере- 
ход с помощью макроса KLink, который может предложить пользователю выбор 
из тех тем, в К-сносках которых встречаются заданные ключевые слова, и с помо- 
щью макроса ALink, практически идентичного KLink, но сравнивающего ключе- 
вые слова с другим видом сносок — А-сносками. 

По умолчанию строки текста при их отображении в окне справки будут «заво- 
рачиваться», т.е. та часть строки, которая не помещается в слишком узком для нее 
окне, переносится на новую строку. Это удобно, поскольку позволяет пользовате- 
лю свободно изменять размеры окна, не затрудняя себе чтение текста. Однако, в 
некоторых случаях это может оказаться нежелательно, например, при отображе- 
нии каких-то таблиц. Можно указать справочной системе, что она не должна заво- 
рачивать какие-то строки текста. Для этого надо выделить в Word эти строки, вы- 
полнить команду Формат | Абзац и в открывшемся диалоговом окне на странице По- 
ложение на странице установить опцию Не разрывать абзац. Тогда, если ширины. 
окна справки не хватает, чтобы отобразить всю длину отмеченных таким образом - 
строк, в окне появится полоса горизонтальной прокрутки, но строки разрываться 
и переноситься не будут. 

Если в теме много строк, то для их просмотра пользователь будет пользоваться | 
вертикальной прокруткой. Однако, часто желательно указать какую-то область в 
начале текста темы, которая оставалась бы «замороженной» и не прокручивалась. 
Например, это может быть заголовок темы, шапка таблицы и т.п. Для того, чтобы 
указать область, не подвластную прокрутке, надо выделить ее в Word, выполнить 
команду Формат | Абзац и в открывшемся диалоговом окне на странице Положение 
на странице установить опцию Не отрывать от следующего. 
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В тему можно добавлять изображения в виде файлов типов .bmp, .dib, .wmf, 
shg, .mrb. Для этого можно просто воспользоваться буфером обмена, занеся туда 
изображение из какой-нибудь графической программы и прочитав ее в Word ко- 
мандой Правка | Вставить. Так целесообразно поступить, если данное изображение 
используется только в одном месте файла текстов тем. Если же оно используется в 
нескольких местах, то экономичнее использовать команды | 


{omc <имя файла>}, 
{bml <имя файла>} 


или 


{мг <имя файла>}. 


Первая из них позиционирует изображение так же, как обычные символы. 
Последующий текст продолжается в той же строке. Вторая — позиционирует изо- 
бражение у левого края страницы и текст обтекает его справа. Третья — позицио- 
нирует изображение у правого края страницы и текст обтекает его слева. Напри- 
мер, вы можете написать такой текст: 


Пиктограмма {bmc pictl.bmp} на инструментальной панели 
соответствует команде 


В том месте, где вы написали {bmc pictl.bmp}, появится изображение, содер- 
жащееся в файле «pictl.bmp», и сразу за изображением последует продолжение 
текста. 

Вы можете добавить в текст кнопки, нажимая которые пользователь будет за- 
пускать тот или иной макрос. Это делается командой 


{button <надпись>, <список макросов>} 


В этой команде <надпись> — это та надпись, которая появится на изображе- 
нии кнопки, а <список макросов> — перечень макросов, которые должны выпол- 
няться при нажатии кнопки. Если макросов несколько — они разделяются двоето- 
чиями. Пример описания кнопки: 


{button см. также, KLink (Меню) } 


Это приведет к тому, что при работе со справкой в этом месте появится кнопка 
с надписью «см. также». Если пользователь нажмет эту кнопку, то увидит окно 
Найденные разделы, в котором ему будет показан список тем, содержащих в своих 
К-сносках (см. об этом ниже) название «Меню». 

Файл тем справок сохраняется в файле формата RTF — обогащенном тексто- 
вом формате. Для сохранения его в таком виде надо в Microsoft Word выполнить 
команду Файл | Сохранить как и в открывшемся диалоговом окне установить опцию 
Тип файла равной Текст в формате RIF. После этого надо нажать кнопку Сохранить. 
Файл сохранится с расширением по умолчанию .rtf. Все это надо проделать только 
при первом сохранении файла. В дальнейшем он будет сохраняться в том же фор- 
мате автоматически. при выборе просто команды Сохранить. 


8.2.2 Сноски 


Каждая тема снабжается сносками, определяющими ее наименование и ряд 
других свойств. Сноски в Word делаются командой Встовка | Сноска, после чего от- 
крывается диалоговое окно Сноски (см. рис. 8.1). В нижнем его окне следует ука- 
зать символ, используемый в сноске. Какие именно символы надо использовать в 
тех или иных сносках, будет рассмотрено ниже. Все сноски помещаются перед тек- 
стом темы, т.е. в первых позициях кадра. Чтобы наблюдать и редактировать тек- 
сты сносок Word должен быть переключен в режим Разметка страницы. 
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Рис. 8.1 
Вставка сноски в текст файла тем в Word 


Внизу страницы — 


у С кощевую = = Вконце документа — 


_ С автоматическая 


e другая; ей 


8.2.2.1 Сноска # 


Сноска # обозначает уникальный идентификатор темы, по которому на нее 
могут ссылаться другие темы. Этому идентификатору в дальнейшем будет ставить- 
ся в соответствие номер, по которому на данную тему может ссылаться использую- 
щее справку приложение. Так что любой кадр должен снабжаться меткой #. Иден- 
тификатор, указываемый как текст этой ссылки, имеет чисто служебное назначе- 
ние, пользователь его нигде не видит. Идентификатор может писаться латинскими 
или русскими буквами и состоять из одного или нескольких слов. Примеры таких 
сносок: Маш, Содержание, *O программе. 


8.2.2.2 Сноска К 


Сноска с символом К (заглавная латинская буква) должна включаться в кадр, 
если надо, чтобы тематика этого кадра отображалась при работе со справкой в окне 
справочной системы на странице «Предметный указатель» (см. рис. 8.2) в списке, 
из которого пользователь может выбрать требуемую тему по ее первым буквам или 
просто пролистав список. Те названия тем, которые пользователь видит в предмет- 
ном указателе — это и есть тексты сносок К соответствующих кадров. 

Текст сноски может состоять из одного или нескольких слов. Например, 
КМеню Правка. В этом случае при работе со справкой в списке указателей появится 
строчка «Меню Правка», по которой пользователь может выйти на данную тему. 


Рис. 8.2 
Страница «Предметный указатель» 
справочной системы 


Главное меню 
>? 


Mento Правка 
Меню Файл 
Шрифт 


Инструментальная панель 


1 Копировать 
‚Меню Файл 
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Можно также ввести несколько различных обозначений для одного и того же кад- 
ра, разделяя их точками с запятой. Например, ссылка 


КМеню правка; Меню 


обеспечит две строки в указателе: «Меню правка» и «Меню», которые будут ссыла- 
ться на одну и ту же тему. Пользователь сможет выйти на нее по любой из этих 
строчек. 

Можно обеспечить и двухуровневые ссылки, которые видны на рис. 8.2. Для 
этого пишется название темы первого уровня, затем ставится запятая и пишется 
название темы второго уровня. Причем название темы первого уровня может соот- 
ветствовать данному кадру, а может относиться и к другому кадру. Например, 
текст сноски 


КМеню Правка; Меню Правка, Вырезать; Меню Правка, Копировать; 
Меню Правка, Вставить; Меню; Главное Меню, Меню Правка 


приведет к тому, что в окне указателя появятся строчки (см. рис. 8.2) 


Меню Правка 
Вырезать 
Копировать 
Вставить 


/ 


Первая из этих строк определена в первом элементе сноски. Следующие три 
строки второго уровня определены во втором, третье и четвертом элементах сноски. 
Пятый элемент сноски определяет, что к данной теме пользователь может обратить- 
ся и по строчке «Меню». Наконец, последний элемент сноски определяет, что к на- 
званию другого кадра — «Главное Меню» добавится строчка второго уровня «Меню 
Правка». И по всем этим строчкам пользователь сможет выйти на данный кадр. 

Элементы, указанные в сносках К, используются не только в списке указате- 
ля, но и при организации переходов между темами по ключевым словам с помо- 
щью макроса KLink (см. раздел 8.2.3.2). 


8.2.2.3 Сноска $ 


Сноска с символом '$’ определяет заголовок данной темы. Этот заголовок ис- 
пользуется в WinHelp в ряде режимов работы, в частности, в системе Поиск, в окне 
История, позволяющем пользователю вернуться к одной из уже просмотренных 
тем, и в ряде других режимов работы. Этот заголовок используется также во вспо- 
могательном окне указателя тем в случаях, если какая-то строка основного указа- 
теля относится сразу к нескольким темам. Поясним это. 

Выше были рассмотрены сноски К. Ничто не мешает в этих сносках для раз- 
ных кадров указать одинаковый элемент. Это облегчает пользователю поиск нуж- 
ной информации. Например, если вы описываете темы, связанные с главным меню 
приложения и его разделами Файл, Провка и др., вы можете во всех этих темах в 
сноски К внести элемент «Меню». Тогда строка «Меню» в предметном указателе 
будет относиться сразу к нескольким темам и пользователь, выбравший эту стро- 
ку, должен иметь возможность уточнить свой выбор, указав одну из конкретных 


Рис. 8.3 
Окно «Найденные разделы» справочной системы 
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тем. Для этого система справки автоматически предъявит пользователю окно «Най- 
денные разделы», вид которого представлен на рис. 8.3. Строки, обозначающие в 
этом окне конкретные темы задаются в кадрах с помощью сносок с символом $. Та- 
ким образом, сноски $ имеет смысл включать только в те кадры, которые в своих 
сносках К имеют элементы, используемые также в сносках К других кадров. 


8.2.2.4 Сноска А 


Сноска А (заглавная латинская буква) аналогична по синтаксису сноске К. Но 
ее тексты не включаются в указатель, как для сноски К, а используются только для 
переходов по ключевым словам с помощью макроса ALink. Таким образом, если 
тексты сносок К участвуют в двух различных процессах — поиске по указателю и 
поиске по ключевым словам, то сноски А позволяют развязать эти два процесса. 


Хороший стиль программирования ~~~ | 


Включайте в ваши темы сноски А. Они позволяют развязать процессы поиска по указателям 
и по ключевым словам. Это позволяет вам задавать в сносках К развернутые пояснения, 
удобные пользователю при работе с предметным указателем. 


REE LLLP IAL APES КАБИНКА НИНА ЯКУНИН ИК < RPO А LIRR LOI LOD АКИ A ОИК ELEN ELE POLES CO IOS ILLIA SAVOESE 


8.2.2.5 Сноска + 


Сноска с символом ‘+ используется для указания последовательности про- 
смотра тем с помощью кнопок «>>» и «<<». Эти сноски имеют смысл только в слу- 
чаях, когда вы включаете в окно справки соответствующие кнопки просмотра 
(кнопки Browse, включаются в файле Проекта — см. раздел 8.3.1). Если сноски + 
есть, но в них не указано никаких значений, TO Help Workshop устанавливает ав- 
томатически последовательность просмотра в соответствии с последовательностью 
тем в вашем файле. В кадрах, в которых сносок + нет, кнопки просмотра не дос- 
тупны. Тексты сносок могут быть просто номерами (рекомендуется обозначать их с 
предшествующими нулями: 001, 002 ит.д.) или идентификаторами. 


8.2.2.6 Сноска ! 


Сноска с символом '!' используется для указания одного или нескольких мак- 
росов, которые должны сработать перед появлением окна данной темы на экране. 
_ Если указывается несколько макросов, то они разделяются запятыми или точками 
с запятой. Эти сноски используются только в достаточно сложных справках. Под- 
робнее о макросах см. в разделе 8.2.4. 


8.2.2.7 Сноска * 


Сноска с символом '*’ используется для указания связанных друг с другом 
тем, которые должны быть встроены в справку. Эти сноски позволяют, подготовив 
один файл тем, использовать его для генерации несколько разных файлов справок. 
В этом случае в файле проекта .hpj указывается, темы с какими значениями сно- 
сок * надо включить в справку — в файл .Шр. Темы без сносок * включаются в 
справку в любом случае. 


8.2.2.8 Сноска > 


Сноска с символом '>' используется для указания идентификатора окна, в ко- 
тором должна отображаться тема. Окно с этим именем должно быть определено в 
файле проекта .hpj. Сноска > используется при передачах управления на данную 
тему из окна указателя или с помощью макросов KLink и ALink. 


Ник 
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8.2.3 Переходы 


В темы можно вводить переходы на другие темы несколькими изложенными 
ниже способами. 


8.2.3.1 Непосредственные переходы 


Для того, чтобы выделить в тексте темы некоторое слово или сочетание слов, 
при щелчке на котором пользователь перейдет на другую тему, надо’ сделать сле- 
дующее. Сразу после этих слов (без пробела) надо написать идентификатор темы,. 
на которую надо перейти. Затем соответствующее слово или сочетание слов выде- 
ляется двойным подчеркиванием. Это подчеркивание не будет видно пользователю 
при работе со справкой — для него оно заменится выделением цветом (обычно зе- 
леным). Для того, чтобы в Microsoft Word обеспечить двойное подчеркивание, 
надо выделить курсором требуемое слово или сочетание слов и выполнить команду 
Формат | Шрифт. В открывшемся окне на странице Шрифт надо установить опцию 
Подчеркивание в положение Двойное и нажать ОК. 

После этого следующий за подчеркнутыми словами идентификатор темы пере- 
хода оформляется как скрытый (невидимый). Для этого выполняется та же коман- 
да Формат | Шрифт. В открывшемся окне на странице Шрифт в разделе Эффекты надо 
установить индикатор опции Скрытый и проследить, чтобы опция Подчеркивание 
имела значение «(нет)». 

Для того, чтобы вы сами видели этот скрытый текст и могли бы его редактиро- 
вать, надо выполнить в Word команду Сервис | Параметры и на странице Вид в раз- 
деле Непечатаемые символы установить индикатор Скрытый текст. Если вам захочется 
напечатать на принтере текст вашего файла, то дополнительно на странице Печать 
в разделе Печатать надо тоже установить индикатор Скрытый текст. Не забудьте все 
это проделать. Иначе вам будет очень трудно работать с вашим файлом. 

Приведем пример вставки в текст переходов. Пусть вы написали тему с тек- 
стом 


О_ ПРОГРАММЕ 

Данная программа является примером простого текстового редактора. Она 
позволяет загрузить документ из файла в окно редактирования или создать 
в этом окне новый документ. 

Управление работой ведется с помощью Главного меню и Aiiccteioibal кнопок. 


Вы хотите выделить слова «окно редактирования», чтобы при щелчке на них 
пользователь переходил к теме с описанием работы с этим окном. Пусть идентифи- 
катор темы, где описана работа с этим окном, — «Окно». Аналогично вы хотите 
выделить слова «Главного меню», чтобы после щелчка на них пользователь пере- 
ходил к теме с именем «Главное меню», и слова «быстрых кнопок» для перехода 
на тему «Buttons». Тогда после описанных ранее выделений нужных словосочета- 
ний, указания для них соответствующих тем и введения ссылок текст приобретет 
BU: 

SK О ПРОГРАММЕ 

Данная программа является примером простого текстового редактора. Она 


позволяет загрузить документ из файла в окно _редактированияские или 
создать в этом окне новый документ. 
Управление работой ведется с помощью Главного менюглавное мена и 


быстрых KHONOKMut tons. 


* О программе 

* © программе 

о программе; О программе, Назначение программы; О программе, 
Управление программой 
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При работе со справкой скрытый текст не будет виден. Пользователь увидит 
только тот текст, который был до введения указателей переходов. В этом тексте бу- 
дут выделены зеленым цветом и подчеркнуты слова «окно редактирования», 
«Главного меню» и «быстрых кнопок». При щелчке на них пользователь перейдет 
к соответствующим темам. 


При задании переходов имеются также возможности сообщить справочной 
системе некоторую дополнительную информацию. Если желательно, чтобы выде- 
ленные слова отображались цветом, принятым по умолчанию для всего текста (т.е. 
не выделялись зеленым цветом), то перед ссылкой на тему ставится знак *. Напри- 
мер: «быстрых кнопок“ВиИонз». Если к тому же вы хотите, чтобы эти слова OTO- 
бражались не подчеркнутыми, то вместо символа * надо поставить символ %. На- 
пример: «быстрых кнопок‘ Hulions». 

Если ваша справка состоит из нескольких файлов .Шр и вы хотите указать пе- 
реход на тему другого файла, то после указания идентификатора темы надо поста- 
вить символ @, после которого указать имя файла, в котором расположена эта 
тема. Например: «быстрых кнопокВо оне. Вр». 

Задавая переход, вы можете указать имя окна (из числа определенных вами в 
файле Проекта — см. раздел 8.3.1), в котором вы хотите отобразить тему. Для это- 
го после идентификатора темы вы ставите символ больше (>), после которого пи- 
шете имя окна. Например, «быстрых кнопокВиоп52 W 2». 

Можно также отображать тему, на которую вы переходите, во всплывающем 
окне. Такие окна используются чаще всего для дополнительной информации или 
пояснений. В отличие от основного окна всплывающее окна появляется, не убирая 
с экрана окна вызвавшей его темы. При любом действии пользователя всплывшее 
окно исчезает и пользователь оказывается в предыдущем окне. 

Указание на переход к теме, отображаемой во всплывающем окне, осуществ- 
ляется точно так же, как было описано выше, с единственным отличием — выде- 
ляемое слово или сочетание слов подчеркивается не двойной, а одинарной чертой. 


Например, «быстрых кнопокВиЙопз». 


8.2.3.2 Переходы по ключевым словам 


Имеется два макроса — KLink и ALink, которые позволяют переходить не к 
заранее заданной теме, а к темам, в соответствующих сносках которых имеются 
заданные ключевые слова. Если заданные слова встречаются в нескольких темах, 
то пользователю показывается окно «Найденные разделы» (рис. 8.3) и он может 
сам определиться, на какую тему ему уходить. 


— 
Хо ро Lu u и стил b п р о г ра мм и ро ва H и gq YRS Венев ORE GBC RE IE EGE орон ЕСО НИ 


В сложных справках лучше BO многих случаях использовать макросы KLink и ALink (прежде 

’ всето ALink) вместо непосредственных переходов. Эти макросы позволяют пользователю при 
наличии нескольких родственных тем выбрать ту, которая его более интересует в данный мо- 
мент). 


НИИ Е ЕДИНАЯ ЕРИНО ЧУЖИЕ ИАА, ИИ ИН Е ВИ рее 


a 
Xo po Lu и и ст и л b п ро гра мм и ро ва is и Я вы 


В темы полезно вводить ссылки вида «см. также», в которых с помощью макроса ALink nepe- 
числять ключевые слова, связанные с данной темой. Это облегчает пользователю комплекс- 
ное изучение интересующего его вопроса. 


ERLE кре рено Ре PEERS BEI Se 


Макросы КиК и ALink имеют одинаковый синтаксис и действуют одинако- 
во. Оба они могут использоваться, в частности, вместо рассмотренных выше непо- 
средственных ссылок на темы. Различие между этими макросами состоит в том, 
что первый из них ищет заданные ключевые слова в К-ссылках, а второй — в 
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А-ссылках. Приведем синтаксис вызова макроса KLink (синтаксис ALink аналоги- 
чен, только надо заменить KLink на ALink): 


КЬ1пк ("<список ключевых CJIOB>", <тип>, 
"<идентификатор темы>", <имя окна>) 


<список ключевых слов> представляет собой одно или несколько ключевых слов 
или словосочетаний, разделенных точками с запятой. Если хотя бы одно из этих 
словосочетаний содержит запятую, то весь список заключается в двойные кавыч- 
ки. Поиск ведется в К-ссылках сначала по первому слову. Если нашлось несколько 
тем, то пользователю показывается окно Найденные разделы. Если же не нашлось 
ни одной темы, начинается поиск по второму ключевому слову и т.д. 

Все остальные элементы вызова макроса, кроме списка ключевых слов, явля- 
ются не обязательными. <тип> определяет реакцию на найденные или ненайден- 
ные ключевые слова и может принимать одно или несколько (разделяемых пробе- 
лами) следующих значений: 


JUMP 


Если найдена только одна тема, соответствующая 
ключевым словам, то на нее сразу осуществляет- 
ся переход 


Макрос возвращает величину, указывающую, на- 
шлось, или нет хотя бы одно соответствие ключе- 


TEST 


| TITLE Если ключевое слово находится более чем в од- | 

| ном файле справки (при справке, состоящей из 
нескольких файлов), то в окне Найденные разделы 
после названия темы пишется имя файла так, 

| как оно определено в файле .cnt (см. раздел 8.3.3). 


<идентификатор темы> определяет, что если не найдено соответствия ключевым 
словам, то появляется всплывающее окно с текстом, содержащимся в теме, на ко- 
торую указывает этот идентификатор. Если идентификатор не задан, то при безу- 
спешном поиске появляется диалоговое окно с текстом «Дополнительные сведения 
отсутствуют. (141)». Если идентификатор темы относится к другому файлу, то по- 
сле него надо написать символ @, а затем — имя файла. 
<имя окна> задает окно для отображения. Если этот параметр не задан, то исполь- 
зуется окно, заданное в кадре темы, а если оно и там не задано, то используется 
окно по умолчанию. 

Приведем примеры использования рассмотренных макросов. Текст 

Меню: KLINE (Меню; Главное меню, Jump) программы позволяет выполнить 

все операции. 

приведет к выделению слова «Меню», щелкнув на котором пользователь увидит 
или список тем, содержащих в своих К-сносках ключевые слова «Меню» и «Глав- 
ное меню», или, если есть только одна такая темы, то сразу перейдет на нее. Если в 
том же тексте заменить обращение к макросу на 


'KLink (Меню; Главное меню, Jump,,W1) 


то будет то же самое, но тема отобразится в окне с именем WI (если такое окно 
определено в файле проекта). 
Оператор 


{button Меню, АГ1пк (Меню; Главное меню, Jump) } 
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приведет к появлению в кадре кнопки с надписью «Меню», при нажатии на кото- 
рую будет та же реакция, что и в рассмотренном в начале примере, но поиск будет 
проходить в А-ссылках. 


8.2.4 Макросы 


Имеется множество макросов, помимо описанных выше KLink и ALink, кото- 
рые можно использовать при разработке справки. Они могут запускаться из «горя- 
чих областей» — выделенных словосочетаний, кнопок и т.д., или при открытии 
той или иной темы, или при открытии справки в целом. Рассмотрение этих макро- 
сов выходит за рамки данной книги. Все они хорошо описаны в файле справки 
Нем. Шр, который может быть вызван непосредственно из Windows или из 
Microsoft Help Workshop. Большинство этих макросов позволяют работать с кноп- 
ками окна справки, с меню, создавать и уничтожать элементы списков и т.д. Рас- 
смотрим коротко только некоторые из них. 

Отметим прежде всего макросы, позволяющие оперировать с файлами внеш- 
них программ. Эти макросы, введенные в WinHelp 4.0:. 


жк ——— 
| Макрос Описание | 


|ControlPanel |Открывает заданный элемент (файл .cpl) программы «Контроль- | 
| _ | ная Панель». | 


Запускает указанную программу или открывает файл и запус- 
кает связанную с ним программу. 


Проверяет наличие указанного файла на компьютере пользова- 


теля. 


| 
ие | 
| | 
| 
|ShellExecute | Открывает, печатает или запускает файл или программу. | 
| 
ee | | 


| ShortCut | Запускает указанную программу, если она еще He запущена, 
или активизирует ее и передает ей сообщение WM COMMAND. 

Впрочем, и в более ранних версиях WinHelp, даже в Windows 3.x имелся мак- 
рос ExecProgram, позволяющий запускать внешние программы. 

Не останавливаясь детально на синтаксисе макросов, описанном в справке по 
подготовке Нер, рассмотрим несколько примеров. 

Приведенный ниже оператор создает кнопку, при нажатии на которую запус- 
кается элемент «Контрольной Панели» Дата/время. 


{button Tara/Bpema, ControlPanel (Timedate) } 

Следующий оператор создает кнопку, при нажатии на которую запускается 
программа Windows «Калькулятор». 

{button Калькулятор, ExecFile(Calc.exe) } 

Следующий оператор создает кнопку, при нажатии на которую открывается 


исходный файл справки, т.е. вызывается программа, связанная с этим файлом. 
Поскольку он записан в формате RTF, то обычно с ним связана программа Word. 


{button Topics.rtf, ExecFile(Topics.rtf) } 
Следующий оператор проверяет, есть ли на компьютере файл приложения 


туарр.ехе. Если есть, то это приложение запускается. В противном случае осуще- 
ствляется переход на тему с идентификатором install. 


IfThenElse (FileExist (myapp.exe), ExecFile(myapp), 
- JumpId(install my арр)) 


= 
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Ряд макросов связан с созданием. кнопок в полосе кнопок заголовка окна 
справки или с созданием разделов меню, не предусмотренных по умолчанию в 
справочной системе. Эти макросы обычно выполняются при открытии справки и 
включаются в описанный в следующем разделе файл Проекта справки, хотя кноп- 
ки и разделы меню могут создаваться или уничтожаться и в отдельных темах 
справки. Приведем примеры таких макросов. 

Макрос 


BrowseButtons () 


создает в полосе кнопок заголовка окна справки кнопки просмотра вперед и назад 
(кнопки >> и <<). Эти кнопки обычно имеет смысл включать только при исполь- 
зовании в темах сносок упорядочивания *. 

Макрос CreateButton создает в полосе кнопок заголовка окна справки новую 
кнопку с указанным именем, соответствующую указанному макросу. Синтаксис 
макроса CreateButton следующий: 


СгеафеВиассоп ("<идентификатор>", "<надпись>", "<макрос>") 


Здесь <идентификатор> — внутренний идентификатор кнопки (произволь- 
ный), который можно использовать, если вы потом захотите, например, в каких-то 
темах удалить эту кнопку. <надпись> — это то, что будет написано на кнопке. А 
<макрос> — тот макрос, который будет выполняться при щелчке на этой кнопке. 
Например, макрос 


CreateButton("History", "&История", “"History()") 


создаст кнопку с надписью История, при щелчке Ha которой будет выполняться 
макрос History(), отображающий окно со списком до сорока последних тем, про- 
смотренных пользователем. Из этого списка пользователь может выбрать тему, к 
которой он хочет вернуться. 

В заключение приведем несколько макросов, позволяющих добавлять новые 
меню и разделы в полосу меню окна справки. Первый из этих макросов — 
InsertMenu, добавляющий новое меню. Его синтаксис: 


InsertMenu ("<идентификатор меню>", "<«надпись>", <номер>) 


Здесь <идентификатор меню> — внутренний идентификатор меню, который 
можно использовать при последующих ссылках, <надпись> — надпись раздела, 
<номер> — порядковый номер меню (меню нумеруются слева направо, начиная с 
0). 

Второй макрос — Арреп4Цеш, вставляющий раздел в конец указанного меню. 
Его синтаксис: 


АррепаТеем ("<идентификатор меню>", 
"<идентификатор раздела>", "<надпись>", "<макрос>") 


Здесь <идентификатор меню> и <идентификатор раздела> — внутренние 
идентификаторы, используемые в справке для последующих ссылок на меню и его 
раздел, <надпись> — надпись, которая появится в меню, <макрос> — макрос или 
макросы, которые должны выполняться при выборе пользователем данного разде- 
ла меню. 

Приведем пример совместного использования этих макросов. Операторы 


InsertMenu ("mexit", "Выход", 5) 
AppendIitem("mexit", "exit", "Выход", "exit ()") 


заносят в полосу. меню окна справки меню Выход Ha 5-е место и заносят в него раз- 
дел Выход, в котором выполняется макрос ех (), осуществляющий выход из справки. 
‚ Макрос шзег вет позволяет вставить раздел в меню, указанное его иденти- 


фикатором. Для предусмотренных по умолчанию меню окна справки используют- 
ся следующие идентификаторы: 


10 Зак 322 


Идентификатор 
лера о аа по йвябляюий 
Првына > о a sligarce  soromvon.| 


ee ere ний 
mnu_floating 


} 
| 
| 
} 
| 
} 
| 
| 
| 
| 
| 


Пример использования макроса InsertItem: 


Insertitem("mnu_ help", "Ном", "Как использовать справку", "HelpOn()",0) 


В этом примере в меню справки вставляется на первое место (индекс 0 — по- 
следний элемент макроса) раздел Как использовать справку, при выборе которого вы- 
полняется макрос HelpOn(), обеспечивающий переход на стандартный файл, пояс- 
няющий использование справки. 


8.3 Компиляция и отладка 


Компиляция и отладка справки, предназначенной для 32-разрядного 
Windows, производится с помощью программы Microsoft Help Workshop, запус- 
каемой из файла Hertf, расположенного в каталоге CBuilder5\Help\Tools. Эта про- 
грамма позволяет легко создать файл Проекта справки, без которого ее нельзя 
компилировать, а если нужно, то создать еще некоторые вспомогательные файлы, 
например, файл Содержания справки и ряд других. Далее программа позволяет 
скомпилировать файл справки и проверить его в работе. В принципе можно созда- 
вать файлы Проекта, Содержания и др. просто в любом текстовом редакторе. Но 
тогда надо детально изучить их синтаксис. А Help Workshop позволяет автомати- 
зировать всю работу, не требуя знания синтаксиса, так как эта программа сама 
создает тексты файлов, отражающие действия разработчика. 


8.3.1 Создание файла Проекта справки 


Для компиляции справки и ее связывания с использующим его приложением 
необходимо сформировать файл Проекта справки. Это текстовый файл в формате 
ASCII. Создание этого файла и отладка справки осуществляется программой 
Microsoft Help Workshop, которая распространяется вместе с C++Builder и распо- 
ложена в каталоге ...\CBuilder5\Help\Tools. Для создания нового файла Проекта, 
надо выполнить команду программы Microsoft Help Workshop File | New и в появив- 
шемся окне New выбрать опцию Help Project. Далее в окне Project File Name надо 
задать имя и каталог файла проекта справки. При этом учтите, что то же имя, ка- 
кое вы зададите файлу Проекта, будет присвоено компилятором и завершающему 
файлу справки „.Шр (впрочем, это можно отменить, задав другое имя файлу справ- 
ки в окне Options на странице Files — это будет рассмотрено позднее). Стандартное 
расширение файла Проекта — „Вр}. 

В результате описанных действий перед вами появится окно заготовки файла 
Проекта (рис. 8.4), в котором первоначально будет занесен только раздел [Options]. 
Теперь, щелкая на соответствующих кнопках в правой части этого окна, можно 
создавать и заполнять другие разделы файла Проекта. В появляющихся при этом 
диалоговых окнах, описанных ниже (см., например, рис. 8.5) справа вверху имеет- 
ся кнопка со знаком вопроса. Если нажать ее, возникает изображение вопроси- 
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Рис. 8.4 
Окно редактирования файла 
Проекта справки 


1” This fle is maintained by HCW. Do not пюфбу this file directly. 


[OPTIONS] 
`` 0С0=05419 0х0 0х0 Русский ры 
_ {REPORT =Yes Windows. 5. | 


| | {FILES} 7 
1. ATopies. st ; ae 
} Map... 
; Окно редактирования Е i 
;Главное меню 

; Содержание 


тельного знака, которое можно подвести к любому элементу окна, после чего 
всплывет пояснение функции этого элемента. 


8.3.1.1 Кнопка Files 


Кнопка Files в правой части окна рис. 8.4 (не путайте с аналогичным по названию 
разделом меню) позволяет указать имена файлов с текстами тем. Щелкните на этой 
кнопке. Перед вами появится окно «Topic Files» (рис. 8.5), в котором надо щелкнуть 
на копке Add и выбрать среди файлов подготовленный файл текстов справки. В ре- 
зультате в файле проекта появится раздел [Files] c внесенным в него именем файла (см. 
рис. 8.4). Если ваша справка компилируется из нескольких файлов тем, то аналогич- 
ным образом вы должны включить в раздел [Files] и остальные файлы. 


Puc. 8.5 


Окно «Topic Files» — ввод имен файлов Beit 


TEM 


_M Accept tevision marks intopicfles — 


Для файлов тем, расположенных в TOM же каталоге, где располагается файл 
Проекта Вр], имена файлов могут указываться без путей. Если же они расположе- 
ны в другом каталоге, то они указываются с путем. Возможен и другой подход — в 
окне Topic Files (рис. 8.5) можно щелкнуть на кнопке Folders и выбрать папку или 
папки, в которых хранятся файлы тем. Тогда в файле Проекта появится оператор 
Root, в котором указана соответствующая папка. 

Кнопка Remove в окне Topic Files позволяет удалить файл тем из списка. Кноп- 
ка Include позволяет включить в проект текстовый файл ASCIl, содержащий список 
файлов тем. 

Теперь перейдем к другим ‘кнопкам окна Проекта, представленного на 
рис. 8.4. 
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8.3.1.2 KHonka Windows 


Кнопка Windows позволяет определить атрибуты окон, используемых в справ- 
ке. При щелчке на этой кнопке открывается диалоговое окно « Window Properties» 
(свойства окон), представленное на рис. 8.6 а. Оно имеет ряд страниц. На странице 
General (общие характеристики) вы можете изменять список определенных вами 
типов окон, добавляя в него (кнопкой Ада) или удаляя (кнопкой Кетоуе) иденти- 
фикаторы окон. Кнопка Include позволяет включить целый файл, содержащий спи- 
сок окон. Дополнительным окнам вы можете присваивать имена по вашему усмот- 
рению. Эти имена затем могут использоваться в сносках > и в операторах перехо- 
дов, о которых рассказывалось в разделе 8.2. Если же вы хотите определить харак- 
теристики основного окна, отказавшись от его характеристик по умолчанию, вы 
должны включить в список идентификатор Main. 

Расположенные внизу диалогового окна индикаторы позволяют установить оп- 
ции, определяющие состояние окон. Установка опции Auto-size height (автоматическое 
изменение высоты) делает окно изменяющимся по высоте в зависимости от объема 
текста темы. Это удобно, если у вас есть темы, существенно различающиеся по объе- 
му. Главное окно не может содержать эту опцию. Опция Keep Help window on top позво- 
ляет обеспечить положение данного окна справки всегда поверх остальных окон. 

Окно в середине страницы с заголовком Titlebar text позволяет задать текст, кото- 
рый будет записан в полосе заголовка окна справки. Если этот текст не задан ни тут, 
ни в файле Содержания .cnt, то в заголовке окна просто не будет никакого текста. 

Страница Position (положение) диалогового окна Window Properties (рис. 8.6. 6) 
позволяет выбрать положение и размеры окна. Здесь особенно полезной является 


Рис. 8.6 
Окно свойств окон справки: страницы General (a) и 
Position (6) 


Вспомогательное окно справки 


[Дополнительное окно В 


ow Properties 
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кнопка Auto-Sizer. Щелчок на ней вызывает появление на экране окна, представ- 
ленного на рис. 8.7. Вы можете изменять размеры и позицию этого окна на экране. 
Когда вы расположите окно так, как вам хочется, щелкните на его кнопке ОК и 
выбранные вами положение и размеры передадутся окну вашей справки, атрибуты 
которого вы задаете. 


Рис. 8.7 
Задание размеров и местоположения окна 


I‘! Help Window Ацю-бые! EQ 


` To automatically set size and position 
coordinates, move and size this 
window, and then click ok. 


Остальные страницы диалогового окна Window Properties мы He будем подробно 
рассматривать, поскольку они вряд ли могут вызвать затруднения при работе с 
ними. Страница Buttons позволяет задать кнопки, которые должны быть в окне, 
страница Color позволяет выбрать цвета фона окна, причем отдельно для основной 
области текста, и для непрокручиваемого заголовка. Кнопка Macros дает возмож- 
ность определить макрос, выполняемый в момент открытия окна. 

При задании атрибутов главного окна (та1т) следует иметь в виду, что они не 
относятся ко входам в справку из приложения. 


НАНСИ ПИЯ ЛИДА ИИ ИИ ИРИНУ 


ЧИ ОИ 


Предупреждение 
Атрибуты главного окна (тат), задаваемые в файле проекта, не действуют при входе в 
справку из приложения. Поэтому, во избежание неприятных накладок с различными стилями 
окон, надо для всех тем, в которые можно войти из приложения, добавить сноски >, в кото- 

` рых явным cei cal dint в качестве окна main. 


ХОА ов ео: 


< О о И LLL LAL LALLA AAA, 


8.3.1.3 Кнопка Bian: 


Кнопка Bitmaps позволяет указать папки, в которых Help Workshop сможет 
найти использованные в темах файлы изображений .bmp, если они расположены 
не в том каталоге, в котором находится файл проекта. 


8.3.1.4 Кнопка Мар 


Если вы хотите, чтобы из вашего приложения можно было управлять файлом 
справки, необходимо создать таблицу соответствия номеров контекстной справки, 
задаваемых в приложении, и идентификаторов тем. Для этого надо щелкнуть на 
кнопке Мар, в открывшемся диалоговом окне «Мар» (рис. 8.8 а) щелкнуть на Add 
и в окне добавления нового входа Add Map Entry (см. рис. 8.8 6) ввести идентифи- 
катор темы (в окно Topic |D) и соответствующий номер (в окно Mapped numeric value), 
по которому будет осуществляться ссылка на эту тему из приложения. Можно так- 
же ввести комментарий в окно Comment. Этот комментарий просто будет занесен в 
файл проекта и никак не повлияет на справку. Но он очень пригодится вам, когда 
вы будете назначать значения HelpContext компонентам своего приложения. За- 
тем надо щелкнуть на ОК, вернуться в окно «Мар» и опять щелкнуть на ОК. В ре- 
зультате подобных действий в файле проекта появится раздел [МАР] (см. рис. 8.4). 
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Рис. 8.8 | Мар 
Задание соответствия номеров справки и > 
идентификаторов тем: главное окно Map (a) и 
окно задания нового входа (6) 


; Меню Правка 
; Меню Файл 
Мето=5 ; Окно редактирования 
MMENU=2 ; Главное меню 
` | Содержание=1 ; Содержание 


: [Описание панели состояния 3 


8.3.1.5 KHonka Alias 


При нажатии на кнопку Alias (псевдонимы) появляется окно (рис. 8.9 a), по- 
добное уже рассмотренным ранее, содержащее кнопки добавления, удаления, ре- 
дактирования псевдонимов идентификаторов тем и включения сразу списка псев- 
донимов из файла. Псевдонимы могут вводиться, чтобы изменить переходы в фай- 
ле справки или входы в него из приложения, не меняя текстов тем. Например, у 
вас сначала было две темы: одна из них с идентификатором Не описывала меню 
«Файл» вашей программы, а вторая с идентификатором Edit описывала меню 
«Правка». Затем вы решили объединить оба описания в одной теме и дали этой 
теме идентификатор Ме, принадлежащий ранее первой теме. Можно, конечно, 
вручную просмотреть весь файл тем (или несколько файлов), найти все ссылки на 
Edit 1 заменить их на File. А можно установить идентичность этих двух ссылок с по- 
мощью псевдонима. Для этого нажимаете кнопку Alias, затем кнопку Add и в от- 
‘крывшемся диалоге (рис. 8.9 6) напишете в верхнем окне редактирования «File», а 
в нижнем «Edit». Тогда все ссылки и переходы на Ес! заменятся на ссылки и пере- 
ходы Ha File. В файле Проекта появится раздел [Alias], содержащий таблицу введен- 
ных псевдонимов. 


8.3.1.6 Кнопка Config 


При нажатии этой кнопки возникает диалоговое окно, подобное всем предыду- 
щим, в котором можно указать макросы, которые должны выполняться при каж- 
дом входе в справку. Например, это может быть макрос BrowseButtons(), обеспе- 
чивающий появление в окне кнопок «>>» и «<<» для перемещения по темам впе- 
ред и назад, макрос CreateButton, создающий кнопку «История», или любые дру- 
гие макросы (см. раздел 8.2.4). 
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Рис. 8.9 
Задание псевдонимов: главное окно (a) и окно 
добавления псевдонима (6) 
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8.3.1.7 Кнопка Data Files 


При нажатии этой кнопки возникает диалоговое окно, подобное предыдущим, 
в котором можно указать файлы данных для библиотек DLL, используемых в ва- 
шей справке. 


8.3.1.8 Кнопка Options 


Кнопка Options открывает многостраничное диалоговое окно, представленное 
на рис. 8.10. Страница General позволяет задать в окне Default topic идентификатор 


Рис. 8.10 


Задание темы по умолчанию 


488 Глава 8 


темы по умолчанию. Это тема, на которую будет осуществляться переход, при 
ошибочном задании идентификатора темы (после соответствующего предупрежде- 
ния). Кроме того, если справка не имеет файла Содержания .ent, то по этому иден- 
тификатору будет осуществляться переход при нажатии. пользователем, работаю- 
щим со справкой, кнопки Содержание (если тема в окне Default topic He задана, то в 
этом случае по умолчанию будет переход к первой теме первого файла). Опция Нер 
title позволяет задать заголовок главного окна, если для проекта не определено 
окно main с соответствующим заголовкам с помощью кнопки Windows. 

Опция Display this text in the Version dialog box: позволяет задать текст, который 
пользователь будет видеть в диалоговом окне, когда при работе co справкой выбе- 
рет в меню ¢ раздел Версия. Пример этого окна приведен на рис. 8.11. В тексте мож- 
но задать ключевые символы «% date» и тогда в окно будет заноситься дата созда- 
ния файла справки (см. рис. 8.11). 


Рис, 8.11 


Пример окна «О программе» 


ТЕСТ НЕГР, ВЕРСИЯ. о 


Friday, June 23, 2000°22:30:23 


Опция If user paste or print Help text, display: позволяет задать текст, который бу- 
дет присоединяться к тексту темы при его печати или при копировании в буфер об- 
мена. Опции в средней части окна относятся к процессу компиляции справки и по- 
зволяют, в частности, с помощью кнопки Errors запретить появление некоторых со- 
общений об ошибках. 

Страница Compression позволяет задать уровни сжатия при компиляции. По- 
вышение уровня сжатия уменьшает размер результирующего файла, но увеличи- 
вает время компиляции. 

Страница Sorting определяет язык справки и сортировку в предметном указате- 
ле с игнорированием или с учетом различных обозначений (опция Non-spacing- 
marks) и вспомогательных символов, таких, как пунктуация (опция Symbols). 

Страница Files (рис. 8.12) в верхнем окне Help Не позволяет задать имя скомпи- 
лированного файла справки „.Шр, отличное от имени файла Проекта .hpj. В следую- 
щем окне, если хотите, можно задать имя файла протокола, в который будут зано- 
ситься сообщения о ходе компиляции. Следующее окно Rich Text Format (RTF) files 
просто дублирует информацию, которую вы задавали в окне Topic Files, нажав кноп- 
ку Files. Если вы создали для справки файл Содержания .cnt, то вы должны под- 
ключить его к проекту, задав его имя в окне Contents file. В следующем окне TMP 
folder вы можете задать папку для создаваемых в процессе компиляции временных 
файлов. По умолчанию временные файлы создаются в той же папке, в которой ле- 
жит файл Проекта. Впрочем, пока ваш файл меньше 8 Мбайт или пока в нем не 
встретилось ошибочных рисунков, временные файлы вообще не создаются. В ниж- 
нем окне Substitute path ргейх: вы можете указать путь, который будет использовать 
Help Workshop вместо пути, указанного в файле проекта. Этим можно воспользо- 
ваться, если вы, например, перенесли ваши файлы .rtf u .bmp на другой диск или 
на другой сервер. Тогда вместо исправления путей во всем тексте можно восполь- 
зоваться этой опцией. 

Страница FTS позволяет создать файл .fts, для поиска по всему тексту. Впро- 
чем, при желании пользователь может создать этот файл и сам, работая со справ- 
кой и выбрав страницу Поиск. Учтите, что этот файл может быть большого объема. 
Так что решайте, стоит ли создавать его. 
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Puc. 8.12 


Задание имени скомпилированного файла справки 


На странице Font вы можете выбрать шрифт, который будет использоваться в 
диалоговых окнах WinHelp, и осуществить замену шрифтов, использованных в 
файлах тем, на другие шрифты. Страница Macros дает возможность связать ка- 
кие-то выделенные слова в тексте с соответствующим макросом. Страница Build 
Tags позволяет строить на основе одних и тех же файлов тем различные файлы 
справок с помощью описанных ранее CHOCOK *. 


8.3.1.9 Создание простого файла Проекта 


Выше были рассмотрены богатые возможности, предоставляемые Нер 
Workshop при создании файла Проекта справки. У читателя может создаться впе- 
чатление, что все это очень сложно. Однако в действительности при создании дос- 
таточно простых справок или на первых этапах создания даже сложных справок 
не требуется задания всех рассмотренных опций. Для создания файла Проекта 
простой справки достаточно выполнить следующие действия: 


1. В меню Не программы Help Workshop выполнить команду New и в открывшем- 
ся окне выбрать опцию Help Project. Далее в окне Project File Мате надо задать 
имя и каталог файла Проекта справки (каталог выбрать тот, в котором лежит 
файл текстов тем .rtf). 


2. В открывшемся окне Проекта (рис. 8.4) нажать кнопку Files и в окне Topic Files 
(рис. 8.5) щелкнуть на копке Ада и выбрать среди файлов подготовленный 
файл текстов справки. После этого щелкнуть на ОК. 


И это все. Вы можете компилировать ваш файл справки, как рассказано в раз- 
деле 8.3.2, и начать работать с ним. Все остальное — дело совершенствования этой 
справки, ее эстетического оформления и т.п. 


8.3.2 Компиляция и отладка справки 


Когда файл Проекта создан, надо щелкнуть на кнопке Save and Compile в ниж- 
нем правом углу окна рис. 8.4. Файл проекта будет сохранен и откомпилирован, в 
результате чего создастся файл справки .Шр с тем же именем, что и файл проекта, 
или с именем, указанным вами на странице Files окна Options. Кнопкой Save and 
Compile надо пользоваться каждый раз, когда изменяется файл проекта. Если жев 
дальнейшем вы меняете только тексты в файле тем, то компиляцию удобнее про- 
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изводить командой File | Compile или проще — нажав соответствующую быструю 
кнопку с пиктограммой мясорубки (вторая справа на рис. 8.4). Причем вы можете 
это делать, даже не открывая предварительно файла Проекта. В результате выпол- 
нения этой команды откроется окно Compile a Help File (cm. рис. 8.13), в котором вы 
можете выбрать нужный файл проекта и затем щелкнуть на кнопке Compile. Пред- 
варительно удобно установить флаг опции Automatically display Help file in WinHelp 
when done, которая обеспечивает сразу после компиляции просмотр скомпилиро- 
ванного файла справки. Если вы не установили опцию Minimize window while 
compiling, то во время компиляции вы будете видеть окно, с работающей мясоруб- 
кой, отражающей процесс компиляции. Установка указанной опции минимизиру- 
ет это окно. Опция Turn off compression (reduces compile time) позволяет временно от- 
ключить сжатие файла. Это приведет к увеличению размера файла справки, но за- 
метно уменьшит время компиляции больших справок. Опция Include ‚Ш filename 
and topic ID in Help Не включит в файл справки имена файлов текстов тем и иденти- 
фикаторы тем. Это позволит вам в процессе отладки, установив в меню File опцию 
Help Author, получать при просмотре справки оперативную информацию о каждом 
кадре справки. 

Рис. 8.13 Compile a a rae 
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После компиляции вы увидите в окне Help Workshop содержимое текстового 
файла Compilation, в котором содержатся сведения о результатах компиляции. 
Здесь же будут замечания и сообщения 06 ошибках, которые возникнут при непра-. 
вильном исходном файле .rtf. Однако, не спешите огорчаться, получив множество 
сообщений об ошибках. И не бросайтесь сразу искать их и исправлять в вашем 
файле тем. Чаще всего, несмотря на замечания и ошибки, файл справки все-таки 
компилируется и вы можете его посмотреть. В процессе этого просмотра и отладки 
вы скорее найдете ошибки, чем просто отыскивая их в исходном тексте. 

После компиляции при включенной указанной выше опции Automatically display 
Help Не in WinHelp when done вы сразу же можете поработать с откомпилированным 
файлом справки. В дальнейшем просмотр и работа с этим файлом может осуществ- 
ляться или с помощью команды File | Run WinHelp, или соответствующей быстрой 
кнопкой со знаком вопроса (крайняя правая в панели инструментов на рис. 8.4). В 
результате откроется диалоговое окно View Help File (рис. 8.14), из которого запуск 
просмотра осуществляется кнопкой View Help. В верхнем окне File устанавливается 
интересующий файл справки. В окне Project Не устанавливается имя файла проек- 
та. Опция Mapped Topic IDs: позволяет выбрать Ty из тем, указанных в разделе 
[МАР] файла Проекта, которая будет показываться первой. Таким образом вы мо- 
жете моделировать обращение к справке из вашего приложения. Если вы к тому 
же установите опцию Automatically move to пех! ID after View Help is clicked и для начала 
зададите значение Mapped Topic IDs: равным первому из разделов [MAP], то при по- 
следовательных нажатиях на кнопку View Help вы поочередно пройдете весь список 
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внешних входов справки. Опции в нижней части окна позволяют посмотреть, как 
выглядит справка при открытии ее разными способами. Опция Invoked by a program 
соответствует нормальному входу из программы. Опция A pop-up показывает, как 
выглядит тема при ее отображении BO всплывающем окне. Опция A training card со- 
ответствует случаю, когда справка встроена в процесс отладки приложения по ша- 
гам (эта опция реализована не во всех версиях). Опция А double-clicked file icon соот- 
ветствует входу в справку при двойном щелчке на ее пиктограмме. 


Рис. 8.14 View 2 Ге. 
Задание опций просмотра файла справки о. 
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В процессе отладки удобно установить в меню Не опцию Help Author. Тогда при 
просмотре справки вы можете в любом кадре нажать правую кнопку мыши, во 
всплывающем меню выбрать команду Сведения о разделе и увидеть окно (рис. 8.15 
а), в котором указано название раздела (темы), окно, файл справки, исходный 
файл тестов (файл раздела) и идентификатор этого раздела. Сведения о файле и 
идентификаторе темы содержатся в этом окне, если вы при компиляции установи- 
ли опцию Include .rtf filename and topic ID т Help Не. В том же меню, всплывающем 
при нажатии правой кнопки мыши в режиме Help Author, вы можете установить оп- 
цию Запросы при ссылках. Тогда при каждом переходе от темы к теме будут появ- 
ляться окна с запросами, вид которых представлен на рис. 8.15 бив. Это позволит 
вам отследить, в каких случаях и к каким темам осуществляется переход. 


Рис. 8.15 a) 
Окна отладки справки в режиме Help 
Author: сведения о разделе (а) и о 
переходах (6) и (в) 


Е о 
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8.3.3 Файл содержания — .cnt 


Файл Содержания (Contents file), имеющий расширение .cnt, является тексто- 
вым файлом, который можно проектировать с помощью Microsoft Help Workshop 
и присоединять его к файлу Проекта справки. Этот файл обеспечивает при работе 
со справкой страницу Содержание в окне справочной системы, в которой в виде 
пиктограмм открытых и закрытых книг и пиктограмм тем отражается структура 
справки. Чтобы создать новый файл содержания, надо в Help Workshop выполнить 
команду File | New и в окне New выбрать опцию Help Contens. Откроется окно с 3a- 
груженным в него файлом содержания. Вид этого окна можно видеть на рис. 8.16; 
только в первый момент все его окна редактирования будут пустыми. 


Рис. 8.16 
Окно редактирования 
файла Содержание 


(J Содержание справки 


YW Программа 
:$' Назначение программы 
? Инструментальная панель 
7 Меню главное и всплывающее 
2 Окно редактирования 
'F Система подсказок, 
‘2 Стандартные диалоги 
еню 


В верхних окнах надо задать: в левом — имя файла .р и окно по умолчанию 
(если оно определено в файле .hpj), отделив имя окна символом >, в правом — за- 
головок, который будет появляться в окне Содержание при работе справочной сис- 
темы. Заносить информацию в эти окна можно непосредственно, но проще щелк- 
нуть на верхней кнопке Edit и работать в открывающемся при этом диалоговом 
окне. : 

Нижнее окно заполняется с помощью кнопок Add Above и Add Below. Первая из 
этих кнопок вставляет новую строку выше той, в которой находится в данный мо- 
мент курсор, а вторая — ниже этой строки. При нажатии любой из этих кнопок от- 
крывается окно Edit Contents Tab Entry (см. рис. 8.17), в котором вы можете задать 
очередной заголовок (Heading), отображающийся в виде книги, или очередную 
тему (Торс). Для заголовка указывается только его текст (ile). Для темы записыва- 
ется ее название (Tile), которое появится на странице Содержание справки, и иден- 
тификатор темы (Topic 10), указанный в файле тем. Если справка использует не- 
сколько файлов .Шр, то указывается также имя файла (Help Не), содержащего дан- 
ную тему. Может также указываться тип окна (Window type) — одного из тех, KOTO- 
рые указаны в файле проекта (если они там указаны). Если отображение должно 
проводиться в окне по умолчанию, то вид окна не указывается. 

В этом окне можно также задать макрос (Масго) или включить внешний файл 
содержания (Include). Последнее позволяет легко видоизменять при необходимости 
файл содержания, не переписывая его целиком, а включая в него какие-то допол- 
нения, записанные в отдельных файлах. 

Вернемся к рис. 8.16 и рассмотрим остальные кнопки окна редактирования 
файла Содержания. Кнопки Move Right и Move Left позволяют сдвигать вправо и влево 
выделенные строки заголовков и тем, обеспечивая нужные отступы, характери- 
зующие многоуровневую структуру. При этом строки тем, относящихся к одному 


\ 
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Рис. 8.17 
Задание очередного элемента файла 
Содержание 


заголовку, располагаются на один шаг правее своего заголовка и не могут сдви- 
гаться друг относительно друга. Точнее, сдвинуть их можно, но это никак не отра- 
зится на их расположении при работе пользователя со справкой. 

Кнопка Edit позволяет редактировать выделенную строку, а кнопка Remove 
удаляет строку. 

В Help Workshop отсутствует возможность перемещать строки вверх или вниз, 
упорядочивая их последовательность. Подобные перемещения можно делать, от- 
крыв файл Содержания как текстовый в Word и переместив нужные строки сред- 
ствами текстового редактора. | 


8.4 Особенности создания справки, работающей 
на любых версиях Windows 


8.4.1 Ограничения возможностей справки 


Выше была рассмотрена программа Help Workshop, позволяющая быстро и про- 
сто разрабатывать и отлаживать файлы Проекта и Содержания справки. При рабо- 
те с этой программой можно особо не задумываться над синтаксисом файлов. Но 
разработанные с помощью этого инструмента справки годятся только для 32-раз- 
рядных Windows. Они не смогут быть прочитаны средствами Windows 3.x. Поэто- 
му, если вы делаете приложение, рассчитывая на его использование, в частности, 
и в более ранних версиях Windows, то и справку к этому приложению надо делать 
средствами Windows 3.x. 

Конечно, ориентация Ha любые, в TOM числе ранние версии Windows приводит 
к определенным ограничениям возможностей справки. Основные из этих ограни- 
чений следующие: 


Ш Нельзя отображать содержание в виде дерева с изображениями закрытых и от- 
крытых книг, как это делается в 32-разрядных Windows. Соответственно не 
надо писать файл Содержания .cnt. 


Ш В файле тем нельзя использовать сноски А. 


Ш Сноски К в файле тем имеют только один уровень. Соответственно каждая та- 
кая сноска может содержать только одно слово или словосочетание. 


ш Нет многих макросов, в частности, макросов KLink и ALink. Вместо Hux испо- 
льзуется макрос 


JumpKeyword("<yuma файла .rtf>", "<ключевое слово К-сноски>"). 
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Файл Проекта приходится составлять вручную с помощью текстового редакто- 
ра. Компиляция справки осуществляется программами HC31 или HCP. Последняя 
программа предпочтительнее, так как позволяет использовать расширенную и 
виртуальную память. Использовать эти программы очень просто: надо передать 
через командную строку имя файла проекта .hpj. Например, команда: 


HC31 MYHELP.HPJ 
создаст файл справки MYHELP.HLP. 


8.4.2 Синтаксис файла Проекта 


Поскольку при ориентации на любые версии Windows вам придется вручную 
составить текстовый файл .hpj, рассмотрим коротко синтаксис этого файла. 

Файл создается в любом текстовом редакторе и сохраняется в виде текста. Рас- 
ширение файла — „вру, a имя файла должно совпадать с именем результирующего 
файла справки „Вр. При использовании редактора Word для сохранения этого 
файла надо выполнить команду Файл | Сохранить как и в открывшемся диалоговом 
окне установить опцию Тип документа, равной Только текст, а имя файла не забыть 
указать с расширением .hpj, так как иначе программа подставит расширение по 
умолчанию — .txt. 

В текст файла можно вставлять комментарии. Признаком строки коммента- 
PHA является предшествующий ей символ точки с запятой (;). 

Файл состоит из ряда разделов, заголовки которых заключаются в квадратные 
скобки. Головной раздел [OPTIONS] может включать в себя следующие опции (все 
они не обязательны и могут отсутствовать). 

Опция 

СОМТЕМТ5 =<идентификатор кадра содержания> 


задает идентификатор темы, которая обычно включает в себя перечень разделов 
справки. Это та тема, которая открывается при запуске справки и на которую по- 
падает пользователь, работающий со справкой, при нажатии кнопки Содержание. 
По умолчанию (если эта опция не задана) темой, определяющей содержание, явля- 
ется первая тема первого файла тем .rtf. 

Опция 

ТТТЬЕ=<заголовок> 


определяет строку, появляющуюся в заголовке окна справки. Если вы ее не зада- 
ли, то будет использоваться стандартный заголовок. 

Опция 

СОМРВЕ55=<уровень сжатия> 


задает уровень сжатия файла справки при его компиляции. Чем выше уровень сжа- 
тия, тем меньше размер результирующего файла справки, но больше время компи- 
ляции. Поэтому в процессе отладки больших файлов справки целесообразно исполь- 
зовать низкий уровень сжатия, а отлаженную справку откомпилировать с высоким 
‘уровнем сжатия. Небольшие справки можно компилировать сразу с высоким уров- 
нем сжатия. В опции COMPRESS можно задавать следующие значения уровней: 


О О ИСИ 


FALSE, или 0, или NO Быстрая компиляция без сжатия. Большой 
объем результирующего файла 


LEELA REBEL ИОНЫ 


MEDIUM Средний уровень скорости компиляции и 
размера результирующего файла 


HIGH, или TRUE, или 1, или YES Медленная компиляция с высокой степе- 
нью сжатия. Минимальный размер резуль- 
тирующего файла 
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По умолчанию компиляция производится без сжатия. 
Опция 
ЕВКОВГОС=<файл протокола> 


задает имя файла протокола (принятое расширение — .log), в котором записыва- 
ются ошибки, обнаруженные при компиляции. Этот файл нужен только в процессе 
отладки. Если опция ERRORLOG не задана, то сообщения об ошибках отобража- 
ются на экране, но в файл не заносятся. Если ошибок много, то они не поместятся 
на экране и отлаживать будет очень сложно. К тому же файл протокола удобно от- 
крыть в Word одновременно с файлами тем, что ускорит вам поиск и исправление 
ошибок. Поэтому можно рекомендовать при отладках больших справок задавать 
опцию ERRORLOG. 

Из сказанного следует, что раздел [OPTIONS] в простейшем случае может во- 
обще не задаваться, поскольку он не содержит ни одной обязательной опции. 

Не обязательный раздел [CONFIG] может использоваться для указания макро- 
сов, которые должны выполняться при открытии файла справки. Например, вы 
можете указать макросы, включающие какие-то разделы меню или кнопки, отсут- 
ствующие в стандартном окне справочной системы: 


[CONFIG] 

; Включается для кнопки "История" 

CreateButton ("History","&Uctopua", “History()") 

BrowseButtons () ; Включается для появления кнопок "<<", ">>" 
InsertMenu ("mexit"," Выход", 5) ; Добавляет меню "Выход" 
AppendItem("mexit", "exit", "Выход", "ех1{ ()") ; Раздел "Выход" 


Раздел [FILES] включает в себя перечень файлов тем .rtf. Это единственный 
раздел, который обязательно должен присутствовать в файле Проекта справки. 
Имя каждого файла .г начинается с новой строки. Для простой справки с одним 
файлом тем это может быть всего один файл. 

Раздел [МАР] содержит таблицу соответствия идентификаторов тем, исполь- 
зуемых при написании файла .rtf, и номеров контекстной справки, используемых 
в вашем приложении для ссылок на эти темы. Например, если в файле .rtf имеется 
тема с идентификатором Menu, на которую из приложения имеется контекстная 
ссылка 2, и тема с идентификатором Содержание, на которую в приложении име- 
ется ссылка по номеру 1, то раздел [МАР] может иметь вид: 


[МАР] 
menu 2 ; обращение к справке по меню 
Содержание 1 ; обращение к содержанию 


После точек с запятой записаны комментарии, упрощающие понимание таб- 
лицы соответствия идентификаторов и номеров. 

Раздел [WINDOWS] описывает окна справки — основное (main) и вторичные, 
(если они используются). Описание каждого окна имеет вид: 

<Tun> = "<заголовок>", (<х>,<у>, <ширина>, <высота>), 


<развертывание>, (<цвет окна>), 
(<цвет не прокручиваемой части>) 


Первый элемент этого описания — заголовок окна. Для главного окна он не 
указывается, поскольку задается описанной выше опцией TITLE в разделе [ОРТ- 
ONS]. Для вторичных окон заголовок тоже может не задаваться. Следующий эле- 
мент описания — координаты левого верхнего угла окна и его размеры. Следую- 
щий элемент — <развертывание>, может принимать значения 0 (не развертывае- 
мое на весь экран) или 1 (развертываемое). Далее следуют два элемента описания, 
определяющие цвета прокручиваемой и не прокручиваемой частей окна. Каждый 
цвет задается тремя целыми числами, описывающими интенсивность красного, зе- 
леного и синего. Максимальная интенсивность — 255, минимальная — 0. Напри-. 
мер, (255, 255, 255) — белый цвет, (127, 127, 127) — темно серый. Приведем при- 
мер раздела [WINDOWS]: 
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[WINDOWS ] 
main=, (150,50, 800, 800) ,0, (255, 255,255), (127,127,127) 
И1="Пояснения", (10,10, 400, 400) ‚0, (255,255,255), (255,255, 255) 


Раздел [WINDOWS] может отсутствовать, если справка He использует вторич- 
ных окно. Тогда атрибуты главного окна берутся по умолчанию. 

Кроме перечисленных, в.файле Проекта могут быть еще разделы [ALIAS], 
[BUILDTAGS], [BITMAPS], [BAGGAGE]. Эти разделы используются реже, чем опи- 
санные выше, и на них мы не будем останавливаться. 

В заключение приведем примеры файлов Проекта. Как было видно из изло- 
женного выше, в простейшем случае файл может состоять всего из одного раздела, 
содержащего имя одного файла „г: 


[FILES] 
MyTopic.rtf 


Ниже приведен пример более развернутого файла: 


; Файл проекта справки MyHelp. 


{OPTIONS ] / 
ERRORLOG='Errors' ;Файл протокола с сообщениями об ошибках. 
CONTENTS= Содержание;Головная тему.Включать не обязательно. . 
ТТТЬЕ='Тест справки'; Заголовок главного окна. 

COMPRESS=High 


[FILES] 
TOpicsl,rtt ;Файл тем. 
[МАР] 
menu 1 ; Обращение к справке по меню 
Содержание 2 ; Обращение к содержанию 
[WINDOWS ] 


main=, (150,50,800, 800) ‚0, (255, 255,255) , (127,127,127) 
И] ="Пояснения", (10,10, 400,400) ,0, (255,255, 255), (255, 255, 255) 


[CONFIG] 
;Кнопка "История" 
CreateButton ("History", "&История", "History ()") 


‚Кнопки "<<", ">>" 
BrowseButtons () 


;Меню "Выход" 
InsertMenu ("mexit"," Выход", 5) 


;Раздел "Выход" 
AppendiItem("mexit", "exit", "Выход", "exit ()") 


;Раздел "Как использовать справку" 
InsertItem("mnu_help", "Ном", "Как использовать справку", "HelpOn()",0) 


В заключение следует отметить, что, хотя при разработке справок, пригодных 
для любых версий Windows, нельзя использовать программу Help Workshop для от- 
ладки справки, может оказаться полезным все-таки применять ее для предвари- 
тельного составления файла Проекта. При этом облегчается, например, задание 
атрибутов окон и многие другие операции. Однако после того, как файл сформиро- 
ван и справка отлажена, следует открыть в любом текстовом редакторе файл Про- 
екта и убрать из него некоторые операторы, которые не смогут понять программы 
компиляции HC31 и HCP. Затем надо скомпилировать файл справки с помощью 
этих программ. Какие именно операторы следует убрать, вы сможете увидеть по 
тем ошибкам, которые будут отмечены в процессе компиляции. 


асть III 


Создание приложений для работы 
с базами данных 


_ Глава9 — Приложения для работы с локальными 
о базами данных 
_ Глава 10 — Создание приложений для работы с базами 
0 данных в сети 
Глава 11 Обработка и документирование данных 
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Приложения для работы 
с локальными базами данных 


9.1 Базы данных 


9.1.1 Принципы построения баз данных 


Всегда, когда возникает потребность манипулировать большими массивами 
данных, используются базы данных. Работа с базами данных в C++Builder — это 
столь обширная тема, что ей надо было бы посвящать отдельную книгу объемом не 
меньшую, чем та, которую вы сейчас читаете. Поэтому в рамках данной книги мы 
вынуждены будем рассмотреть только основы создания приложений для работы с 
базами данных. Впрочем, этого будет достаточно для того, чтобы строить достаточ- 
но мощные и полезные приложения. 

Допуская, что читатели неплохо знакомы с принципами построения баз дан- 
ных, мы тем не менее очень коротко рассмотрим здесь эти принципы, чтобы в 
дальнейшем использовать единую и понятную всем терминологию. 

База данных — (мы будем говорить о так называемых реляционных базах 
данных) это прежде всего набор таблиц, хотя, как мы увидим позднее, в базу дан- 
ных могут входить также процедуры и ряд других объектов. Таблицу можно пред- 
ставлять себе как обычную двумерную таблицу с характеристиками (атрибутами) 
какого-то множества объектов. Таблица имеет имя — идентификатор, по которому 
на нее можно сослаться. В табл. 9.1 приведен пример фрагмента подобной таблицы 
с именем Pers, содержащей сведения о сотрудниках некоторой организации. Эта 
таблица будет в дальнейшем использоваться в примерах по работе с базами дан- 
ных. Вы можете найти ее на диске, приложенном к книге, или построить сами при 
изучении материала раздела 9.2. 


Таблица 9.1. Пример таблицы данных о сотрудниках Рег$ 


Фамилия Отчество | Год pox- 
дения 


Num [Dep Nam [Par | Year_b — 


11 Бухгал- | Иванов |Иван |Иванович | 1950 
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Столбцы таблицы соответствуют тем или иным характеристикам объектов — 
полям. Каждое поле характеризуется именем и типом хранящихся данных. Имя 
поля — это идентификатор, который используется в различных программах для 
манипуляции данными. Он строится по тем же правилам, как любой идентифика- 
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тор, т.е. пишется латинскими буквами, состоит из одного слова и т.д. Таким обра- 
зом имя — это не то, что отображается на экране или в отчете в заголовке столбца 
(это отображение естественно писать по-русски), а идентификатор, соответствую- 
щий этому заголовку. Например, для таблицы 9.1 введем для последующих ссы- 
лок имена полей Num, Dep, Fam, Nam, Par, Year_b, Sex, Charact, Photo, соответ- 
ствующие указанным в ней заголовкам полей. 

Тип поля характеризует тип хранящихся в поле данных. Это могут быть стро- 
ки, числа, булевы значения, большие тексты (например, характеристики сотруд- 
ников), изображения (фотографии сотрудников) и т.п. 

Каждая строка таблицы соответствует одному из объектов. Она называется 
записью и содержит значения всех полей, характеризующие данный объект. — 

При построении таблиц баз данных важно обеспечивать непротиворечивость 
информации. Обычно это делается введением ключевых полей — обеспечивающих 
уникальность каждой записи. Ключевым может быть одно или несколько полей. В 
приведенном выше примере можно было бы сделать ключевыми совокупность по- 
лей Fam, Мат и Par. Но в этом случае нельзя было бы заносить в таблицу сведе- 
ния о полных однофамильцах, у которых совпадают фамилия, имя и отчество. По- 
этому в таблицу введено первое поле Мит — номер, которое можно сделать ключе- 
вым, обеспечивающим уникальность каждой записи. 


Рис. 9.1. индекс таблица 
Схема перемещения курсора по индексу 


курсор 


При работе с таблицей пользователь или программа как бы скользит курсором 
по записям. В каждый момент времени есть некоторая текущая запись, с которой 
и ведется работа. Записи в таблице базы данных физически могут располагаться 
без какого-либо порядка, просто в последовательности их ввода (появления новых 
сотрудников). Но когда данные таблицы предъявляются пользователю, они долж- 
ны быть упорядочены. Пользователь может хотеть просматривать их в алфавит- 
ном порядке, или рассортированными по отделам, или по мере нарастания года ро- 
ждения и т.п. Для упорядочивания данных используется понятие индекса. Индекс 
показывает, в какой последовательности желательно просматривать таблицу. Он 
является как бы посредником между пользователем и таблицей (см. рис. 9.1). 

Курсор скользит по индексу, а индекс указывает на ту или иную запись табли- 
цы. Для пользователя таблица выглядит упорядоченной, причем он может сме- 
нить индекс и последовательность просматриваемых записей изменится. Но в дей- 
ствительности это не связано с какой-то перестройкой самой таблицы и с физиче- 
ским перемещением в ней записей. Меняется только индекс, т.е. последователь- 
- ность ссылок на записи. 

Индексы могут быть первичными и вторичными. Например, первичным индек- 
сом могут служить поля, отмеченные при создании базы данных как ключевые. А 
вторичные индексы могут создаваться из других полей как в процессе создания са- 
мой базы данных, так и позднее в процессе работы с ней. Вторичным индексам при- 
сваиваются имена — идентификаторы, по которым их можно использовать. 

Если индекс включает в себя несколько полей, то упорядочивание базы дан- 
ных сначала осуществляется по первому полю, а для записей, имеющих одинако- 
вые значения первого поля — по второму ит.д. Например, базу данных персонала 
можно индексировать по отделам, а внутри каждого отдела — по алфавиту. 
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База данных обычно содержит не одну, а множество таблиц. Например, база 
данных о некоторой организации может содержать таблицу имеющихся в ней под- 
разделений с характеристикой каждого из них. Пример такой таблицы с именем 
Dep, которая будет использоваться нами в дальнейшем, приведен в таблице 9.2. 
Имена полей этой таблицы, которые в дальнейшем мы будем использовать: Dep и 
Proisv. 


Таблица 9.2. Пример таблицы данных о подразделениях Dep 


производство 
| Цех 2 | производство 


Отдельные таблицы, конечно, полезны, но гораздо больше информации можно | 
извлечь именно из совокупности таблиц. Например, пользователю может требо- 
ваться узнать общее количество сотрудников, работающих в производственных це- 
хах. Но ни одна из приведенных выше таблиц не поможет ответить на этот вопрос; 
поскольку в таблице Pers отсутствуют сведения о типах отделов, а в таблице 
Dep — о сотрудниках. Для получения ответов на подобные запросы необходимо 
рассмотрение совокупности связных таблиц. 

В связных таблицах обычно одна выступает как главная, а другая или не- 
сколько других — как вспомогательные, управляемые главной. В этом случае 
взаимодействие таблиц иллюстрируется рисунком 9.2. Главная и вспомогательная 
таблицы связываются друг с другом ключом. В качестве ключа могут выступать 
какое-то поля, присутствующие в обеих таблицах. Например, в приведенных ра- 
нее таблицах головной может быть таблица Dep, вспомогательной Pers, a связы- 
ваться они могут по полю Dep, присутствующему в обеих таблицах. Курсор сколь- 
зит по индексу главной таблицы. Каждой записи в главной таблице ключ ставит в 
соответствие в общем случае множество записей вспомогательной таблицы. Так в 
нашем примере каждой записи главной таблицы Оер соответствуют те записи 
вспомогательной таблицы Pers, в которых ключевое поле Dep с названием отдела 
совпадает с названием отдела в текущей записи главной таблицы. Иначе говоря, 
если в текущей записи главной таблицы в поле Dep написано «Бухгалтерия», то во 
вспомогательной таблице Рег5 выделяются все записи сотрудников бухгалтерии. 


Рис. 9.2. anes таблица 
Схема взаимодействия 
главной и 
вспомогательной 
таблицы 


индекс 
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Создают базы данных и обрабатывают запросы к ним системы управления ба- 
зами данных — СУБД. Известно множество СУБД, различающихся своими воз- 
можностями или обладающих примерно равными возможностями и конкурирую- 
щих друг с другом: Paradox, dBase, Microsoft Access, FoxPro, Oracle, InterBase, 
Sybase и много других. 

Разные СУБД по-разному организуют и хранят базы данных. Например, 
Paradox и dBase используют для каждой таблицы отдельный файл. В этом случае 
база данных — это каталог, в котором хранятся файлы таблиц. В Microsoft Access 
и в InterBase несколько таблиц хранится как один файл. В этом случае база дан- 
ных — это имя файла с путем доступа к нему. Системы типа клиент/сервер, такие, 
как серверы Sybase или Microsoft SQL, хранят все данные на отдельном компьюте- 
pe и общаются с клиентом посредством специального языка, называемого SQL (см. 
раздел 10.1). 

Поскольку конкретные свойства баз данных очень разнообразны, пользовате- 
лю было бы весьма затруднительно работать, если бы он должен был указывать в 
своем приложении все эти каталоги, файлы, серверы и т.п. Да и приложение часто 
пришлось бы переделывать при смене, например, структуры каталогов и при пере- 
ходе с одного компьютера на другой. Чтобы решить эту проблему, используют 
псевдонимы баз данных. /1севдоним (alias) содержит всю информацию, необходи- 
мую для обеспечения доступа к базе данных. Эта информация сообщается только 
один раз при создании псевдонима. А приложение для связи с базой данных ис- 
пользует псевдоним. В этом случае приложению безразлично, где физически рас- 
положена та или иная база данных, а часто безразлична и СУБД, создавшая и 06- 
служивающая эту базу данных. При смене системы каталогов, сервера и т.п. ниче- 
го в приложении переделывать не надо. Достаточно, чтобы администратор базы 
данных ввел соответствующую информацию в псевдоним. 

При работе с базами данных часто используется кэширование всех изменений. 
Это означает, что все изменения данных, вставка новых записей, удаление сущест- 
вующих записей, т.е. все манипуляции с данными, проводимые пользователем, 
сначала делаются не в самой базе данных, а запоминаются в памяти во временной, 
виртуальной таблице. И только по особой команде после всех проверок правильно- 
сти вносимых в таблицу данных пользователю предоставляется возможность или 
зафиксировать все эти изменения в базе данных, или отказаться от этого и вер- 
нуться к тому состоянию, которое было до начала редактирования. 

Фиксация изменений в базе данных осуществляется с помощью транзакций. 
Это совокупность команд, изменяющих базу данных. На протяжении транзакции 
пользователь может что-то изменять в данных, но это только видимость. В дейст- 
вительности все изменения сохраняются в памяти. И пользователю предоставляет- 
ся возможность завершить транзакцию или внесением всех изменения в реальную 
базу данных, или отказом от этого с возвратом к тому состоянию, которое было до 
начала транзакции. 


9.1.2 Типы баз данных 


Для разных задач целесообразно использовать различные модели баз данных, 
поскольку, конечно, базу данных сведений о сотрудниках какого-то небольшого 
коллектива и базу данных о каком-нибудь банке, имеющем филиалы во всех кон- 
цах страны, надо строить по-разному. 

Процесс определения того, какая база данных более подходит для конкретно- 
го приложения, называется масштабированием. Это сложная задача, которую мы 
не будем затрагивать. Однако, прежде, чем двигаться дальше, необходимо иметь 
представление о возможных моделях баз данных, поскольку это влияет на по- 
строение приложений в C++Builder. 


а ай 
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В следующих разделах коротко рассмотрены четыре модели баз данных: 
Автономные 

Файл-серверные 

Клиент/сервер 

Многоярусные 


Прежде, чем переходить к рассмотрению различных моделей баз данных, OT- 
метим, что работа с данными в C++Builder в основном осуществляется через 
Borland Database Engine (BDE) — процессор баз данных фирмы Borland. Соответст- 
вующая программа должна быть поставлена на компьютере пользователя во всех 
моделях баз данных, кроме многоярусных. 


9.1.2.1 Автономные базы данных 


Автономные локальные базы данных являются наиболее простыми. Они хра- 
нят свои данные в локальной файловой системе на том компьютере, на котором ус- 
тановлены; система управления и машина базы данных, осуществляющая к ним 
доступ, находится на том же самом компьютере. Сеть не используется. Поэтому 
разработчику автономной базы данных не приходится иметь дело с проблемой па- 
раллельного доступа, когда два человека пытаются одновременно изменить одну и 
ту же запись, потому что такого никогда не может быть. Вообще, автономные базы 
данных не используются для приложений, требующих значительной вычисли- 
тельной мощности, потому что процессорное время будет потрачено на выполнение 
манипуляций с данными и в целом будет потеряно для приложения. 

‚ Автономные базы данных полезны для развития тех приложений, которые 
распространены среди многих пользователей, каждый из которых поддерживает 
отдельную базу данных. Это, например, приложения, обрабатывающие документа- 
цию небольшого офиса, кадровый состав небольшого предприятия, бухгалтерские 
документы небольшой бухгалтерии. Каждый пользователь такого приложения ма- 
нипулирует своими собственными данными на своем компьютере. Пользователю 
нет необходимости иметь доступ к данным любого другого пользователя, так что 
отдельная база данных здесь вполне приемлема. 


9.1.2.2 Файл-серверные базы данных 


Файл-серверные базы данных отличаются от автономных тем, что они могут 
быть доступны многим клиентам через сеть. Это очень удобно, так как изменения 
в таких базах данных видят все пользователи. Например, базу данных сотрудни- 
ков крупного учреждения целесообразно делать именно такой, чтобы администра- 
торы отдельных подразделений обращались к ней, а не заводили у себя локальные 
базы данных (при этом можно сделать так, чтобы каждый администратор видел 
только ту информацию, которая относится к его подразделению). 

Сама база данных хранится на сетевом файл-сервере в единственном экземп- 
ляре. Для каждого клиента во время работы создается локальная копия данных, с 
которой он манипулирует. При этом возникают (и решаются) проблемы, связан- 
ные с возможным одновременным доступом нескольких пользователей к одной и 
той же информации. Например, при проектировании приложений, работающих с 
подобными базами данных, должны быть решены такие проблемы: что делать, 
если пользователь прочел некоторую запись и, пока он ее просматривает и собира- 
ется изменить, другой пользователь меняет или удаляет эту запись. 

Одним из недостатков баз данных файл-сервер является непроизводительная 
загрузка сети. При каждом запросе клиента данные в его локальной копии полно- 
стью обновляются из базы данных на сервере. Даже если запрос относится всего к 
одной записи, обновляются все записи данных. Если записей в базе данных много, 
то даже при небольшом числе клиентов сеть будет загружена очень основательно, 
что серьезно скажется на скорости выполнения запросов. 
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Другой недостаток связан с тем, что забота о целостности данных при такой 
организации работы возлагается на программы клиентов. Если они недостаточно 
тщательно продуманы, в базу данных легко занести ошибки, которые могут отра- 
зиться на всех пользователях. 


9.1.2.3 Базы данных клиент/сервер 


Для больших баз данных с множеством пользователей часто используются 
базы данных на платформе клиент/сервер. В этом случае доступ к базе данных для 
группы клиентов выполняется специальным компьютером — сервером. Клиент 
_ дает задание серверу выполнить те или иные операции поиска или обновления 
базы данных. И мощный сервер, ориентированный на операции с запросами са- 
мым оптимальным способом, выполняет их и сообщает клиенту результаты своей 
работы. 

Подобная организация работы повышает эффективность выполнения прило- 
жений за счет использования мощности сервера, разгружает сеть, обеспечивает хо- 
роший контроль целостности данных. 

В базах данных клиент/сервер возникает дополнительная проблема — спроек- 
тировать приложение так, чтобы оно максимально использовало возможности сер- 
вера и минимально нагружало сеть, передавая через нее только минимум инфор- 
мации. 


9.1.2.4 Многоярусные базы данных : 


Это новый и многообещающий путь обработки данных в сети. Иногда (в част- 
ности, в документации C++Builder) этот способ организации баз данных называет- 
ся multitier — многонитевые. В этом термине под нитью понимается один из MHO- 
жества потоков данных, обменивающихся одновременно с базой данных. 

Наиболее распространен трехярусный вариант: 


ш На нижнем уровне на компьютерах пользователя расположены приложения 
клиентов, обеспечивающие пользовательский интерфейс. 


Ш На втором уровне расположен сервер приложений, обеспечивающий обмен 
данными между пользователями и распределенными базами данных. Сервер 
приложений размещается в узле сети, доступном всем клиентам 


Ш На третьем уровне расположен удаленный сервер баз данных, принимающий 
информацию от серверов приложений и управляющий ими. 


Подобную концепцию обработки данных пропагандируют, в частности, фир- 
мы Oracle и Sun. Первый, элементарный уровень состоит из «тонких клиентов», TO 
есть несложных терминалов, предназначенных, в основном, для ввода — вывода. 
Второй, средний (middleware) уровень — это рабочие станции и серверы приложе- 
ний, то есть значительно более серьезные машины, на которых выполняются про- 
граммы, критичные к загрузке процессора. Третий и последний уровень — мощ- 
ные специализированные серверы баз данных. 

Отметим одну особенность многоярусных распределенных баз данных: в них 
на нижнем уровне — на компьютерах пользователя не требуется установка 
Borland Database Engine (BDE). В этом заключается одно из преимуществ такой ор- 
ганизации баз данных. 


9.1.3 Технологии СОМ и CORBA 


Для создания распределенных СУБД в настоящее время используются в основ- 
ном две технологии: СОМ и СОВВА. Кроме того в связи с бурным развитием Ин- 
тернет все большее значение приобретает технология Web, которая, возможно, в 
будущем станет определяющей. 
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В рамках данной книги распределенные СУБД рассматриваться не будут. Со- 
ответственно, не будут рассматриваться и связанные с построением таких баз дан- 
ных компоненты Provider, ClientDataSet, RemoteServer и др. Тем не менее, ниже 
даются некоторые основные понятия, связанные с созданием распределенных при- 
ложений, поскольку без этого картина организации работы с базами данных была 
бы неполной. 

Технология СОМ (компонентная модель объекта ) разработана корпорацией 
Microsoft. Ее назначение — предоствление возможности одной программе (клиен- 
ту) работать с объектом другой программы (сервера). СОМ - это модель объекта, ко- 
торая предусматривает полную совместимость во взаимодействии между компо- 
нентами, написанными разными компаниями и на разных языках. При этом кли- 
ент и сервер могут располагаться на разных компьютерах. 

На СОМ основаны такие технологии Microsoft, как OLE, Automation OLE, 
ActiveX, ОСХ. На СОМ построен, например, весь интерфейс Windows 98. 

СОМ определяет унифицированный двоичный интерфейс, полностью незави- 
симый от языка программирования, использованного при реализации компонен- 
та. Компонент, написанный в соответствии со спецификациями двоичного интер- 
фейса СОМ, может вступать во взаимодействие с другим компонентом, не зная в 
действительности ничего о реализации носледнего. 

Каждый интерфейс имеет уникальный идентификатор IID (Interface 
Identifier), являющийся частным случаем GUID (Global Unique Identifier) — гло- 
бального идентификатора, используемого в Windows. Параметры интерфейса опи- 
сывают некоторый класс с идентификаторм CLSID (Class ID), в котором объявлены 
поля, свойства, методы, параметры обращения к свойствам и методам. Таким об- 
разом, клиент с помощью этого интерфейса может использовать объект СОМ серве- 
ра так же, как свой собственный объект. Любой объект СОМ имеет интерфейс 
IUnknown, с помощью которого получает доступ к основному интерфейсу объекта. 

Сервер СОМ реализуется в виде программы или DLL. Если клиент и сервер 
располагаются на разных компьютерах, используется распределенный вариант 
COM — DCOM. При этом обмен информацией между клиентом и сервером осущест- 
вляется двумя промежуточными программами: Proxy (уполномоченный) и Stub 
(заглушка). Ргоху располагается на машине клиента. Получив от клиента запрос, 
Ргоху упаковывает его в пакет СОМ и переправляет на машину сервера. Там этот 
пакет перехватывает Stub, распаковывает пакет и передает запрос серверу. Таким 
образом, запрос выполняется на машине сервера. 

CORBA (Common Object Request Broker Architecture) — это стандарт построе- 
ния приложений с распределенными объектами. Разработчиком CORBA является 
отраслевой комитет ОМС (Obgect Management Group — группа управления объек- 
тами), представляющий многие фирмы. Взаимодействие клиента и сервера в 
CORBA осуществляется через ряд посредников. На машине клиента размещается 
Stub и ORB (Object Require Broker). Клиент обращается к Stub так, как если бы это 
был сам объект. При этом используется интерфейс объекта, предоставляемы кли- 
енту с помощью Stub. 

Stub транслирует полученный от клиента вызов какого-то метода объекту 
ORB, а тот передает соответствующее сообщение в сеть. В сетевом окружении кли- 
ента располагаются объекты Smart Agent (интеллектуальные агенты). Сообщение, 
переданное объектом ORB, перехватывает один из Smart Agent, отыскивает сете- 
вой адрес соответствующего сервера и передает полученное сообщение на машину 
сервера. На машине сервера сообщение воспринимает расположенный там объект 
ORB. Он передает его расположенному там же объекту BOA (Basic Object Adapter - 
базовый адаптер объекта). ВОА может проводить фильтрацию запросов, опреде- 
ляя, какой уровень доступа разрешен данному клиенту и вообще разрешено ли об- 
рабатывать такой запрос данного клиента. Если доступ разрешен, то ВОА передает 
вызов в особый объект сервера — Skeleton, который и реализует сам вызов. 
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Интерфейс в CORBA описывается с помощью специального языка IDL 
(Interface Definition Language), напоминающего С++. Компилятор IDL создает в 
процессе компиляции объекты Stub и Skeleton данного интерфейса. Использова- 
ние языка высокого уровня в сочетании с компилятором позволяет делать обмен 
данными независимым от аппаратных средств. Поэтому клиент и сервер могут рас- 
полагаться на машинах разных платформ, например, на персональном компьюте- 
pe IBM и рабочей станции Sun. 

При обмене информацией между ORB и Smart Agent используется протокол 
UDP. Для реализации CORBA в сетевом окружении клиента должен существовать 
хотя бы один объект Smart Agent. Обычно в локальной сети Smart Agent распола- 
гается на головной машене, ав Интернет — на одном из узлов. При создании сер- 
вера он регистрируется в Smart Agent. Таким образом Smart Agent знает, где най- 
ти тот или иной сервер, а при отказе одного сервера может переключится на дру- 
гой. Это повышает надежность работы. 


9.1.4 Организация связи с базами данных в C++Builder 


Основой работы C++Builder с базами данных является Borland Database 
Engine (BDE) — процессор баз данных фирмы Borland. BDE служит посредником 
между приложением и базами данных. Он предоставляет пользователю единый 
интерфейс для работы, развязывающий пользователя от конкретной реализации 
базы данных. Благодаря этому не надо менять приложение при смене реализации 
базы данных. Приложение C++Builder никогда не обращается непосредственно к 
базе данных, а только к BDE. Таким образом, общение с базами данных соответст- 
вует схеме, приведенной на рис. 9.3. 

Приложение C++Builder, когда ему нужно связаться с базой данных, рае 
ся к BDE и сообщает обычно псевдоним базы данных и необходимую таблицу в ней. 
BDE реализован в виде динамически присоединяемых библиотек DLL (файлы 
IDAPIO1.DLL, IDAPI382.DLL). Они, как и любые библиотеки, снабжены API (Appli- 
cation Program Interface — интерфейсом прикладных программ), названным [DAPI 
(Integrated Database Application Program Interface). Это список процедур и функций 
для работы с базами данных, которым и пользуются приложения. 

BDE по псевдониму находит подходящий для указанной базы данных драй-- 
вер. Драйвер — это вспомогательная программа, которая понимает, как общаться 
с базами данных определенного типа. Если в BDE имеется собственный драйвер со- 


Рис. 9.3. Приложение CBuilder 
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ответствующей СУБД, то ВПЕ связывается через него с базой данных и с нужной 
таблицей в ней, обрабатывает запрос пользователя и возвращает в приложение ре- 
‚ зультаты обработки. BDE поддерживает естественный доступ к таким базам дан- 
ных, как Microsoft Access, FoxPro, Paradox, dBase. 

Если собственного драйвера нужной СУБД в ВПЕ нет, то используется драйвер 
ODBC. ODBC (Open Database Connectivity) — это DLL, аналогичная по функциям 
BDE, но разработанная фирмой Microsoft. Она хранится в файле ODBC.DLL. По- 
скольку Microsoft включила поддержку ODBC в свои офисные продукты и для 
ODBC созданы драйверы практически к любым СУБД, фирма Borland включила в 
ВПЕ драйвер, позволяющий использовать ODBC. Правда, работа через ODBC осу- 
ществляется несколько медленнее, чем через собственные драйверы СУБД, вклю- 
ченные в BDE. Но благодаря связй с ODBC масштабируемость C++Builder сущест- 
венно увеличилась и сейчас из C++Builder можно работать с любой сколько-ни- 
будь значительной СУБД. 

BDE поддерживает SQL — стандартизованный язык запросов, позволяющий 
обмениваться данными с SQL-ceppepamu, такими, как Sybase, Microsoft SQL, 
Oracle, Interbase. Эта возможность используется особенно широко при работе на 
платформе клиент/сервер и в распределенных базах данных. 

В C++Builder 5 введена другая альтернативная возможность работы с базами 
данных, минуя BDE. Это разработанная в Microsoft технология ActiveX Data 
Objects (ADO). ADO - это пользовательский интерфейс к любым типам данных, 
включая реляционные и не реляционные базы данных, электронную почту, сис- 
темные, текстовые и графические файлы. Связь с данными осуществляется по- 
средством так называемой технологии OLE DB. 

Использование ADO обеспечивает более эффективную работу с данными. Од- 
нако, надо сказать, что возможности ADO в C++Builder пока в некоторых отноше- 
ниях ниже, чем возможности BDE. Поэтому в дальнейшем мы в основном сосредо- 
точимся на работе с BDE. А особенности использования ADO будут рассмотрены в 
главе 10 в разделе 10.4. 

Еще один альтернативный доступ к базам данных Interbase введен в 
C++Builder 5 на основе технологии InterBase Express (ТВХ). В библиотеке компо- 
нентов C++Builder 5 имеется страница InterBase, содержащая компоненты для ра- 
боты с InterBase, минуя ВПЕ. Эти компоненты обеспечивают повышенную произ- 
водительность и позволяют использовать новые возможности сервера InterBase, не- 
доступные обычным компонентам BDE. Этот новый вариант связи с базами дан- 
ных будет рассмотрен в главе 10 в разделе 10.5. 


9.2 Создание баз данных с помощью 
Database Desktop 


9.2.1 Создание новой таблицы 


Прежде, чем начать строить приложения, работающие с базами данных, надо 
иметь сами базы данных. C++Builder поставляется с примерами, имеющими немало 
баз данных, которыми можно воспользоваться для обучения. Базы данных Pers и 
Dep, фрагменты которых были приведены выше в таблицах 9.1 и 9.2 и которые бу- 
дут использоваться в примерах данной и последующей глав книги, вы можете найти 
на диске, приложенном к этой книге. Но можно и самим создать необходимые базы 
данных. Причем не обязательно для этого использовать стандартные СУБД. Вместе 
с BDE и C++Builder поставляется программа Database Desktop (файл DBD.EXE для 
16-разрядных приложений, файл DBD32.EXE для 32-разрядных приложений, файл 
DBDLOCAL.EXE — файл конфигурирования), которая позволяет создавать таблицы 
баз данных некоторых СУБД, задавать и изменять их структуру. 
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Обычно вызов Database Desktop включен в главное меню C++Builder в раздел 
Tools. Если это не сделано, то полезно включить его туда с помощью команды 
Tools | Configure Tools (см. раздел 14.2.4 главы 14). Вызовите Database Desktop. Вы 
увидите окно, показанное на рис. 9.4 (если в предыдущем сеансе работы с Database 
Desktop не была открыта какая-то таблица, то таблицы в середине окна не будет 
видно и разделов меню будет поменьше). 


Рис. 9.4. 
Главное окно программы Database Desktop 


1g ТаЫе : -dbP:Pes DB ; 


Давайте создадим с помощью Database Desktop таблицу базы данных СУБД 
Paradox 7. В Paradox 7 база данных — это каталог, в котором лежат таблицы — 
файлы с расширением .db. Поэтому прежде надо создать соответствующий каталог 
с помощью любой программы Windows, например, с помощью «Проводника». Да- 
лее выполните команду File | New в окне Database Desktop. Вам откроется подменю, 
содержащее три варианта: 


ОВО ИИ RE SE CEES GEE НСС SEITE ARE EEG EEE ОВ ОРЗ ОИ о РИО 


“QBE ‘Query Визуальный построитель запросов и запись этих запросов в файл 
SQL File Создание запроса Ha SQL и запись ero в файл 
Table ‚ Создание новой таблицы 


Выберите Table. Вам откроется небольшое диалоговое окно (рис. 9.5). В нем из 
выпадающего списка вы можете выбрать СУБД, для которой хотите создать табли- 
цу. Выберите Paradox 7. Вы увидите окно, представленное на рис. 9.6. В этом окне 
вы можете задать структуру таблицы (поля и их типы), создать вторичные индек- 
сы, ввести диапазоны допустимых значений полей, значения по умолчанию и вве- 
сти много иной полезной информации о создаваемой таблице. 


Рис. 9.5. teate Table 
Окно выбора СУБД 


9.2.2 Задание полей 


Для каждого поля создаваемой таблицы прежде всего указывается имя (Field 
Мате) — идентификатор поля. Он может включать до 25 символов и не может начи- 
наться с пробела (но внутри пробелы допускаются). Затем надо выбрать тип (Туре) 
данных этого поля. Для этого перейдите в раздел Туре поля и щелкните правой 
кнопкой мыши. Появится список доступных типов, из которого вы можете выбрать 
необходимый вам. Приведем пояснения типов данных, используемых в Paradox. 


\ 
\ 
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Рис. 9 6 st an Рагадох 5.0 for Windows sc te nance 


Окно создания структуры таблицы 
Paradox 7 


: > Pal Default value. о 


i Рем 1: 


‘ideo Pama Niotenasnne ан 
| чение (Size) в списке 
1-255 | Alpha Строковое поле, содержащее любые печатаемые 
ASCII символы. Размер — число символов. 


Действительные числа от -10307 до 10308 с 15 
значащими разрядами. Для выбора формата 
представления надо использовать Paradox. 


Положительные или отрицательные числа, OT- 
личающиеся от Number формой представле- 
ния и символом денежной единицы. Для вы- 
бора формата представления надо использо- 
вать Рагадох. 


2 147 483 647. 


Числа в формате BCD (Binary Coded Decimal). 
Вычисления с этими числами проводятся с по- 
вышенной точностью по сравнению с другими 
типами чисел, но медленнее. Этот тип введен 
для совместимости с другими приложениями, 
использующими BCD. В поле типа BCD можно 
вводить до 15 значащих разрядов. 


a 


Значения, представляющие собой даты. Для 
выбора формата представления надо использо- 
вать Рагадох. 


Значения, представляющие собой время. Для 
выбора формата представления надо использо- 
вать Рагадох. 


Timestamp |Значения, хранящие время и дату. Для выбо- 
ра формата представления надо использовать 
Paradox. При вводе значения в поле типа Т1- 
mestamp пользователь может последовательно 
нажимать клавишу пробела, чтобы ввести те- 
_| кущее время и дату. 


yi 
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] 


Обозна- | Размер | Обозначение | Пояснение 
чение | (Size) в списке 


1 - 240 


ани 


Поля для хранения текстов неограниченной 
длины. Тексты хранятся в отдельных файлах 
mb. Указываемый размер — это число пер- 


вых символов текста, хранящихся непосредст- 
венно в таблице. Просмотр полей Мето возмо- 
жен в Paradox или в приложениях C++Buil- 
der. 


0 - 240 | Formatted Поля для хранения форматированных текстов 
неограниченной длины. Тексты хранятся в OT- 
дельных файлах .mb. Указываемый размер — 
это число первых символов текста, хранящих- 
ся непосредственно в таблице. Просмотр полей 
Formatted Memo возможен в Paradox или в 


приложениях C++Builder. 


Изображения из файлов в форматах .bmp, 

„рсх, .tif, .gif или .eps. Database Desktop пре- 
образует их в формат .ВМР. Просмотр полей 
Graphic возможен в Paradox или в приложе- 
ниях C++Builder. 


OLE Данные типа OLE - изображения, звуки, доку- 
менты. Database Desktop не поддерживает 


Autoincre- 
ment 


поля этого типа. Просмотр полей OLE возмо- 
жен в Paradox или в приложениях C++Buil- 
der. 


Логические поля. По умолчанию возможные 
значения — true и false: При вводе данных 
пользователь может ввести только первый 
символ из возможных значений. 


Автоматически увеличивающееся на 1 длин- 
ное целое. Только для чтения. При удалении 
записей значения полей в оставшихся записях 
не изменяются. 


Binary Данные, хранящиеся в отдельных двоичных 
файлах .mb, которые Database Desktop He ин- 
| терпретирует. В файлах могут храниться 3By- 
| ки и любые другие данные. 


| 
1 - 255 | Bytes Данные, которые Database Desktop He интерп- 
ретирует. В отличие от полей Binary хранятся | 
в таблице, а не во внешних файлах. | 


В нашем примере таблицы Pers (см. таблицу 9.1) для поля Num целесообразно 
выбрать тип Autoincrement, обеспечивающий уникальность каждой записи. Для 
полей Dep, Fam, Nam и Par необходимо задать тип Alpha, для поля Year_b — тип 
Short, для поля Sex — Logical, для поля Charact — Memo, для поля Photo — Gra- 
phic. В таблице Dep (cm. таблицу 9.2) для поля Dep надо задать тип Alpha, a для 
поля Proisv — Logical. 

Для некоторых типов необходимо задавать размер (Size). Например, для стро- 
кового типа Alpha размер — это число символов. 
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Ключевые поля должны быть отмечены символом «*» в последней колонке. 
Для того, чтобы поставить или удалить этот символ, надо или ‘сделать двойной 
щелчок в соответствующей графе информации о поле, или выделить эту графу и 
нажать клавишу пробела. Если имеется несколько ключевых полей, то в таблицах 
Paradox они должны быть первыми. В нашем примере для таблицы Pers ключевым 
является поле Num, а для таблицы Dep — поле Dep. 


9.2.3 Задание свойств таблицы 


Теперь обратите внимание на правую часть окна (рис. 9.6). В нем задаются 
свойства таблицы (Table properties). Вверху имеется выпадающий список с рядом 
разделов. 


9.2.3.1 Validity Checks — проверка правильности значений 


Начнем с первого из них: Validity Checks — проверка правильности значений. 
Вид правой части окна при выборе этого раздела показан на рис. 9.6 и может не- 
сколько изменяться в зависимости от того, какой тип у поля, выделенного курсо- 
ром. Вы можете задать следующие характеристики поля: 


ой а в С О В В и 


Required field Этим индикатором отмечаются те поля, значения которых pris 
зательно должны содержаться в каждой записи. Для нашего 
примера такими полями, вероятно, должны быть поля Fam, 
Nam и Par 


Minimum Минимальное значение. Это свойство полезно задавать для чис- 
ловых полей. В нашем примере надо задать минимальное зна- 
чение для поля Уеаг_Ъ 


Maximum Максимально значение. Это свойство полезно задавать для чис- 
ловых полей. В нашем примере надо задать максимальное зна- 
чение для поля Year_b 


Default Значение по умолчанию. Это свойство полезно задавать для 
числовых и логических полей. В нашем примере полезно за- 
дать значение по умолчанию для поля Уеаг_Ъ и обязательно 
надо задать значение по умолчанию для поля Sex (иначе у по- 
льзователя могут возникнуть проблемы при вводе информации) 


Picture Шаблон для ввода данных. Например, можно задать шаблон 
номера телефона «###-##-##» и др. Подробнее о составле- 
нии шаблонов вы можете узнать во встроенной справке Databa- 
se Desktop 


Assist Эта кнопка вызывает диалоговое окно, помогающее создать 
шаблон Picture и занести его в список, из которого в дальней- 
шем его можно брать при создании новых таблиц 


9.2.3.2 Table Lookup — таблица просмотра 


Следующий раздел в выпадающем списке свойств таблицы в правом верхнем 
углу экрана на рис. 9.6: Table Lookup — таблица просмотра. Этот’раздел позволяет 
связать с полем данной таблицы какое-то поле другой, просматриваемой таблицы, 
из которого будут браться допустимые значения. При выборе Table Lookup на экра- 
не появляется кнопка Define — определить. При ее нажатии открывается диалого- 
вое окно, показанное на рис. 9.7. В нем вы можете для данного поля задать табли- 
цу просмотра (Lookup table). При этом вы можете воспользоваться выпадающим 
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Рис. 9.7. Table Lookup 
Окно задания таблицы просмотра 


списком драйверов или псевдонимов (Drive or Alias) и кнопкой просмотра (Browse). А 
затем кнопкой со стрелкой занести поле просматриваемой таблицы, -из которого 
будут браться допустимые значения. В нашем примере пока все это сделать невоз- 
можно, поскольку еще не создана вторая таблица Dep. Однако, после того, как она 
будет создана, полезно вернуться к таблице Pers и для поля Dep задать таблицу Dep 
как просматриваемую и ее поле Dep как множество возможных значений. Это пре- 
дотвратит ошибочное появление в таблице Pers каких-то значений подразделений, 
не содержащихся в таблице Dep. 


9.2.3.3 Secondary Indexes — вторичные индексы 


Следующий раздел в выпадающем списке свойств таблицы: Secondary 
Indexes — вторичные индексы. Этот раздел позволяет создать необходимые для 
дальнейшей работы вторичные индексы (первичный индекс создается по ключе- 
вым полям). Например, для дальнейшего использования нашей таблицы Pers по- 
‚ лезны будут следующие индексы: | 


мя индекса Поля Пояснение 


| 

| 

Упорядочивание таблицы сотрудников по алфавиту. | 

| 

| depfio Упорядочивание таблицы по подразделениям, a | 
| внутри каждого подразделения упорядочивание со- | 
| трудников по алфавиту. | 
| year Упорядочивание таблицы по году рождения сотруд- | 
| ников, | 
= a — — a ри аа iene . = = 


a 


Чтобы создать новый вторичный индекс, нажмите кнопку Define — опреде- 
лить. Откроется диалоговое окно, представленное на рис. 9.8. В его левом окне 
Fields содержится список доступных полей, в правом окне Indexed fields вы можете 
подобрать и упорядочить список полей, включаемых в индекс. Для переноса поля 
из левого окна в правое надо выделить интересующее вас поле или группу полей и 
нажать кнопку со стрелкой вправо. Стрелками Change order (изменить последова- 
тельность) можно изменить порядок следования полей в индексе. 

Панель радиокнопок Index Options (опции индекса) позволяют установить сле- 
дующие характеристики: 
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Рис. 9.8. Define Secondary Index 
Окно задания вторичного индекса 


Unique Установка этой опции не позволяет индексировать таблицу, если 
в ней находятся дубликаты совокупности включенных в индекс 
полей. Например, установка этой опции для индекса Йо не допус- 
тила бы наличия в таблице сотрудников с совпадающими фами- 
лией, именем и отчеством 


Descending При установке этой опции таблица будет упорядочиваться по сте- 
пени убывания значений (по умолчанию упорядочивание произво- 
дится по степени нарастания значений) 


Case Sensitive При установке этой опции будет приниматься во внимание ре- 
гистр, в котором введены символы 


Maintained Если эта опция установлена, то индекс обновляется при каждом 
изменении в таблице. В противном случае индекс обновляется то- 
лько в момент связывания с таблицей или передачи в нее запро- 
са. Это несколько замедляет обработку запросов. Поэтому полезно 
включать эту опцию для обновляемых таблиц. Если таблица ис- 
пользуется только для чтения, эту опцию лучше не включать 


После того, как индекс сформирован, щелкаете на кнопке ОК. Открывается 
окно (рис. 9.9), в котором вы задаете имя индекса. 


Рис. 9.9. Save Index As 
Задание имени индекса НЫ 


9.2.3.4 Referential Integrity — целостность на уровне ссылок 


Следующий раздел в выпадающем списке свойств таблицы в правом верхнем 
углу экрана на рис. 9.6: Referential Integrity — целостность на уровне ссылок. Речь 
идет о способах, позволяющих обеспечить постоянные связи между данными от- 
дельных таблиц. Если устанавливается целостность на уровне ссылок между дву- 
мя таблицами, одна из которых — головная (родительская), а другая — вспомога- 
тельная (дочерняя), то во вспомогательной таблице указывается поле или группа 
полей, которые могут брать свои значения только из ключевого поля (или полей) 
головной таблицы. Подобные связи допустимы не для всех типов таблиц, но в 
Paradox они предусмотрены. Прежде, чем создавать Referential едйу, ‘надо иметь 
обе связываемые таблицы. — родительскую и дочернюю. Если бы мы уже имели в 
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нашем примере обе таблицы — Pers и Dep, мы могли бы задать целостность, связав 
поле Dep таблиц Pers с ключевым полем Dep головной таблицы Dep. Чтобы ввести 
подобную связь, надо сначала установить в качестве рабочего каталог, содержа- 
щий обе таблицы (это делается командой File | Working Directory). Затем надо открыть 
дочернюю таблицу Pers (команда File | Open), войти в режим ее реструктуризации 
(команда Table | Restructure) и в окне Table properties выбрать раздел Referential Integrity. 
Затем щелкнуть Ha кнопке Define, и перед вами откроется диалоговое окно, пред- 
ставленное на рис. 9.10. В его левой панели Fields вы можете выбрать поле или 
группу полей, связываемых с ключевыми полями головной таблицы, и кнопкой со 
стрелкой перенести их в список дочерних полей Child fields. Затем в правой панели 
Table вы можете указать головную панель (если ее там HET, значит вы неверно уста- 
новили рабочий каталог) и кнопкой со стрелкой перенести в список ключей роди- 
тельской таблицы Рагеп!5 key. Группа радиокнопок Update rule определяет, что бу- 
дет, если в головной таблице вы удалите или измените значение ключевого поля, с 
которым связаны какие-то записи во вспомогательной таблице. Если вы установи- 
ли опцию Prohibit, то Database Desktop просто не разрешит подобную операцию. 
Если же вы установили опцию Cascade, то при смене значения ключевого поля в 
головной таблице аналогичные изменения автоматически произойдут в записях 
дочерней таблицы. А если вы удалите запись в головной таблице, содержащую не- 
которое значение ключевого поля, то во вспомогательной таблице автоматически 
удалятся все записи, связанные с этим значением ключевого поля. 


Рис. 9.10. 

Окно установления 
целостности на уровне 
ссылок 


Установка индикатора Strict Referential Integrity в нижней части диалогового окна 
не позволит ранним версиям Paradox (в частности, версиям Paradox для DOS) от- 
крыть и испортить таблицы, в которых введена целостность на уровне ссылок. 

Когда вы провели все необходимые операции, щелкните на кнопке OK и B OT- 
крывшемся окне (рис. 9.11) введите имя созданной ссылки. 


Рис. 9.11. Save Referential Inte ity A 
Ввод имени созданной ссылки 


9.2.3.5 Password Security — пароли доступа 


Следующий раздел в выпадающем списке свойств таблицы в правом верхнем 
углу экрана на рис. 9.6: Password Security — пароли доступа. Paradox позволяет за- 
дать для таблицы пароли и для каждого из них определить разрешенные операции 
как для таблицы в целом, так и для отдельных ее полей. Щелчок на копке Define 
откроет вам окно, показанное на рис. 9.12. В нем вы можете ввести главный па- 
роль (окно Master password), подтвердить его (окно Verify master password), после чего 
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щелчком Ha копке Auxiliary Passwords (вспомогательные пароли) открыть новое диа- 
логовое окно (рис. 9.13), позволяющее ввести вспомогательные пароли и опреде- 
лить правила доступа по ним. 


mR Se — 
Ввод главного пароля 


Рис 9.13. | 
Ввод вспомогательного пароля 


В окне Current Password (текущий пароль) вы указываете пароль (он совершенно 
не обязательно должен совпадать с тем, под которым вы вошли в это окно), для кото- 
рого намереваетесь сформировать правила доступа. В группе радиокнопок Table Rights 
(права доступа к таблице) вы можете определить общий уровень доступа к таблице: 


All Допускаются любые операции, вплоть до изменения ее струк- 
туры, удаления таблицы, изменения и удаления паролей 


Insert & Delete Допускаются любые операции с записями (редактирование, 
вставка, удаление), но не разрешается изменение структуры 
таблицы и ее удаление 


Data Entry Допускается редактирование данных и вставка записей, HO 3a- 
прещено удаление записей и не разрешается изменение струк- 
туры таблицы и ее удаление 


Update Допускается только просмотр таблицы и изменение неключе- 
вых полей 


Read Only Допускается только просмотр таблицы 


В окне Field Rights (права доступа к полю) вы можете определить дополнитель- 
ные права доступа к каждому полю, но не превышающие заданный уровень досту- 
па к таблице: 
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И SIE LEREIILEE PERLE EE SAGEREE SELES PALER 


ыы 


All Дает в все > права доступа к полю, предусмотренные заданными 
правами доступа к таблице 

Read Only Позволяет только читать данные этого поля 

None He позволяет ни наблюдать, ни редактировать данное поле 


После того, как вы установили все права доступа для данного вспомогательно- 
го пароля, щелкните на кнопке Add и пароль занесется в окно списка паролей Pass- 
words. Далее кнопкой New вы можете начать задание нового вспомогательного па- 
poms. Кнопкой Change вы можете изменить выделенный в списке ранее введенный 
вспомогательный пароль или удалить его, щелкнув после кнопки Change на кноп- 
Ke Delete. 


9.2.3.6 Table Language — язык таблицы 


Этот раздел в выпадающем списке Table Properties позволяет задать (если он не 
задан) или переопределить (кнопкой Modify) язык таблицы, установленный по 
умолчанию в драйвере данной СУБД с помощью программы BDE Administrator 
(см. раздел 9.3.3). Правильный выбор языка определяет, будут ли нормально чи- 
таться в таблице русские тексты. 


9.2.3.7 Dependent Tables — зависимые таблицы 


Этот последний раздел в выпадающем списке Table Properties позволяет про- 
смотреть список зависимых таблиц, связанных с данной целостностью на уровне 
ссылок Referential Integrity. 


9.2.4 Завершение создания таблицы 


После того, как все необходимые данные о структуре таблицы внесены, щелк- 
ните на кнопке Save as (сохранить как) и перед вами откроется окно (рис. 9.14), на- 
поминающее обычный диалог сохранения в файле. От обычного это окно отличает- 
ся выпадающим списком Alias. Этот список содержит псевдонимы различных баз 
данных (0 них пойдет речь позднее), из которого вы можете выбрать базу данных, 
в которую будете сохранять свою таблицу. Если вам не надо сохранять таблицу в 
одной из существующих баз данных, то вы можете воспользоваться обычным спи- 
ском Сохранить в в верхней части окна. При этом вы с помощью обычной быстрой 
кнопки можете создать новую папку (каталог). Вспомните, что для Paradox база 
данных — это каталог, в котором сохраняется таблица. 


Рис. 9.14. бауе ТаЫе А 
Сохранение таблицы в базе данных 
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Внизу окна на рис. 9.14 имеются еще две опции. Первая из них — Display Table 
обеспечивает немедленное автоматическое открытие таблицы после ее сохранения. 
Вторая опция — Add Data to New Table доступна в случае, если производилось не 
создание таблицы, а изменение ее структуры. Эта опция обеспечивает, что в изме- 
ненную структуру из прежней таблицы перенесутся все данные, которые вписыва- 
ются в новую структуру. | 

Мы рассмотрели создание таблицы Paradox. Для других СУБД диалоги отли- 
чаются от рассмотренного и учитывают возможности различных СУБД. Однако 
эти отличия касаются только отдельных деталей и рассматривать их мы не будем. 


9.2.5 Изменение структуры и заполнение таблицы 
с помощью Database Desktop 


После того, как вы создали таблицу, вы можете ее открыть командой 
File | Open. Впрочем, если при сохранении структуры таблицы вы использовали 
описанную выше опцию Display Table, то таблица откроется автоматически. В обоих 
случаях вы увидите окно вида, представленного ранее на рис. 9.4. С помощью раз- 
делов меню Table вы можете смотреть содержимое таблицы (команда Table | View 
Data) или редактировать его (команда Table | Edit Data). Впрочем, вряд ли это целесо- 
образно делать. Программа Database Desktop не настраивается на русский язык, 
так что все, вводимое русскими буквами, выглядит абракадаброй. Впрочем, в 
дальнейшем при использовании такой таблицы в приложении все надписи будут 
выглядеть нормально. 

Команда Table | Info Structure позволяет просмотреть информацию о структуре 
таблицы, а команда Table | Restructure позволяет изменить структуру таблицы или 
какие-то ее характеристики. При выполнении этой команды вы попадаете в окно, 
аналогичное используемому ранее при разработке структуры. 


9.3 Создание и редактирование псевдонимов 
баз данных, каталогов, драйверов 


Имеется три альтернативных пути просмотра, создания и редактирования 
псевдонимов с помощью трех различных программ: Database Desktop, BDE 
Administrator и Database Explorer. Рассмотрим их все, наиболее подробно остано- 
вившись на Database Desktop. 


9.3.1 Автоматически создаваемые псевдонимы рабочего 
и частного каталогов 


Уже говорилось (см. раздел 9.1.1) о значении присваивания псевдонимов ба- 
зам данных и каталогам. Но прежде, чем говорить о создании новых псевдонимов, 
надо упомянуть о двух псевдонимах, автоматически создаваемых ВПЕ. Эти псевдо- 
нимы относятся к двум каталогам: рабочему (working) и частному (private). 

Рабочий каталог используется для совместной работы всех пользователей. 
Database Desktop создает его в момент установки в своем рабочем каталоге с путем 
..\Ргодгат Files\Borland\Database Desktop\WorkDir. Он имеет псевдоним WORK. Изме- 
нить рабочий каталог можно с помощью Database Desktop, выполнив команду 
File | Working Directory. Откроется окно, приведенное на рис. 9.15. В нем вы можете 
задать новый рабочий каталог (Working Directory), или найти его поиском по кнопке 
Browse, или выбором из выпадающего списка Aliases — псевдонимы. При смене ра- 
бочего каталога псевдоним WORK автоматически будет подразумевать этот новый 
каталог. Если вы — единственный или основной пользователь Database Desktop, то 
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полезно в качестве рабочего установить тот каталог, внутри которого или в подка- 
талогах которого сосредоточено большинство ваших баз данных. Это сократит вре- 
мя на открытие таблиц и другие операции, которые предлагают в качестве катало- 
га прежде всего псевдоним WORK. Кроме того, как будет сказано ниже, полезно из- 
менять рабочий каталог, чтобы иметь доступ к своим файлам конфигурации 
Database Desktop. | 


Рис o 15 Set Working Duec 
Установка псевдонима рабочего каталога 


Личный (private) каталог также создается автоматически при установке Data- 
base Desktop там же, где и рабочий каталог. Он служит для хранения личных таб- 
лиц и других объектов пользователя, не предназначенных для всеобщего обозре- 
ния. Он имеет псевдоним РКУ. Изменить частный каталог можно с помощью Data- 
base Desktop, выполнив команду File | Private Directory. Откроется окно, аналогичное 
приведенному Ha рис. 9.15. В Hem вы можете задать новый личный каталог. При 
этом псевдоним РКУ автоматически будет подразумевать этот новый каталог. 


9.3.2 Создание и просмотр псевдонимов баз данных 
в Database Desktop 


Теперь обсудим создание новых псевдонимов баз данных. Могут создаваться 
псевдонимы двух видов: открытые, доступные при работе из любого каталога, и 
псевдонимы проекта, доступные только при работе в конкретном рабочем каталоге. 
Открытые псевдонимы сохраняются в каталоге ...\Borland\Borland Shared\Bde в файле 
IDAPIL.CFG в C++Builder 5 или в файле IDAPI32.CFG в ранних версиях C++Builder. 
Они доступны из любого рабочего каталога. Псевдонимы проекта сохраняются в 
файле IDAPI.CFG в рабочем каталоге и доступны только из этого каталога. Так что вы 
можете в разных каталогах разместить файлы конфигурации с разными псевдони- 
мами проекта и в зависимости от того, какой каталог вы назначите рабочим, будете 
иметь разные наборы псевдонимов. 

Псевдонимы можно просматривать и создавать в Database Desktop, выполнив 
команду Tools | Alias Manager. Вы увидите диалоговое окно Alias Manager (диспетчера 
псевдонимов), вид которого представлен на рис. 9.16. Впрочем, вид этого окна су- 
щественно зависит от того, псевдоним какой базы данных просматривается. Инди- 
катор Public alias (открытый псевдоним) в верхней части окна показывает, будет ли 
создаваться открытый псевдоним, или псевдоним проекта. Ниже расположен вы- 
падающий список Database Alias, в котором вы можете выбрать интересующий вас 
псевдоним из числа уже созданных. То, какие именно псевдонимы в нем видны, 
определяется группой радиокнопок справа. Если выбрана кнопка Show Public Aliases 
Опу, то в списке отображаются только открытые псевдонимы; если выбрана кноп- 
ка Show Project Aliases Only, то отображаются только псевдонимы проекта; при вы- 
бранной кнопке Show А! Aliases отображаются псевдонимы обоих типов. 

При выборе псевдонима в списке Database Alias автоматически изменяется тип 
драйвера в выпадающем списке Driver type и расположенная ниже информация о 
драйвере. На рис. 9.16 изображен случай базы данных INTERBASE с драйвером 
INTRBASE (аналогично выглядит экран и для любого драйвера SQL Link — ORACLE, 
SYBASE). В информации указывается: 
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Рис 9 16 Alias Manager 
Просмотр псевдонимов баз данных 


SERVER NAME | Задается путь и файл базы данных или имя сервера. 
имя сервера 

USER МАМЕ Задается имя пользователя 

имя пользователя 

OPEN MODE Возможные значения: READ/WRITE (для чтения и записи) 
режим открытия или READ ONLY (только для чтения) 

SCHEMA CACHE SIZE Определяет число кэшируемых схем информации. По 
размер кэша схем умолчанию — 5, может выбираться от 0 до 32 
LANGDRIVER Определяет множество отображаемых символов 

драйвер языка 

SQLQRYMODE Может принимать значения: NULL (по умолчанию) — об- 
режим обработки за- ращение сначала к серверу, а если он не может обрабо- 
просов SQL тать запрос, то к Desktop, SERVER — только к серверу и, 


если он не может обработать запрос, то отказ, LOCAL — 
только к Desktop 


SQLPASSTHRU MODE Определяет, может ли пользователь Database Desktop иметь 

доступ к QBE и БОГ доступ к QBE и SQL редакторам в пределах одного соедине- 
ния. Возможные значения: МОТ SHARED — не может, 
SHARED AUTOCOMMIT (по умолчанию) может и результаты 
запроса SQL автоматически фиксируются в базе данных, ‹ 
SHARED МО AUTOCOMMIT — может, но результаты запроса 
SQL автоматически не фиксируются в базе данных 


Password Пароль может задаваться, а может и не задаваться 
пароль 


Кнопка Соппес! (соединение) позволяет немедленно соединиться с базой дан- 
ных. Кнопка Remove (удаление) позволяет удалить псевдоним. Кнопка Save as позво- 
ляет сохранить список псевдонимов (если он изменялся) в файлах конфигурации за- 
данного каталога. А кнопка New (новый) позволяет создать новый псевдоним. 

При щелчке на этой кнопке диалоговое окно несколько преобразуется 
(рис. 9.17). Правда, различие рис. 9.16 и рис. 9.17 объясняется не только этим, но 
и выбором в этих двух примерах разных драйверов. Основное же отличие — изме- 
нение кнопок (в частности, New меняется на Keep New — сохранить новый псевдо- 
ним) и возможность в списке Database Alias не только выбирать существующий 
псевдоним, но и писать новый. 


/ 
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Рис. 9.17. 


Задание нового псевдонима базы данных 


|| С Show proigct aliases only 
| @ Show atataves 


В открывшемся окне надо: 


Ш Установить или убрать опцию Public alias для создаваемого псевдонима (ее 
смысл рассматривался выше). 


Ш Выбрать драйвер базы данных в списке Driver type и заполнить его характери- 
стику. Для баз данных Paradox, dBase и ряда других надо выбрать тип драйве- 
pa STANDARD, в котором достаточно указать каталог хранения таблиц. В этом 
может помочь кнопка просмотра Browse. Для З@Г-драйверов заполняемые по- 
зиции были рассмотрены выше. В ряде случаев проще выбрать сначала в окне 
Database Alias какой-то из имеющихся псевдонимов, с драйвером и характери- 
стиками, подобными нужным для нового псевдонима, а затем отредактиро- 
вать эти характеристики. 


Ш В окне Database Alias написать новый псевдоним. 


Ш Шелкнуть на кнопке Keep New, чтобы сохранить введенную информацию и пе- 
рейти к созданию следующего псевдонима, или сохранить всю информацию 
кнопкой Save as и выйти из диалога. 


9.3.3 Создание и просмотр псевдонимов драйверов 
и баз данных в BDE Administrator 


Программа BDE Administrator (Администратор BDE) позволяет просматри- 
вать, редактировать и создавать новые драйверы ВПЕ баз данных различных ти- 
пов: стандартные (STANDARD), SQL, Access, ODBC. При установке BDE на компь- 
ютер программа BDE Administrator включается в состав программы «Панель 
управления» Windows. Вы можете также включить ее в меню C++Builder с помо- 
щью команды Tools | Configure Tools. Файл программы — ...\Program Files\Bor- 
land\Borland Shared\BDE\bdeadmin.exe. 

Окно программы (рис. 9.18) имеет две страницы: Databases — базы данных и 
Configuration — конфигурация. На странице в левой панели расположено дерево 
псевдонимов баз данных. Выделив интересующий вас псевдоним в левой панели, 
вы можете в правой панели Definition увидеть все его характеристики. Число и 
смысл этих характеристик зависит от используемого драйвера. 

Для драйвера STANDARD, используемого, в частности, для баз данных 
Paradox, набор характеристик псевдонима минимальный: Туре — имя драйвера и 
РАТН — путь к базе данных. Щелкнув на параметре РАТН, вы увидите кнопку с 
многоточием (рис. 9.18). При ее нажатии отобразится обычный диалог Windows, 
позволяющий выбрать новый каталог. Таким образом вы можете изменить харак- 
теристики псевдонима, если, например, изменилось расположение базы данных на 
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Рис. 9.18. 
Страница Databases Администратора BDE 


‘Datateete aw Type STANDARD 


#-25 BCDEMOS 41] PATH D:\DataBase\dbPar =] 
#88 Currency =. | 
| "5 dbA 

‘B dBASE Files 


диске. После этого все приложения, использующие этот псевдоним, автоматиче- 
ски будут работать с данными, даже не заметив изменения их месторасположения. 

Характеристики драйверов баз данных INTERBASE и драйверов SQL Link 
(ORACLE, SYBASE и др.) были рассмотрены выше. 

Имейте в виду, что в правой панели можно изменять только те параметры, 
имена которых не выделены жирным шрифтом. Значения выделенных параметров 
изменять нельзя. 

Для создания нового псевдонима надо щелкнуть правой кнопкой мыши и во 
всплывшем меню выбрать раздел New — новый псевдоним. Перед вами появится 
небольшое диалоговое окно, показанное на рис. 9.19. В его выпадающем списке вы 
должны выбрать драйвер для создаваемого псевдонима. Тип драйвера STANDARD 
можно использовать для таблиц Paradox, dBASE, FoxPro, для текстов ASCII. 


Рис. 9.19. 
Диалоговое окно выбора драйвера для 
нового псевдонима 


Выбрав драйвер, щелкните на ОК и в дереве псевдонимов появится новая вер- 
шина, для которой вы можете задать имя — псевдоним. 

В правой панели появятся параметры, которые вы должны установить для 
создаваемого псевдонима. Для типа STANDARD эти параметры следующие: 


И ОЕ 


РАТН _— Путь к базе данных 
DEFAULT Один из следующих драйверов: PARADOX для таблиц Paradox 


DRIVER (файлов .db), DBASE для таблиц dBASE (файлов .dbf), FOXPRO 
) для таблиц FoxPro (файлов .dbf), ASCIIDRV для текстов ASCII 
(файлов .txt) 


ENABLE BCD Определяет, должна ли BDE транслировать числовые поля в 
значения с плавающей запятой, или в коды BCD. BCD позволя- 
ет избежать ошибок округления. Если ENABLE BCD = true, то 
поля DECIMAL и NUMERIC преобразуются в коды BCD 


После задания параметров щелкните правой кнопкой мыши и из всплывшего 
меню выберите раздел Арру. Новый псевдоним будет зафиксирован. 

Для удаления существующего псевдонима выделите его в левой панели, щелк- 
ните правой кнопкой мыши и из всплывшего меню выберите раздел Delete. 
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Мы рассмотрели страницу Databases окна Администратора BDE. Страница Con- 
figuration (конфигурация) позволяет изменить какие-то из параметров выбранного 
драйвера и установить системные параметры, определяющие, как преобразовыва- 
ются строки с обозначением дат, времени и чисел в соответствующие значения. 


| 9.3.4 Создание и.просмотр псевдонимов в SQL Explorer’ 


Вызов этой программы осуществляется из главного меню C++Builder коман- 
дой Database | Explore. Окно программы SQL Explorer представлено на рис. 9.20. В 
его левой панели на странице Databases вы можете видеть дерево зарегистрирован- 
ных псевдонимов. Выделив интересующий вас псевдоним (на рис. 9.20 это псевдо- 
ним dbP), вы увидите на правой панели его параметры. При желании вы можете 
их изменить. 


Рис. 9.20. 
Окно программы SQL Explorer — 
просмотр параметров псевдонима 


1-26 BCDEMOS РАТН_ | 


(4-3 Currency 
iG dbA 
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#28 DBDEMOS 
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Выделив корневой узел в левой панели, вы можете с помощью команды 
Object | New создать новый псевдоним. При этом вначале вам будет показано окно 
выбора драйвера, приведенное ранее на рис. 9.19 при рассмотрении работы с Ад- 
министратором BDE. Все дальнейшие действия не отличаются от тех, которые не- 
обходимы при создании псевдонима с помощью Администратора ВПЕ. Так что по- 
смотрите раздел 9.3.3, в котором вся эта процедура описана достаточно подробно. 

Однако возможности SQL Explorer по просмотру и модификации баз данных 
не ограничиваются модификацией существующих и созданием новых псевдони- 
мов. Вы можете выбрать в левой панели интересующий вас псевдоним базы дан- 
ных, и просмотреть, что хранится в этой базе данных (таблицы, индексы и т.п.), 
просмотреть таблицы (этот момент отображен на рис. 9.21). При этом в правой па- 
нели на странице Definition вы можете просмотреть‘ общую информацию о таблице, 


Рис. 9.21. 

Окно программы SQL 
Explorer — просмотр 
данных в таблице Pers 
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на странице Тех! вы можете увидеть текст запроса SQL, создавшего данную таблицу 
(если использовался драйвер SQL). На странице Data вы можете просмотреть хра- 
нящуюся в таблице информацию. При этом кнопки навигатора вверху диалогового 
окна позволяют вам редактировать записи, вставлять новые записи и т.п. На стра- 
нице Enter SQL можете сформировать и выполнить запрое к таблице. 

Вы можете продвинуться далее и раскрыть структуру таблицы. На рис. 9.22 
изображен просмотр объявления столбца Dep таблицы Pers, причем вы можете из- 
менить соответствующую информацию. 


Рис. 9.22. 
Окно программы SQL Explorer — 
просмотр объявления поля Dep 


у 24 ФР 
| & @ Tables 
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Программа SQL Explorer имеет еще много возможностей, которые будут pac- 
смотрены в дальнейшем. А завершая эту главу, хотелось бы, чтобы вы создали с 
помощью одного из рассмотренных инструментов базу данных с псевдонимом @ЪР, 
содержащую две таблицы Pers и Dep, описанные в разделе 9.1 в таблицах 9.1 и 9.2. 
Это необходимо для работы с примерами приложений, которые мы будем рассмат- 
ривать в последующих разделах. 


9.4 Обзор компонентов, используемых для связи 
с базами данных 


Компоненты, используемые для работы с базами данных, расположены в биб- 
лиотеке компонентов на страницах Data Access (доступ к данным) и Data Control 
(управление данными). 

Каждое приложение, использующее базы данных, обычно имеет по крайней 
мере по одному компоненту следующих трех типов: 


Ш Компоненты — наборы данных (data set), непосредственно связывающиеся с 
базой данных. Это такие компоненты, как Table, Query, StoredProc. 


Ш Компонент — источник данных (data source), осуществляющий обмен инфор- 
мацией между компонентами первого типа и компонентами визуализации и 
управления данными. Таким компонентом является DataSource. 


Ш Компоненты визуализации и управления данными, такие, как DBGrid, 
DBText, DBEdit и множество других. 


Связь этих компонентов друг с другом и с базой данных можно представить 
схемой, приведенной на рис. 9.23. 

Помимо указанных компонентов в приложении может размещаться компо- 
нент Database. Этот компонент в основном используется в приложениях, работаю- 
щих на платформе клиент/сервер. Он обеспечивает общение с удаленным серве- 
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визуализация 
таблица data set: и управление: 


базы Table, Query data source: DBGrid, 


DataSource DBText, 
DBNavigator ... 


данных или StoredProc 


Рис. 9.23. 


Схема взаимодействия компонентов C++Builder с базой данных 


ром, реализацию транзакций, работу с паролями. Компонент Database целесооб- 
разно вводить в приложение только в сравнительно редких случаях. Если он не 
введен явно, C++Builder автоматически создает его для каждой используемой в 
приложении базы данных. Подробнее этот компонент будет рассмотрен в разде- 
ле 10.2.2 главы 10. 

Еще один компонент, который тоже автоматически создается C++Builder — 
компонент Session. Это главный компонент любого приложения, работающего с 
базами данных. Но в явном виде эти компоненты имеет смысл вводить только в 
многозадачные приложения, в которых параллельно обрабатывается несколько 
потоков информации. Компонент Session будет рассмотрен в разделе 9.8. 


9.5 Основные свойства компонента Table 
и простейшие приложения на его основе 


9.5.1 Установка связей между компонентами и базой данных, 
навигация по таблице 


Давайте построим простейшее приложение, работающее с базой данных. Бу- 
дем использовать ту таблицу Paradox Pers, которую вы создавали ранее в базе дан- 
ных с псевдонимом dbP. Она имеется на прилагаемом к книге диске. 

В нашем простейшем приложении мы будем в качестве набора данных исполь- 
зовать компонент Table. Откройте новое приложение и перенесите на форму компо- 
нент Table со страницы библиотеки Data Access. Перенесите также на форму с той же 
страницы библиотеки компонент DataSource, который будет являться источником 
данных. Оба эти компонента невизуальные, пользователю они будут не видны, так 
что их можно разместить в любом месте формы. В качестве компонента визуализа- 
ции данных возьмите компонент DBGrid со страницы Data Control. Это визуальный 
компонент, в котором будут отображаться данные таблицы. Поэтому растяните его 
пошире, или можете в его свойстве Align установить alClient (рис. 9.24). 

Теперь нам надо установить цепочку связей между этими компонентами, по- 
казанную выше на рис. 9.23. Главное свойство DBGrid и других компонентов ви- 
зуализации и управления данными — DataSource. Выделите на форме компонент 
ОВСг!а1 и щелкните на его свойстве DataSource в Инспекторе Объектов. Вы уви- 
дите выпадающий список, в котором перечислены все имеющиеся на форме источ- 


Рис. 9.24. 
Форма простого приложения, работающего с 
базой данных 
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ники данных. В нашем случае имеется только один источник данных — 
DataSourcel. Установите его в качестве значения свойства DataSource. Далее 
надо установить связь между источником данных и набором данных. Выделите 
компонент DataSourcel и найдите в Инспекторе Объектов его главное свойство — 
DataSet. Щелкните на этом свойстве и из выпадающего списка выберите Tablel 
(если бы у вас было несколько компонентов — наборов данных, то все они были бы 
в этом списке). 

Теперь осталось связать компонент Та е1 с необходимой таблицей базы дан- 
ных. Для этого служат два свойства компонента Table: DatabaseName и Table- 
Name. Прежде всего надо установить свойство DatabaseName. В выпадающем спи- 
ске этого свойства в Инспекторе Объектов вы можете видеть все доступные BDE 
псевдонимы баз данных. Выберите из этого списка псевдоним ЧЪР, который вы 
сами ввели ранее. Если этого псевдонима там нет, значит вы забыли его создать. В 
этом случае создайте его с помощью, например, Database Desktop, как описано в 
разделе 9.3.2. 

После этого можно устанавливать значение свойства TableName. В выпадаю- 
щем списке этого свойства перечислены таблицы, доступные в данной базе дан- 
ных. Выберите таблицу Pers. 

А теперь наступает самый ответственный момент. Вы можете прямо в процес- 
се проектирования соединиться с базой данных. Соединение осуществляется свой- 
ством Active. По умолчанию оно равно false. Установите его в true. Если все сдела- 
но вами правильно, то вы увидите в поле компонента ОВСт1А1 данные из таблицы 
(рис. 9.25) и сможете просмотреть их. 


Рис. 9.25. 
Форма простого. приложения после соединения 
компонента ТаЫе с базой данных 
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Следует сразу отметить, что заранее выставлять для таблиц Active = true до- 
пустимо только в процессе настройки и отладки приложения, работающего с ло- 
кальными базами данных. 
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В законченном приложении во всех таблицах сначала должно быть установлено Active = fal- 
se, затем при событии формы OnCreate эти свойства могут быть установлены в true, а при 
событии формы OnDestroy эти свойства опять должны быть установлены в false. Это исклю- 
чит неоправданное поддержание связи с базой данных, которое занимает ресурсы, а при 
работе в сети мешает посту к базе данных Бдрутих пользователей. 
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Вы можете прямо semen. хотя приложение еще не закончено, сохранить про- 
ект, запустить его на выполнение и убедиться, что с ним можно работать. Вы мо- 
жете просматривать данные, редактировать их (редактированные данные будут 
помещаться в базу данных в момент перехода от редактируемой записи к любой 
другой). Вы можете также убедиться, что в таблице Pers базы данных dbP невоз- 
можно изменить поле Num, поскольку оно автоматически изменяется и доступно 
только для чтения (см. раздел 9.2.2). Вы увидите также, что нельзя задать произ- 
вольное имя подразделения Dep, поскольку имеется таблица просмотра Dep, зада- 
на целостность на уровне ссылок и допустимы только те значения Dep, которые 
имеются в головной таблице Dep (см. разделы 9.2.3.2 и 9.2.3.4). 
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При попытке делать подобные неразрешенные исправления соответствующие 
сообщения об ошибках будут появляться не в момент редактирования, а после ре- 
дактирования при попытке перейти к следующей записи, поскольку именно в этот 
момент отредактированная запись должна заноситься в таблицу. Правда, если вы 
хотите проверять все эти возможности, то надо бы отключить остановы при генера- 
ции исключений. Для этого надо выполнить команду Tools | Debugger Options, в от- 
крывшемся диалоговом окне выбрать страницу Language Exceptions и выключить 
опции Stop on Delphi Exceptions и Stop Оп C++ Exceptions (см. раздел 14.2.8). 

Разрешить пользователю так просто, как в созданном вами приложении, pe- 
дактировать данные в таблице в большинстве случаев недопустимо. Слишком ве- 
лика вероятность, что без соответствующей проверки вводимых данных будут сде- 
ланы ошибки. Предотвратить редактирование данных вы можете, установив свой- 
ство ReadOnly компонента DBGrid1 в true. Другой способ сделать то же самое — 
установить в свойстве Options подсвойство dgEditing в false. Попробуйте оба вари- 
анта и вы увидите некоторое различие между ними во время выполнения. В свой- 
стве Options есть еще много полезных подсвойств. Посмотрите сведения о них BO 
встроенной справке C++Builder. 

Отметим еще одно свойство компонента Table — Exclusive. Это свойство опре- 
‘деляет доступ к используемой таблице при одновременном обращении к ней не- 
скольких приложений (например, при работе в сети или в многозадачном режи- 
ме). Если задать значение этого свойства true, то таблица будет закрыта для дру- 
гих приложений. Свойство можно изменять только при Active = false. 

В спроектированное вами простейшее приложение можно добавить еще один 
компонент, управляющий работой с таблицей — навигатор DBNavigator, располо- 
женный на странице Data Control библиотеки компонентов. Измените свойство 
Align компонента DBGrid1 на alBottom, сдвиньте верхний край этого компонента 
немного вниз и на верх формы поместите компонент DBNavigator (см. рис. 9.26). 


Рис. 9.26. 
Форма простого приложения с навигатором 
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Компонент имеет ряд кнопок, служащих для управления данными. Перечис- 
лим их названия и назначение, начиная с левой кнопки: 


nbFirst | перемещение первой записи. ви 
nbPrior перемещение к предыдущей записи 
nbNext перемещение к следующей записи 

nbLast перемещение к последней записи 


nbInsert — вставить новую запись перед текущей 
nbDelete — удалить текущую запись 


nbEdit редактировать текущую запись 
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nbPost послать отредактированную информацию в базу данных 
nbCancel отменить результаты редактирования или добавления новой записи 


nbRefresh очистить буфер, связанный с набором данных 


Пользуясь свойством навигатора VisibleButtons, можно убрать любые ненуж- 
ные в данном приложении кнопки. Например, если вы не хотите разрешить поль- 
зователю вводить в базу данных новые записи, то можете установить в false кноп- 
ку nbInsert. Если вы хотите вообще запретить редактирование, то можно оставить 
только кнопки nbFirst, nbPrior, nbNext и nbLast, а все остальные убрать. 

Чтобы приложение с навигатором работало, надо установить основное свойст- 
во навигатора — DataSource — источник данных (имя компонента DataSource). 

Откомпилируйте приложение, выполните его и посмотрите в работе. 


9.5.2 Свойства полей 


Наше приложение выглядит, конечно, очень плохо. Во-первых, последова- 
тельность записей определяется ключевым полем Ми, а хотелось бы, чтобы запи- 
си были расположены по алфавиту или по отделам и алфавиту. Первое поле с но- 
мерами записей вообще пользователю не нужно и надо бы, чтобы его не было вид- 
но. Шапка таблицы содержит непонятные пользователю имена полей Num, Fam и 
т.д., а надо, чтобы были написаны нормальные заголовки по-русски. В графе Sex 
значения true и false, а нужны нормальные обозначения типа «м», «2K» или ‹«муж- 
ской», «женский». 

Все это можно легко поправить. Начнем с упорядочивания записей. Выделите 
на форме компонент Та Ше1. В Инспекторе Объектов вы увидите среди прочих 
свойства IndexName и IndexFieldName. Первое из них содержит выпадающий 
список индексов, созданных для вашей таблицы. Выберите, например, индекс fio, 
и увидите, что записи окажутся упорядоченными по алфавиту, поскольку в этот 
индекс включены поля Fam, Nam и Par. При индексе depfio упорядочивание бу- 
дет по подразделениям, а внутри каждого подразделения — по алфавиту. Альтер- 
нативный вариант индексации предоставляет свойство IndexFieldName. В нем 
просто перечислены предусмотренные комбинации полей и вы можете выбрать не- 
обходимую, если забыли, что обозначают имена индексов. 

Теперь займемся отдельными полями. Для их редактирования служит Редак- 
тор Полей. Вызвать его проще всего двойным щелчком на компоненте Tablel. Сна- 
чала вы увидите пустое поле этого редактора (рис. 9.27 а). Щелкните на нем пра- 
вой кнопкой мыши и из всплывающего меню выберите раздел Add fields (добавить 
поля). Вы увидите окно, изображенное на рис. 9.27 6, в котором содержится спи- 
сок всех полей таблицы. Выберите из него курсором мыши интересующие вас 
поля. Если вы при этом будете держать нажатой клавишу Ctrl, то может выделить 


Редактор Полей: =" : 

исходное состояние 
(a), окно выбора 
полей (6), состояние 
после выбора (в) 
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любую комбинацию полей. Однако, имейте в виду, что только к тем полям, кото- 
рые вы добавите, вы сможете в дальнейшем обращаться. Так что в данном случае 
вам имеет смысл выделить все поля, кроме Charact, Photo и, может быть, Num. 
Выделив поля, щелкните на ОК и вы вернетесь к основному окну Редактора По- 
лей, но в нем уже будет содержаться список добавленных полей (рис. 9.27.в). 

Эти поля будут соответствовать колонкам таблицы. Изменить последователь- 
ность их расположения можно, перетащив мышью идентификатор какого-то поля 
на нужное место. Как мы увидим далее, те поля, которые не должны отображаться 
в таблице, могут быть сделаны невидимыми. 

Выделите в списке какое-то поле и посмотрите его свойства в Инспекторе Объ- 
ектов. Вы увидите, что каждое поле — это объект, причем его класс зависит от 
типа поля: TStringField, TSmallintField, TBooleanField и т.п. Все эти классы яв- 
ляются производными OT Tfield — базового класса полей. Таким образом, каждое 
поле является объектом и обладает множеством свойств. Рассмотрим основные из 
них, которые чаще всего необходимо задавать. 

Свойство Alignment определяет выравнивание отображаемого текста внутри 
колонки таблицы: влево, вправо или по центру. 

Свойство DisplayLabel соответствует заголовку столбца данного поля. Напри- 
мер, для поля Fam значение DisplayLabel можно задать равным «Фамилия», для 
Маш — «Имя» ит.д. 

Свойство Display Width определяет ширину колонки — число символов. 

Свойства EditMask для строк и EditFormat для чисел определяют форматы 
отображения данных. 

Для логических полей (в нашем примере. для поля Sex) очень важным свойст- 
вом является DisplayValues. Это свойство определяет, какие значения должны 
отображаться, если поле имеет значение true или false. Отображаемые значения 
разделяются точкой с запятой. Первым пишется значение, соответствующее true. 
Например: «м;ж» или «мужской; женский». 

Свойство ReadOnly, установленное в true, запрещает пользователю вводить в 
данное поле значения. Свойство Visible определяет, будет ли видно пользователю 
соответствующее поле. В нашем примере, вероятно, можно задать Visible = false 
для поля Num, если вы его не исключили из списка полей Tablel. 

После установки всех необходимых свойств приложение уже приобретает при- 
емлемый вид (рис. 9.28). 


Рис. 9.28. 

Приложение с установленными свойствами 
полей и удаленными кнопками 
редактирования в навигаторе 


Отметим еще одну особенность Редактора Полей — возможность перетаски- 
вать из него поля на форму с помощью мыши. Захватите в Редакторе Полей ка- 
кое-нибудь поле, например, Fam, и перетащите его на форму. На форме. появится 
связанный с этим полем компонент типа TDBEdit и метка, содержащая его свойст- 
во DisplayLabel. При переносе на форму булева поля Sex на ней появится связан- 
ный с этим полем индикатор — компонент типа TDBCheckBox. При перетаскива- 
нии полей Charact и Photo появятся соответственно связанные с этими полями 
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компоненты типов TDBMemo и TDBImage. И во всех этих компонентах, если вы 
переключите свойство Active компонента TTable в true, сразу отобразятся соответ- 
ствующие данные из таблицы. 


9.5.3 Ограничения вводимых значений 


Ранее мы обсуждали вопрос об ограничении диапазона возможных значений 
полей при создании таблиц. Однако, C++Builder предусматривает еще разнообраз- 
ные возможности дополнительного ограничения значений в приложении. Дело в 
том, что в таблице устанавливаются обычно достаточно широкие пределы, пригод- 
ные для любых ее применений. А в конкретном приложении могут потребоваться 
более узкие пределы. | 

Несколько возможностей ограничения предоставляют свойства полей, кото- 
рые вы можете увидеть, сделав двойной щелчок на компоненте Table и выделив в 
окне Редактора Полей требуемое поле. Для числовых полей имеются свойства 
MinValue и MaxValue, устанавливающие допустимые пределы вводимых в поле 
значений. Например, если вам требуется принимать на работу сотрудником только 
в узком возрастном диапазоне, вы можете для поля Year_b установить ограниче- 
ния MinValue = 1970 и MaxValue = 1980. Эти ограничения не скажутся на отобра- 
жаемых данных. Но при нарушении этих пределов в процессе редактирования за- 
писи или в новой записи будет генерироваться исключение. В результате пользова- 
тель увидит сообщение вида, приведенного на рис. 9.29. Вряд ли подобное сообще- 
ние на английском языке порадует пользователя. Поэтому лучше перехватить ис- 
ключение на уровне приложения (см. раздел 12.10.5.2 главы 12) и выдать пользо- 
вателю понятное пояснение по-русски. 


Рис. 9.29. 

Сообщение о выходе значения поля за 
допустимые пределы при использовании 
свойств MinValue и MaxValue 


Другая возможность ограничения — использование свойств CustomConstraint 
и ConstraintErrorMessage. Свойство CustomConstraint позволяет написать огра- 
ничение на значение поля в виде строки SQL (см. раздел 10.1). Например, для того 
же поля Year_b вы можете написать в свойстве CustomConstraint: 


Х < 1980 and X > 1970 


Имя поля (в данном выражении оно обозначено как X) может быть произволь- 
ным. 

Если вы задали свойство CustomConstraint, то необходимо задать и свойство 
ConstraintErrorMessage. Оно содержит строку. текста, который будет показан 
пользователю в случае, если он вводит данные, не удовлетворяющие поставлен- 
ным ограничениям. Например, «Возраст претендента на должность не подходит» 
(см. рис 9.30, на котором показано окно с этим сообщением). Таким образом, этот 
вариант обычно много удобнее задания MinValue и MaxValue, поскольку не требу- 
ет перехвата исключений. K тому же он может применяться не только к числовым 
полям. 


Рис. 9.30. 

Сообщение о выходе значения поля за допустимые 
пределы при использовании свойств 
CustomConstraint и ConstraintErrorMessage 
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Еще одна возможность проверять данные на уровне поля — использовать обра- 
ботку события поля OnValidate. Это событие возникает перед записью введенного 
значения поля в буфер текущей записи. Тут можно предусмотреть любые провер- 
ки, при появлении недопустимых данных выдать пользователю сообщение и, на- 
пример, сгенерировать исключение EAbort функцией Abort. Если все нормально, 
то после события OnValidate возникает еще событие OnChange, в обработчике ко- 
торого тоже еще не поздно сгенерировать исключение. 

Описанные выше способы проверки данных относятся к конкретному полю. 
Имеется также возможность осуществлять проверку на уровне записи, анализируя 
различные ee поля. Для этого служит свойство Constraints компонента Table. На- 
жмите кнопку в этом свойстве, и перед вами откроется окно, представленное на 
рис. 9.31. Щелкая в нем на кнопке Add New (крайняя левая) вы можете занести в 
свойство Constraints набор ограничений. Каждое из них представляет собой само- 
стоятельный объект. Выделив одно из ограничений, вы увидите в Инспекторе Объ- 
ектов его свойства. Свойство CustomConstraint представляет собой строку SQL, оп- 
ределяющую допустимые значения. Свойство ErrorMessage определяет строку 
текста, которая будет предъявлена пользователю в случае нарушения ограниче- 
ний. Например, вы можете написать в свойстве CustomConstraint : 


((Sex=true) and (Year р >1955))or 
((Sex=false) and (Year b>1965)) 


а в свойстве ErrorMessage: «Принимаем только мужчин >1955 г.р. и женщин >1965 
г.р.» Это обеспечит вам различные границы отбора по возрасту для мужчин и жен- 
UHH. 


Puc. 9.31 5 < Editing Tablel->Constraints 
Окно редактирования ограничений для записи 


Sex=true| and [Уеаг Б >1955)}jol[Sex=false] and [Уез! _b>1 


Для комплексной проверки данных можно также использовать различные со- 
бытия компонента Table, но на этом мы остановимся в последующих разделах при 
рассмотрении методов программирования работы с данными. 


9.5.4 Вычисляемые поля 


Теперь попробуем сформировать в таблице новое поле, не предусмотренное 
при ее создании, значение которого вычисляется на основании значений других 
полей записи. Подобные поля называются вычисляемыми полями (calculated 
fields). Пусть в нашем примере мы хотим добавить поле, вычисляющее возраст со- 
трудника по его году рождения. Сделайте двойной щелчок на Tablel, чтобы вы- 
звать Редактор Полей. Щелкните в Редакторе Полей правой кнопкой мыши и во 
всплывшем меню выберите раздел New field (новое поле). Появится окно добавле- 
ния нового поля, приведенное на рис. 9.32. 

В разделе Field properties (свойства поля) вы должны указать имя поля 
(Мате) — в нашем случае назовем это поле Age, тип данных (Type) — в нашем слу- 
чае это Smallint, и для некоторых типов — размер (Size). Размер указывается для 
строк и других полей неопределенных размеров. 

После ввода всех данных проверьте, переключилась ли группа радиокнопок 
Field type на Calculated (это переключение делается автоматически). Затем щелкните 
на ОК и вы вернетесь в окно Редактора Полей, причем там появится новое поле Age. 
Задайте для него в Инспекторе Объектов значение DisplayLabel равным «Возраст». 
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Рис. 9.32. 
Ввод информации о вычисляемом поле 


Вы ввели вычисляемое поле Age, но еще не указали программе, как его надо 
вычислять. Чтобы указать процедуру вычислений, выйдите из Редактора Полей, 
выделите Tablel, перейдите в Инспекторе Объектов на страницу событий и щелк- 
ните на событии OnCalcFields. Это событие наступает каждый раз, как надо обно- 
вить значение вычисляемых полей таблицы. 

Чтобы вычислить возраст по году рождения, вы можете в обработчике этого 
события написать оператор: 


TablelAge->Value = 2000 - TablelYear b->Value; 


В этом операторе TablelAge->Value и TablelYear_b->Value — значения по- 
лей Age и Уеаг_Ъ соответственно. Правда, этот оператор рассчитан только на рабо- 
ту в 2000 году, и в дальнейшем его придется ежегодно менять. Можно, добавив в 
обработчик пару строк, сделать расчет возраста универсальным. Это делает сле- 
дующий обработчик: 


void _fastcall TForml::TablelCalcFields(TDataSet *DataSet) 


{ 

unsigned short Year, Month, Day; 

Date () .DecodeDate (&Year, &Month, &Day) ; 
TablelAge->Value = Year - TablelYear b->Value; 


} 

В этом коде введены переменные Year, Month и Day для хранения текущего 
года, месяца и дня. Использована функция Date (см. раздел 15.3.2 в главе 15), воз- 
вращающая текущую дату типа TDateTime (этот тип используется в C++Builder 
для хранения дат и времени). И использована функция DecodeDate для преобразо- 
вания этой даты в целые значения года, месяца и дня. В результате переменная 
Year становится равной текущему году (переменные Month и Day нам не нужны и 
определены только для того, чтобы можно было обратиться к функции 
DecodeDate). 

Запустите приложение и посмотрите, как оно теперь выглядит (рис. 9.33). 


Рис. 9.33. 
Приложение с введенном вычисляемым 
полем Возраст 
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9.5.5 Фильтрация данных. 


Компонент Table позволяет не только отображать, редактировать и упорядо- 
чивать данные, но и отфильтровывать записи по определенным критериям. Поль- 
зователю в нашем примере могло бы захотеться иметь возможность просматривать 
не всю базу данных, а отдельно записи по тому или иному отделу, или, например, 
просмотреть записи сотрудников, имеющих возраст в определенном диапазоне. 

Фильтрация может задаваться свойствами Filter, Filtered и FilterOptions 
компонента Table. Свойство Filtered включает или выключает использование 
фильтра. А сам фильтр записывается в свойство Filter в виде строки, содержащей 
определенные ограничения на значения полей. Например, вы можете задать в 
свойстве Filter 


Рер='Цех 1' 


установить свойство Filtered в true, и увидите, что уже в процессе проектирования 
в таблице отобразятся только те записи, в которых поле Dep имеет значение «Цех 
1». Обратите внимание на то, что в условии фильтрации строки заключаются в 
одинарные, а не в двойные кавычки. 

В условиях сравнения строк можно использовать символ звездочки «*», кото- 
рый, как в обычных шаблонах, означает: «любое количество любых символов». 
Например, фильтр 


Рер='Цех* ' 


приведет к отображению всех записей, в которых значение поля Dep начинается с 
«Цех». В нашем примере будут отображены записи, относящиеся к первому и вто- 
рому цехам. Но для того, чтобы это сработало, надо, чтобы в опциях, содержащих- 
ся в свойстве FilterOptions была выключена опция foNoPartialCompare, запреща- 
ющая частичное совпадение при сравнении (эта опция выключена по умолчанию). 
Другая опция в свойстве FilterOptions — foCaseInsensitive делает сравнение строк 
нечувствительным к регистру, в котором записано условие фильтра. Если вклю- 
чить эту опцию, то слова «Цех 1» и «цех 1» будут считаться идентичными. 

При записи условий можно использовать операции отношения =, >, >=, <, 
<=, <>, а также логические операции and, ог и not. Например, вы можете напи- 
сать фильтр 


(Рер='Цех 1')and(Year_b<=1970) and(Year_ b>=1940) 


и отобразятся записи сотрудников цеха 1, чей год рождения лежит в заданных 
пределах. Но использовать в фильтре имена вычисляемых полей (например, вве- 
денного нами поля Age) не разрешается. 

Конечно, свойства, определяющие фильтрацию, можно задавать не только в 
процессе проектирования, но и программно, во время выполнения. Давайте введем 
такую возможность в наше приложение. Установите в компоненте DBGrid1 свой- 
ство Align равным а! М опе, увеличьте вертикальный размер формы и перенесите 
на форму группу радиокнопок RadioGroup (назовите ее RGF), выпадающий спи- 
сок ComboBox (назовите его CBDep), два элемента CSpinEdit со страницы Samples 
(назовите их ЗЕшш и SEmax), кнопку, написав на ней «Обновить» и метки, раз- 
местив все это примерно так, как показано на рис. 9.34. 

Компонент CBDep будет позволять выбирать подразделение, по которому про- 
водится фильтрация. В его свойство Items занесите список имен подразделений в 
таблице. Компоненты SEmin и SEmax будут служить для задания диапазона воз- 
раста при фильтрации по этому критерию. Задайте в них разумные значения 
свойств MaxValue, MinValue и Value. В группе радиокнопок RGF введите соот- 
ветствующие надписи (в свойствах Items и Caption), показанные на рис. 9.34, за- 
дайте ItemIndex = 0 и Columns = 2. Осталось написать операторы, обеспечиваю- 
щие фильтрацию. Ниже приведен соответствующий текст. 
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Рис. 9.34. 
Приложение с возможностью фильтрации 
записей 
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unsigned short Year, Month, Day; 

deve __fastcall TForml : : Table1CalcFields (TDataSet *DataSet) 
а: oy Pe = Year - TablelYear b->Value; 
ИОН 

Hoy 8 __fastcall TForml::RGFClick(TObject *Sender) 


Tablel->IndexName = "depfio"; 
if (RGF->ItemIndex == 0) 
Tablel->Filtered = false; 
else 
{ 
if (RGF->ItemIndex == 2) 
Tablel->Filter = "Dep='"+CBDep->Text+"'"; 
else if (RGF->ItemIndex == 3) 
{ 
Tablel->Filter,=. "(Year b<="+ 


IntToStr (Year-SEmin->Value) + 
") апа (Уеаг b>="+IntToStr (Year-SEmax->Value) 
+") ыы | 
Tablel->IndexName = "Year"; 
} 
else 
Tablel->Filter = "(Dep='"+CBDep->Text+ 
"') апа (Уеаг b<="+IntToStr (Year-SEmin->Value) 
+")and(Year b>="+IntToStr (Year-SEmax->Value) +") "; 
Tablel->Filtered = true; 
} ь 
} 
РА ЕЕ С ник AVE SLATE (LAR ES: 
void _fastcall TForml::FormCreate(TObject *Sender) 
{ 
CBDep->ItemIndex = 0; 
Date() .DecodeDate (&Year, &Month, &Day) ; 
Tablel->Active = true; 
} 
ЕСТЬ рта ee aS LT TAS 
void _fastcall TForml::FormDestroy(TObject *Sender) 
{ 
Tablel->Active = false; 


} 


Текст включает три процедуры. Одна из них — TablelCalcFields уже была 
рассмотрена ранее. Ее отличие от рассмотренной заключается только в том, что пе- 
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ременные Year, Month и Day сделаны глобальными (их объявление вынесено из 
процедуры) и обращение к функциям Date и DecodeDate перенесено в процедуру 
FormCreate — обработчик события формы OnCreate. Сделано это для того, чтобы 
можно было воспользоваться значением текущего года Уеаг в двух процедурах — 
TablelCalcFields и RGFClick. В процедуру FormCreate внесен также оператор 


Tablel->Active = true; 


открывающий связь с базой данных (разрывается эта связь при завершении вы- 
полнения приложения в обработчике события формы OnDestroy) и оператор 


CBDep->ItemIndex = 0; 


Этот оператор задает начальное значение индекса выпадающего списка 
CBDep. Если бы этого оператора не было, то в начале выполнения приложения 
пользователь не увидел бы текста в списке, поскольку по умолчанию индекс ра- 
вен -1. Задать же значение индекса в процессе проектирования невозможно, по- 
скольку ItemIndex — свойство, доступное только во время выполнения. 

Теперь остановимся на основной процедуре приложения — RGFClick, которая 
осуществляет фильтрацию и упорядочивание данных. Обращение к этой процедуре 
делается при событиях OnClick компонента RGF — группы радиокнопок, и кнопки 
Обновить. Эта кнопка введена в приложение, чтобы можно было, не переключая ра- 
диокнопок, обновлять отображение данных после изменения пользователем имени 
подразделения или диапазона возраста. Удобно также сделать обращение к процеду- 
ре RGFClick при событии OnChange выпадающего списка отделов. 

Первый оператор процедуры RGFClick задает индекс 4дерйо, обеспечивающий 
упорядочивание данных по подразделениям и алфавиту. Следующий оператор ана- 
лизирует индекс группы радиокнопок, т.е. анализирует заданный пользователем 
способ фильтрации. Если индекс равен нулю (отсутствие фильтрации), то фильтр 
отключается установкой свойства Filtered в false. При других значениях индекса 
это свойство устанавливается в true. Если индекс равен 2 (фильтрация по отде- 
лам), то значение свойства Filter формируется равным Dep="...', где вместо точек 
фигурирует текст, отображаемый в выпадающем списке CBDep. Если индекс равен 
3 (фильтрация по возрасту), то значение свойства Filter формируется равным 
(Year_b<=...)and(Year_b>=...), где вместо точек подставляются данные, введенные 
пользователем в компонентах SEmin и SEmax. При этом приходится пересчиты- 
вать заданный пользователем диапазон возраста в диапазон годов рождения, по- 
скольку наложить ограничения непосредственно на вычисляемое поле возраста 
Age невозможно. 

Приведенный выше текст рассчитан на применение C++Builder 5. Для более 
ранних версий C++Builder его надо несколько изменить, поскольку компилятор 
C++Builder выдаст ошибку вида: «Ambiguity between ‘ fastcall Sysutils::Int- 
ToStr(__int64)' and ‘ fastcall Sysutils::IntToStr(int)'». Это означает, что компиля- 
тор не может осуществить выбор между двумя перегруженными функциями 
IntToStr с аргументами типов __ 11164 и int. Подробнее об этом см. в разделе13.2 
главы 13. Чтобы ликвидировать эту ошибку, надо применить в функции IntToStr 
явное приведение типа. Например, IntToStr((int)(Year-SEmin->Value)). 

Вы можете откомпилировать свое приложение и посмотреть его в работе. 


Имеется еще один способ проводить фильтрацию — использовать обработку 
события OnFilterRecord. Это событие происходит каждый раз при смене текущей 
записи, если свойство Filtered установлено в true. В обработчик события передает- 
ся по ссылке параметр Accept булева типа. Если проверка полей показывает, что 
запись удовлетворяет фильтру, TO Accept должен быть установлен в true. Если yc- 
ловия фильтрации не выполнены, параметру Accept должно быть присвоено зна- 
чение false. Обработчик события OnFilterRecord, обеспечивающий те же функ- 
ции, что и процедура RGFClick в приведенном выше примере, может иметь вид 
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void  fastcall TForml::TablelFilterRecord(TDataSet *DataSet, 
bool &Accept) 


{ 


Accept = (RGF->ItemIndex == 0) || 
((RGF->ItemIndex == 2) && (TablelDep->Value==CBDep->Text)) || 
((RGF->ItemIndex == 3) && 


(TablelYear b->Value <= (Year-SEmin->Value)) && 
(TablelYear b->Value >= (Year-SEmax->Value))) || 
((TablelDep->Value == CBDep->Text) && 
(TablelYear b->Value <= (Year-SEmin->Value)) && 
(TablelYear b->Value >= (Year-SEmax->Value) )); 

} 


В этом операторе свойству Accept непосредственно присваивается значение ре- 
зультата анализа условий фильтрации в зависимости от значения свойства‘ Цет- 
Index группы радиокнопок RGF. Например, если RGF->ItemIndex = 0 (пользова- 
тель задал просмотр без фильтрации), то Accept = true независимо от каких-либо 
других условий. 

Приведенный оператор обеспечивает нужную фильтрацию. Но чтобы он рабо- 
тал, необходимо выполнить еще два условия. Во-первых, надо не забыть устано- 
вить в компоненте Tablel значение Filtered = true. Кроме того, надо обеспечить, 
чтобы при смене условий отображения таблицы проводилась бы новая фильтра- 
ция. Иначе просто события OnFilterRecord не будут происходить. Поэтому в обра- 
ботчик RGFClick события OnClick компонента ВСЕ надо вставить операторы: 


Tablel->Filtered = false; 

Tablel->Filtered = true; 

if (RGF->ItemIndex == 3) 
Tablel->IndexName = "Year"; 

else Tablel->IndexName = "depfio"; 


Первые два оператора обеспечивают отключение и включение фильтрации. 
При включении и происходят события OnFilterRecord. А третий оператор просто 
изменяет индексацию в зависимости от того, что задал пользователь. На этот обра- 
ботчик RGFClick надо сослаться и в событии OnClick кнопки Обновить. 

Попробуйте создать описанный вариант приложения, откомпилировать его и 
посмотреть в работе. 


9.6 Использование словарей атрибутов полей 


Выше мы рассмотрели множество свойств полей. Если вы хотите использовать 
эти свойства в различных приложениях или в различных частях одного приложе- 
ния, то желательно обеспечить единый стиль представления данных, единые заго- 
ловки одноименных столбцов таблиц, их единый размер и т.п. Задавать для каж- 
дого нового компонента Table все это заново — достаточно трудоемкое занятие. К, 
тому же обеспечить при этом единообразие довольно сложно. 

Решить эту задачу помогают словари. Создать новый словарь можно с помо- 
щью программы SQL Explorer, вызываемой командой главного меню Database | Ex- 
роге. Ранее в разделе 9.3.4 мы рассмотрели страницу Databases SQL Explorer. Для 
создания нового словаря надо перейти на страницу Dictionary и выполнить команду 
Dictionary | New. Откроется диалоговое окно создания нового словаря, представлен- 
ное на рис. 9.35. В верхнем окне редактирования Dictionary Мате вы пишете имя 
создаваемого словаря. Это то имя, по которому вы в дальнейшем сможете выбрать 
этот словарь среди других. В расположенном ниже выпадающем списке Database 
выбираете базу данных, в которой хотите сохранить словарь. Словарь по умолча- 
нию сохраняется в виде таблицы Paradox. Поэтому в следующем окне Table Мате 
вы пишете имя таблицы, в которой будет сохраняться словарь. В нижнем окне 
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Рис 9 35 teate a new Dictionary 
Создание нового словаря в SQL Explorer ОНИ 


ptior [Словарь длят лиц Pers и Dep EO 


Description вы можете написать произвольный комментарий, описывающий назна- 
чение вашего словаря. В заключение щелкаете на ОК и новый словарь создан. 

Вы попадаете в окно, представленное на рис. 9.36. Раскрыв вершину Dictionary, 
вы увидите два раздела: Databases — базы данных, и Attribute Sets — множества ат- 
рибутов. Пока обе эти вершины будут пустыми. 


Рис. 9.36. 
Задание атрибутов полей в словаре 


Defir 


TFieldClass 
| 1 | TControlClass | 
. : +i & FE Dep < || Alignment 
4 (El Fam | DisplayLabel Отдел. 
+f] Nam | DisplayWidth 11 
ef Num || Resdny 
#2 Par —1| | Required False 
#- 0 PersSex _ || Visible — 
_ {| Transliterate 
1 EditMask 


Чтобы связать создаваемый словарь с таблицами базы данных, надо выпол- 
нить команду Dictionary | Import From Database. В появившемся диалоговом окне 
(рис. 9.37) вы можете выбрать из выпадающего списка псевдоним базы данных. 
После того, как вы нажмете ОК, сведения о базе данных, ее таблицах и полях таб- 
лиц будут импортированы в словарь. В окне рис. 9.36 в вершине Databases появят- 
ся дочерние вершины относящиеся к базе данных, таблицам и полям. Можно соз- 
давать словарь и на основе нескольких баз данных, поочередно импортируя их ко- 
мандой Dictionary | Import From Database в словарь. 


Рис. 9.37. Import Databa 
Импорт базы данных в словарь 


Теперь можно задавать атрибуты полей. Вы можете создавать новые дочерние 
вершины множества атрибутов непосредственно в этом окне. Для этого надо выде- 
лить раздел Attribute Sets, щелкнуть правой кнопкой мыши и из всплывающего меню 
выбрать раздел New. Затем в появившейся назкране дочерней вершине надо ввести 
имя поля. После этого в правой части окна можно задавать различные атрибуты. 

Но, конечно, много проще перенести атрибуты из какого-то из ваших проек- 
тов, где они уже установлены в Редакторе Полей. Откройте какой-нибудь из ва- 
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ших предыдущих проектов, в котором вы установили атрибуты всех полей табли- 
цы Pers. Сделайте в нем двойной щелчок на компоненте Table. Если вы пользова- 
лись при создании этого приложения Редактором Полей, то в его окне появится 
список полей. Для записи атрибутов этих полей в словарь выделите их все, щелк- 
ните правой кнопкой мыши и из всплывшего меню выберите раздел Save Attributes 
а5. Вам откроется небольшое диалоговое окно, представленное на рис. 9.38. В его 
верхнем окошке Attribute set name вам предлагается имя сохраняемого множества 
атрибутов, которое по умолчанию складывается из имени таблицы и имени поля. 
Вы можете изменить его, как угодно. Например, убрать из него имя таблицы. В 
нижнем окошке Based оп вы можете выбрать одно из уже имеющихся в словаре по- 
лей, в качестве основы для атрибутов данного поля. Например, после того, как вы 
введете в словарь все атрибуты полей таблицы Pers, вы можете аналогичным обра- 
зом вводить атрибуты полей таблицы Dep. При этом для атрибутов поля Dep вы 
можете выбрать за основу уже введенные атрибуты PersDep. 


Рис. 9.38. Save Dep attributes as 
Сохранение атрибутов полей из Редактора Полей | 
в словарь 


После того, как вы щелкнете в окне рис. 9.38 на ОК, в словаре появится дан- 
ное множество атрибутов с указанным вами именем. Эта процедура повторится 
для каждого из выделенных вами полей, атрибуты которых вы сохраняете. 

Теперь повторите опять команду главного меню Database | Explore. Вы увидите 
окно, показанное ранее на рис. 9.36, но в нем еще не будет введенных вами вер- 
шин. Для того, чтобы увидеть их, щелкните правой кнопкой мыши и выберите из 
всплывшего меню команду Refresh — обновить. Тогда изображение обновится и вы 
увидите вершины, соответствующие сохраненным атрибутам полей. В правой по- 
ловине окна отображаются атрибуты, которые при желании вы можете изменять. 
Причем вы можете увидеть, что сохраняются все атрибуты объектов-полей, вклю- 
чая заданные ограничения, значения по умолчанию, атрибуты оформления ит.д. 

Прежде, чем расстаться с окном SQL Explorer, несколько слов о методике pe- 
дактирования в нем. Вы можете изменять атрибуты, можете удалять вершины (ко- 
манда Object | Delete или вторая слева быстрая кнопка). И то, и другое не выполня- 
ется сразу. Просто изменяемая вершина помечается на удаление или редактирова- 
ние. От изменения вершины можно отказаться (команда Object | Cancel или третья 
слева быстрая кнопка). А можно подтвердить изменение командой Object | Apply 
или четвертая слева быстрая кнопка. 

Команда Dictionary | Select позволяет открыть один из зарегистрированных сло- 
варей. Если вы хотите в разрабатываемом вами новом приложении воспользовать- 
ся определенным словарем — откройте его данной командой (если, конечно, он не 
был открыт ранее). 

А теперь посмотрим, как можно использовать словарь. Откройте новое прило- 
жение, перенесите на форму обычную цепочку компонентов Table, DataSource, 
DBGrid, свяжите компоненты друг с другом и с таблицей Pers базы данных dbP. 
Установите в Table свойство Active в true. Вы увидите содержание таблицы, HO 
оно пока не будет отформатировано так, как нужно вам. А теперь сделайте двой- 
ной щелчок Ha Table и добавьте в Редактор Полей все поля таблицы. В тот же мо- 
мент вы увидите, что восприняты все форматы отображения полей и все их атрибу- 
ты, которые вы сохраняли в словаре. Чувствуете, сколько своего времени вы сэко- 
номили? При желании вы можете отсоединить то или иное поле от словаря, выде- 
лив его в Редакторе Полей, щелкнув правой кнопкой и выбрав команду Unassosiate 
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attributes. После этого вы можете или изменить атрибуты, или взять за образец ат- 
рибуты какого-либо другого множества из словаря. Для этого щелкните правой 
кнопкой и выберите команду Assosiate attributes. Вам будет предложено окно со спи- 
ском всех множеств атрибутов в словаре. Из этого списка вы можете выбрать обра- 
зец для своего поля, a затем отредактировать его. 


9.7 Некоторые компоненты визуализации 
и управления данными 


В приведенном приложении в качестве компонента визуализации и управле- 
ния данными использовался DBGrid. Но еще не со всеми свойствами этого компо- 
нента мы ознакомились. В том виде, как мы его применяли, пользователю неудоб- 
но вводить многие данные. Например, вводя имя подразделения, пользователь 
должен полностью его написать: «Бухгалтерия» или «Цех 1». Да еще, если он 
ошибется в названии, то приложение выдаст ему ошибку. Этот недостаток можно 
устранить, если воспользоваться свойством Columns компонента DBGrid. Это 
свойство представляет собой набор объектов, каждый из которых отражает один 
столбец таблицы. Пока мы использовали столбцы, формируемые по умолчанию. 
Попробуем теперь сформировать их, используя свойство Columns. 

Щелкните правее этого свойства в Инспекторе Объектов. На экране появится 
пустое окно Редактора Столбцов (рис. 9.39 а). Вы можете добавлять столбцы по од- 
ному, щелкая на быстрой кнопке Add (первая слева) и указывая для них в Инспек- 
торе Объектов соответствующие поля в свойстве FieldName. То же самое можно де- 
лать, щелкая правой кнопкой мыши и выбирая в контекстном меню раздел Add. A 
можно поступить иначе: выбрать из контекстного меню раздел Add All Fields или 
щелкнуть на соответствующей быстрой кнопке (вторая справа). В окне Редактора 
Столбцов появится список столбцов всех полей, которые добавлены вами в Редак- 
торе Полей компонента Table. Затем кнопкой Delete (вторая слева) вы можете уда- 
лить столбцы, ненужные в таблице. 

Выделите в Редакторе Полей столбец, связанный с полем Dep, и посмотрите 
его свойства в Инспекторе Объектов. Среди многих достаточно очевидных свойств 
столбца вы увидите свойство ButtonStyle. Оно определяет стиль ввода данных в 
поле текущей записи. Свойство ButtonStyle может принимать значения: 


Рис. 9.39. ФИГ; Editing DBGrid1->Columns 
Главное окно 


редактора столбцов 
(а) и ячейка поля 
Dep при Виуноп Ме 


Иванович 
i Петрович 
_ Сидорович _ 


= cbsAuto (6) и при jc Ирина Veatosna 
ButtonStyle = т | `Николай _ Николаевич : 
cbsEllipsis (в) : и „Андреевич „ 


‘Борисович 


Сидор Сидоровь 

‘Ирина Ивановна 

й Николаевич | 

ея sy wince Анареевич 


Борисов. | Борис ‚Борисович о 
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Появление при редактировании кнопки, связанной с выпадающим 
списком допустимых значений 


cbsAuto 


cbsEllipsis Появление при редактировании кнопки с многоточием «...», при 


щелчке на которой наступает событие OnEditButtonClick компо- 
нента DBGrid 


cbsNone Обычное редактирование без каких-либо кнопок 


Если установить значение chsAuto (оно принято по умолчанию), то можно до- 
полнительно установить свойство столбца PickList, которое представляет собой 
список допустимых значений поля. В нашем примере для столбца Dep можно зане- 
сти в список PickList значения «Бухгалтерия», «Цех 1» и «Цех 2». Тогда при по- 
пытке пользователя редактировать данное поле в соответствующей ячейке табли- 
цы появится кнопка, связанная с выпадающим списком, содержащим допустимые 
значения (рис. 9.39 6). Аналогично можно было бы задать значения «м» и «ж» в 
списке PickList поля Sex. Свойство DropDownRows (по умолчанию 7) определяет 
допустимое число строк в списке, отображаемое без появления полосы прокрутки. 
Если реальное число строк меньше DropDownRows, размер списка устанавливает- 
ся автоматически. 

Аналогично происходит редактирование, если значение chsAuto относится к 
столбцу, содержащему поле просмотра (см. раздел 9.10.2). Тогда выпадающий 
список заполняется автоматически. Если же данное поле не является результи- 
рующим полем просмотра и список PickList не заполнен, то никакой кнопки при 
редактировании не появится. 

Если значение свойства ButtonStyle равно cbsEllipsis, то при попытке пользо- 
вателя редактировать данное поле в нем появляется кнопка с многоточием ‹...» 
(см. рис. 9.39 в). При щелчке на этой кнопке наступает событие OnEditButton- 
Click компонента DBGrid. В обработчике этого события вы можете предусмотреть 
показ пользователю какого-то списка возможных значений или предложить диа- 
лог, в котором пользователь может в удобной форме выбрать требуемое значение. 
В обработчике события OnEditButtonClick вы можете узнать, какое поле редакти- 
руется, по свойству SelectedField компонента DBGrid. Это же свойство позволит 
вам занести в поле установленное пользователем значение. Например: 


if (DBGridl->SelectedField == TablelDep) 
{ 


DBGridl->SelectedField->Value = ...; 
} 


Если значение свойства ButtonStyle равно cbhsNone, то редактирование поля 
производится без каких-либо подсказок в виде кнопок. 

Компонент DBGrid — удобный, но далеко не единственный и не всегда луч- 
ший компонент визуализации. Форма представления данных в нем не всегда удоб- 
ная; слишком регулярная, без разделителей, не акцентирующая внимания пользо- 
вателя на каких-то группах полей. Имеется много других компонентов визуализа- 
ции и управления данными, расположенных на странице Data Control библиотеки 
компонентов, которые нередко предпочтительнее DBGrid. 

Отметим некоторые из этих компонентов. 

DBText — аналог обычной метки Label, но связанный с данными. Он позволя- 
ет отображать данные некоторого поля, но не дает возможности его редактировать. 
Тип отображаемого поля может быть различным: строка, число, булева величина. 
Компонент автоматически переводит соответствующие типы в отображаемые сим- 
волы. 
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DBEdit — связанный с данными аналог обычного окна редактирования Edit. 
Он позволяет отображать и редактировать данные полей различных типов: строка, 
число, булева величина. Впрочем, если задать в компоненте ReadOnly=true, то он, 
как и DBText, будет служить элементом отображения, но несколько более изящ- 
ным, чем DBText. 

DBMemo — связанный с данными аналог обычного многострочного окна pe- 
дактирования Memo. Он позволяет отображать и редактировать данные поля типа 
Memo, а также данные любых типов, указанных выше для предыдущих компонен- 
тов. Например, в этом компоненте можно отображать и редактировать характери- 
стику сотрудника, если такое поле предусмотрено в таблице. 

DBRichEdit — связанный с данными аналог обычного многострочного окна 
редактирования текста в обогащенном формате RTF. Область применения та же, 
что для компонента DBMemo. 

DBImage — связанный с данными аналог обычного компонента Image. Ком- 
понент позволяет отображать графические поля, например, фотографии сотрудни- 
ков. 

DBCheckBox — связанный с данными аналог обычного индикатора CheckBox. 
Он позволяет отображать и редактировать данные поля булева типа. Если при вы- 
воде данных поле имеет значение true, то индикатор включается. И наоборот, при 
редактировании поля присваиваемое ему значение определяется состоянием инди- 
катора. Кстати, это еще один способ обеспечить пользователю безошибочный ввод 
значений в булево поле, помимо рассмотренного выше задания списка возможных 
значений в DBGrid. 

DBRadioGroup — связанный с данными аналог группы радиокнопок Radio- 
Group. Компонент позволяет отображать и редактировать поля с ограниченным 
множеством возможных значений. В нашем примере это может относиться к полю 
Dep или к полю Sex. Свойство Items, как и в обычной группе радиокнопок, опре- 
деляет число кнопок и надписи около них. Но есть еще свойство Values, которое 
определяет значения полей, соответствующие кнопкам. Таким образом, надписи у 
кнопок и значения полей в общем случае могут не совпадать друг с другом. Если 
свойство Values не задано, то в качестве значений полей берутся строки из свойст- 
ва Items, т.е. надписи около кнопок. Компонент DBRadioGroup предоставляет еще 
одну возможность ввода пользователем данных путем выбора, а не написанием 
полного значения поля. 

Есть еще несколько компонентов визуализации и управления данными, кото- 
рые мы рассмотрим несколько позднее. Все перечисленные компоненты имеют два 
основных свойства: DataSource — источник данных (компонент типа TDataSour- 
се) и DataField — поле, с которым связан компонент. 

Характерной особенностью всех этих компонентов, отличающей их от анало- 
гичных компонентов, не связанных с данными, является отсутствие в окне Ин- 
спектора Объектов их основных свойств, отображающих содержание: Caption в 
DBText, Text в DBEdit, Picture в DBImage и т.п. Все эти свойства имеются в ком- 
понентах, но они доступны только во время выполнения. Так что программно их 
можно читать, редактировать, устанавливать, но во время проектирования задать 
их значения невозможно. Это естественно, так как эти свойства — это значения со- 
ответствующих полей таблицы базы данных. 

Перечисленные компоненты, как, впрочем, и любые обычные метки и другие 
компоненты, могут размещаться непосредственно на форме, на любой панели, а 
могут размещаться в специальном компоненте — таблице DBCtriGrid. Этот компо- 
нент состоит из нескольких панелей, из которых проектируется только первая, а 
остальные повторяют структуру первой, но относятся к последующим записям 
таблицы. DBCtriGrid имеет свойство DataSource, которое автоматически переда- 
ется всем расположенным на панелях компонентам, связанным с данными. Свой- 
ство RowCount определяет число строк в таблице (по умолчанию 3), а свойство 
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ColCount — число колонок в таблице (по умолчанию 1). Ширину и высоту панелей 
DBCtriGrid можно задавать свойствами PanelWidth и PanelHeight соответствен- 
но, или задавая общую ширину и высоту компонента свойствами Width и Height. 
В этом случае C++Builder может автоматически округлить заданные вами значе- 
ния так, чтобы обеспечить равные ширину и высоту всех панелей. 

Опробуйте эти компоненты в работе. На рис. 9.40 показано приложение, по- 
строенное с использованием рассмотренных элементов. Компонент DBCtrIiGrid 
имеет 3 строки и 3 столбца. На панели этого компонента в данном случае располо- 
жен всего один компонент DBText, связанный с полем Fam. В целом весь компо- 
нент DBCtrlGrid отображает алфавитный список сотрудников (таблица использует 
индекс fio). В нижней части экрана располагается подробная информация о CO- 
труднике. Отдел, в котором работает сотрудник, отображается компонентом 
DBEdit, а остальные — компонентами DBText. Компоненты, отображающие фа- 
милию, имя и отчество, расположены без промежутков, так что образуют сплош- 
ную полосу. В компоненте DBEdit установлено ReadOnly=false, так что пользова- 
тель может редактировать эту информацию. Таким образом, перемещаясь по спи- 
ску сотрудников, пользователь может просматривать информацию о выбранном 
сотруднике и частично ее редактировать, перемещая, например, с помощью окна 
DBEdit сотрудника в другое подразделение. 


Рис. 9.40. 

Приложение, демонстрирующее 
использование различных компонентов 
ввода и отображения данных 


Кнопка Больше в правом нижнем углу позволяет открыть дополнительное окно 
(рис. 9.41), в котором отображается характеристика и фотография сотрудника. 
Для этого используются соответственно компоненты DBImage и ОВМето. Харак- 
теристику, загружаемую в DBMemo, пользователь может редактировать. ~ 


Рис. 9.41. Характеристика _____ 
Характеристика 

Вспомогательное окно приложения, отображающее Ри ель ФАС 

характеристику и фотографию сотрудника 1971 г.р., 


сотрудницы цека 1 


И.И. Иванова очаровательная 
женщина.. 


Начальник ОК ИИ. Иванов 


Размещение компонентов визуализации на отдельной форме не вызывает ни- 
каких принципиальных сложностей. Надо только в модуле дополнительной фор- 
мы сослаться с помощью директивы препроцессора #include на модуль основной 
формы, чтобы получить доступ к расположенному на ней компоненту типа TData- 
Source. Вспомним, что эту ссылку проще всего сделать командой File | Include Unit 
Наг. Тогда при задании свойств DataSource компонентов, расположенных на вспо- 
могательной форме, в выпадающем списке появится источник данных Form1-> 
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DataSourcel, который и надо выбрать. А в главной форме надо аналогичным обра- 
зом сослаться на вспомогательную форму, чтобы в нужный момент можно было 
сделать ее видимой. Тогда в обработчике события OnClick кнопки Больше можно 
написать оператор: 


if (! Form2->Visible) Form2->Show() ; 


который делает вспомогательную форму Form2 видимой, если она He была види- 
мой до этого. 

В рассмотренном приложении имеются определенные неудобства: результаты 
редактирования будут заноситься в базу данных только тогда, когда пользователь 
перейдет к следующей записи. Кроме того, при неверном указании отдела пользо- 
ватель увидит сообщение об ошибке на английском языке, которое, возможно, бу- 
дет ему мало понятно. Все это не трудно было бы исправить. Позднее мы еще вер- 
немся к этому приложению и посмотрим, как его можно усовершенствовать. 


9.8 Компонент Session 


Компоненты Session осуществляют общее управление связыванием приложе- 
ния с базами данных. Обычно пользователю не приходится заботиться о компонен- 
те Session, поскольку C++Builder автоматически генерирует объект Session в каж- 
дом приложении, работающем с базами данных. На этот объект можно ссылаться 
через глобальную переменную Session. 

Компонент Session имеет много полезных методов и позволяет легко работать 
с BDE. Приведем простой пример использования некоторых методов Session. Да- 
вайте построим приложение, позволяющее просматривать любую заданную поль- 
зователем таблицу в любой заданной им доступной базе данных. Это приложение 
(рис. 9.42) содержит два выпадающих списка типа TComboBox, названных cbAli- 
аз и cbTable. Первый из них предназначен для выбора пользователем псевдонима 
базы данных, а второй — для выбора таблицы. Кнопка Просмотр предназначена 
для просмотра выбранной таблицы в компоненте типа TDBGrid, связанном цепоч- 
кой ссылок с компонентами DataSourcel и Tablel. 


Рис. 9.42. 
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Чтобы такое приложение функционировало, надо при создании формы загру- 
зить список cbDatabase доступными BDE псевдонимами. Это делается следующим 
оператором, помещенным в обработчик события OnCreate формы: 


Session->GetAliasNames (cbAlias->Items) ; 
Этот оператор использует метод GetAliasNames объекта Session, который пе- 


редает в свой параметр типа TStrings (в данном примере это список cbAlias-> 
Items) перечень псевдонимов баз данных, зарегистрированных в ВПЕ. 
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При выборе пользователем в списке cbAlias базы данных надо загрузить спи- 
сок cbTable перечнем таблиц выбранной базы данных. Это делается включением в. 
обработчик события OnChange компонента cbAlias операторов: 


Session->GetTableNames (сфА]11а$->Техе, "", сгце, Еа]15е, cbTable->Items) ; 
cbTable->ItemIndex =.0; 


Первый из этих операторов использует метод GetTableNames для загрузки в 
свой последний параметр типа TStrings (в данном примере это список cbTable-> 
Items) перечня таблиц базы данных, заданной своим первым параметром (в дан- 
ном примере это cbhAlias->Text). Второй параметр метода позволяет задать шаб- 
лон, отбирающий имена таблиц. Например, шаблон «р*» отберет имена таблиц, 
начинающиеся с символа «р». Пустой шаблон, использованный в примере, означа- 
ет выбор всех таблиц. Третий параметр, установленный в true, означает, что в име- 
на таблиц будет включаться расширение файла (это необходимо для таблиц Para- 
dox и dBase). Четвертый параметр задается равным false для баз данных Paradox и 
dBase, а для баз данных, основанных на SQL, этот параметр устанавливается в 
true, чтобы возвращать и таблицы данных и системные таблицы, определяющие 
структуру данных. 

Теперь остается ввести в приложение обработчик нажатия кнопки Просмотр. 
Этот обработчик может иметь вид: 


if (cbTable->Text == "") 
{ 
ShowMessage ("Не задана таблица"); 
return; 


} 
Tablel->Active = false; 
Tablel->DatabaseName = cbAlias->Text; 
Tablel->TableName = cbTable->Text; 
Tablel->Active = true; 


Этот обработчик выводит компонент Tablel из активного состояния, чтобы 
можно было связаться с новой базой данных, затем задает его свойства Database- 
Name и Та еМате равными выбранным пользователем значениям и переводит 
Та е1 в активное состояние. 

Откомпилируйте приложение и посмотрите его в работе. Вы можете посмот- 
реть с его помощью не только свои, но и другие базы данных, прилагаемые к 
C++Builder. | 

Выше показано использование компонента Session, создаваемого неявно по 
умолчанию. Вводить явным образом компоненты Session приходится только в 
многозадачных приложениях, в которых предусмотрено несколько параллельных 
процессов со своими потоками обмена информацией с базой данных. В таких мно- 
гопоточных приложениях обычно вводится явным образом по одному компоненту 
Session на каждый поток, чтобы исключить влияние потоков друг на друга. 

При явном вводе компонента Session в приложение следует установить его 
свойство SessionName — имя сеанса сетевого соединения, задав в нем произволь- 
ный идентификатор, например, $1. После этого в выпадающих списках свойств 
5е5510оп Маше компонентов типа TDatabase, TTable, TQuery и т.п. появится вве- 
денное вами имя. Выбор соответствующего имени сеанса сетевого соединения из 
этих списков свяжет эти компоненты с соответствующим компонентом Session. 

Если в приложении имеется несколько компонентов Session, глобальная пере- 
менная Session по-прежнему одна. Она имеет тип TSessionsList и содержит дан- 
ные о каждом компоненте Session. 
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9.9 Компонент BatchMove 


Компонент BatchMove предназначен для групповых операций переноса дан- 
ных из одного набора в другой. Основные свойства компонента: Source — набор 
источника данных (например, компонент типа TTable) и Destination — приемник 
данных типа TTable. Свойство Mode определяет режим переноса данных. Это свой- 
ство может иметь следующие значения: 


batAppend Записи из источника данных добавляются в приемник, не 
изменяя существующих там записей. Таблица-приемник 
должна существовать до начала переноса данных 

Ба Орде Записи в таблице-приемнике с ключевыми полями, соответ- 


ствующими полям в таблице-источнике, изменяются на за- 
писи из источника. Новые записи в приемник не добавля- 
ются. Таблица-приемник должна существовать до начала 
переноса данных и должна иметь индекс 


batAppendUpdate Записи в таблице-приемнике с ключевыми полями, соответ- 
ствующими полям в таблице-источнике, изменяются на за- 
писи из источника. Записи из таблицы источника, которые 
не имеют соответствия в приемнике, добавляются туда. Таб- 
лица-приемник должна существовать до начала переноса 
данных и должна иметь индекс 


batDelete Записи в таблице-приемнике, которым находится соответст- 
вие в источнике, удаляются из приемника. Таблица-прием- 
ник должна существовать до начала переноса данных и дол- 
жна иметь индекс 


batCopy Таблица-приемник создается и заполняется записями источ- 
ника. Если таблица-приемник уже существовала, то ее со- 
держимое заменяется на содержимое источника 


Основной метод компонента — Ехесще выполняет операцию переноса дан- 
ных. Свойство MovedCount указывает число записей, успешно перенесенных в 
таблицу-приемник. 

При переносе записей из одной таблицы в другую могут возникать проблемы, 
связанные с несоответствием типов полей в таблице-источнике и таблице-прием- 
нике. В этих случаях свойство AbortOnProblem указывает, должна ли немедленно 
прекращаться операция, вызвавшая несоответствие типов полей в таблице-источ- 
нике и таблице-приемнике. При задании AbortOnProblem = false желательно од- 
новременно задать свойство ProblemTableName. Это свойство указывает имя таб- 
лицы Paradox, в которую будут помещаться записи, в которых обнаружено несоот- 
ветствие типов полей и которые поэтому не помещенны в приемник. Свойство 
ProblemCount определяет число записей, в которых возникли подобные пробле- 
мы. При задании AbortOnProblem = false записи с полями несоответствующих TH- 
пов нередко все-таки могут помещаться в таблицу-приемник. Дело в том, что ком- 
понент BatchMove пытается в этом случае преобразовать тип поля таблицы-источ- 
ника в тип поля таблицы-приемника. Если такое преобразование возможно, то ни- 
каких проблем при переносе записей не возникает. 

В некоторых случаях перенос отдельных записей может оказаться невозмож- 
ным из-за того, что они нарушают целостность данных в таблице-приемнике, на- 
пример, дублируют значения ключевого поля, которые должны быть уникальны- 
ми. В этих случаях свойство AbortOnKeyViol указывает, должна ли немедленно 
прекращаться операция, вызвавшая нарушение целостности данных в табли- 


Приложения для работы с локальными базами данных 545 
д 


це-приемнике. При задании AbortOnKeyViol = false желательно одновременно за- 
дать свойство KeyViolTableName. Это свойство указывает имя таблицы Paradox, в 
которую будут помещаться записи, которые не перенесены в приемник из-за нару- 
шения целостности данных. Свойство KeyViolCount определяет число таких запи- 
сей. 

Поскольку при переносе данных могут возникать указанные выше и иные не- 
приятности, в компоненте TBatchMove предусмотрен механизм, позволяющий 
произвести «откат» и сохранить прежние данные таблицы-приемника. Этому слу- 
жит свойство ChangedTableName, в котором вы можете указать имя таблицы 
Paradox, создаваемой для сохранения копий всех изменяемых записей табли- 
цы-приемника. Свойство ChangedCount содержит число записей, измененных или 
добавленных в таблице-приемнике (при Mode = batUpdate или batAppendUp- 
date), или удаленных из нее (при Mode = batDelete). Копии этих записей хранятся 
в таблице ChangedTableName. 

Свойство Mappings типа TStrings позволяет задать таблицу соответствия по- 
лей источника и приемника. По умолчанию поля таблиц переносятся в поля при- 
емника с теми же именами и в той же последовательности, как в источнике. Если 
это вас устраивает, то свойство Mappings задавать не надо. Но если вы зададите 
свойство Mappings, то можете изменить определенный по умолчанию способ пере- 
носа данных. Во-первых, вы можете задать в этом свойстве только часть полей, 
значения которых надо переносить. Имена полей записываются по одному в строч- 
ке. Значения полей, не указанные в Mappings, переноситься не будут. Более того, 
вы можете указать, в какое поле приемника надо переносить значение поля источ- 
ника. Например, если вы задаете в Mappings строку 


Dep 


то значение поля Dep из источника будет переноситься в поле Dep приемника. Ho 
если вы зададите строку 


DepNew = Dep 


_ то значение поля Dep из источника будет переноситься в поле DepNew приемника. 


9.10 Приложения с несколькими связанными 
таблицами 


9.10.1 Связь головной и вспомогательной таблиц 


Предыдущие приложения общались с одной таблицей. Теперь посмотрим, как 
строить приложения с несколькими связанными друг с другом таблицами. 

Две таблицы могут быть связаны друг с другом по ключу. Одна из этих связан- 
ных таблиц является головной (master), а другая — вспомогательной, детализирую- 
щей (detail). Например, мы хотим построить приложение, в котором имеется табли- 
ца Dep, содержащая список подразделений учреждения (поле Dep) и характеристи- 
ку этих подразделений (поле Proizv булева типа, в котором true означает «Произ- 
водство», a false — «Управление»). И хотим, чтобы пользователь, перемещаясь по 
этой таблице, видел не только характеристику подразделения, но и список сотруд- 
ников этого подразделения, т.е. записи из таблицы Pers, в которых значение поля 
Dep совпадает со значением поля Dep в текущей записи первой таблицы. 

В этом случае головной является таблица Dep, вспомогательной — таблица 
Pers, а ключом, определяющим их связь, являются поля Dep из обеих таблиц. 

Откройте новое приложение и разместите на нем 2 комплекта Table, Data- 
Source и средств отображения данных. Результат может выглядеть например так, 
как показано на рис. 9.43. В первом комплекте использован компонент отображе- 
ния DBCtriGrid, на панелях которого располагаются метки DBText. Комплект 
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обычным образом настраивается на первую, головную (master) таблицу — Dep. 
Таблица должна быть индексирована по полю Dep, которое будет ключом для свя- 
зи таблиц. Метки, размещенные на DBCtrlGrid, связываются с полями Dep и Рго- 
izv. 
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Второй комплект компонентов использует для отображения данных компо- 
нент DBGrid. Комплект настраивается на вторую вспомогательную таблицу — 
Pers. Для таблицы должен быть задан индекс, содержащий ключевое поле связи 
Dep. После того, как все это сделано, можете выполнить приложение, чтобы убе- 
диться, что все сделано правильно. Пока вы имеете две несвязанные друг с другом 
таблицы, по которым можете перемещаться независимо. 

Теперь свяжите эти таблицы. Разорвите временно связь с базой данных во вто- 
ром комплекте, настроенном на вспомогательную таблицу Pers (установите Active 
= false). Далее в свойстве MasterSource компонента Table, настроенного на вспо- 
могательную таблицу, установите имя головной таблицы. После этого щелкните 
на свойстве MasterFields. Откроется окно редактора связей полей (Field Link 
Designer). Его вид приведен на рис. 9.44. В нем слева в окне Detail Fields расположе- 
ны имена полей вспомогательной таблицы, но только тех, по которым таблица ин- 
дексирована. Именно поэтому надо индексировать таблицу так, чтобы индекс 
включал ключевое поле связи Dep. Справа в окне Master Fields расположены поля 
головной таблицы. Выделите в одном и другом окне ключевое поле (в нашем слу- 
чае Dep). При этом активизируется кнопка Add, и после щелчка Ha ней ключевые 
поля переносятся в нижнее окно Joined Fields — соединяемые поля. Если ключ со- 
ставной (например, фамилия, имя, отчество) — эта операция повторяется для дру- 
гих полей. В конце формирования связей щелкните на OK и в свойстве Master- 
Fields компонента Table появится текст — связанные поля. После этого можете 
восстановить связь с базой данных (Active = true) и запустить приложение. 

Вы увидите (рис. 9.43), что в зависимости от того, какую запись вы выделяете 
в списке отделов, вам отображается список сотрудников этого отдела. Таким обра- 
зом, курсор скользит по головной таблице, а вспомогательная таблица отображает 
только те записи, в которых ключевые поля совпадают с ключевыми полями го- 
ловной таблицы. 


Рис. 9.44. 
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9.10.2 Поля просмотра (lookup fields) 


Возможна и другая связь таблиц, отличная от рассмотренной выше. Вы може- 
те ввести в компонент Table, связанный с одной таблицей, поля просмотра, значе- 
ния которых получаются в результате просмотра другой таблицы. Эти поля содер- 
жат данные только для чтения. Пусть, например, вы хотите добавить в компонент 
Table2, связанный с таблицей Pers, поле, которое бы отображало характер подраз- 
деления, в котором работает каждый сотрудник. Этот характер подразделения со- 
держится в таблице Dep в поле Proizv. Пусть с этой таблицей связан компонент 
Tablel. ; | 

Сделайте двойной щелчок на Table2 — таблице, в которую вы хотите ввести 
поле просмотра. В появившемся окне Редактора Полей щелкните правой кнопкой 
мыши и из всплывшего меню выберите раздел New Field. Перед вами откроется 
окно создания нового поля, с которым вы уже знакомы по созданию вычисляемых 
полей (рис. 9.45). Введите имя (Мате) создаваемого поля. Оно должно отличаться 
от имен других полей. Укажите тип (Туре) создаваемого поля. Он, как правило, 
должен соответствовать типу того поля в таблице просмотра, которое вы хотите 
просматривать. В нашем примере вы хотите просматривать в таблице Dep поле 
Proizv, имеющее булев Tun. Для строк и некоторых других типов полей надо еще 
указать размер поля (Size). 


Рис. 9.45. w Field 
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После того, как вы определили новое поле, нажмите в группе радиокнопок 
Field type кнопку Lookup. Выберите в выпадающем списке Key Fields ключевое поле 
(или поля) в таблице, в которой вы создаете новое поле (Тае2). Это то поле или 
поля, по которым вы будете связываться с другой таблицей. В выпадающем списке 
Dataset выберите таблицу, которую вы хотите просматривать (Та еТ). Далее в вы- 
падающем спискеё Lookup Keys выберите ключевое поле (или поля) просматриваемой 
таблицы (в нашем примере поле Dep из Tablel). И, наконец, в выпадающем списке 
Result Field выберите просматриваемое поле (Proizv). Щелкните на OK. Вы вернетесь 
в Редактор Полей, в котором появится ваше новое поле Рго. Вам осталось задать 
для него в Инспекторе Объектов свойство DisplayLabel (заголовок), например, 
«Тип», и, поскольку это поле булево, задать свойство DisplayValues (отображае- 
мые значения для true и false), например, «произв.;управл.». 

Теперь в ваших компонентах визуализации данных, например, в DBGrid, поя- 
вится соответствующее поле (см. рис. 9.46). 


Рис. 9.46. 
Приложение с введенными полями 

‘Андрей  Анаре Цех2 
просмотра отдела и типа отдела АН < ее 
(после столбца «Отдел») ВО Борисов baler Bopacceie | 


Иванович =] произе. | 
Иванович 
Ивановна 


{ 
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Обратите внимание, что для введенного вами поля Рго в Инспекторе Объектов 
определены свойства FieldKind (с установленным значением fkLookup), Кеу- 
Fields, LookupDataset, LookupKeyField и LookupResultField. В принципе вы мог- 
ли бы задать все эти свойства непосредственно в Инспекторе Объектов, но исполь- 
зование Редактора`Полей более удобно. 

В разделе 9.7 говорилось, что для полей просмотра в DBGrid можно в свойстве 
Columns задать свойство ButtonStyle поля равным chsAuto и тогда при редактиро- 
вании данных автоматически будет появляться выпадающий список, из которого 
пользователь может выбирать соответствующее значение. В нашем примере хоро- 
шо было бы это сделать для поля с названием отдела. Но ведь такое поле уже есть и 
оно не просматриваемое. Как тут быть? Эту сложность можно обойти следующим 
образом. Введите так, как было рассказано ранее, новое поле просмотра, назвав 
его, например, DepLook и задав для него в окне рис. 9.45 значение Result Figld рав- 
ным Dep. Для вашего нового поля в Редакторе Полей задайте те же свойства (пре- 
жде всего — DisplayLabel), какие задавали ранее для поля Dep. А затем в свойстве 
Columns компонента DBGrid удалите поле Dep и вместо него вставьте в таблицу 
поле DepLook. Ваша таблица будет выглядеть так же, как и ранее. Но при редак- 
тировании отдела в какой-нибудь записи в соответствующей ячейке таблицы будет 
появляться выпадающий список с названиями отделов. На рис. 9.46 изображен 
именно такой момент, когда сотрудника Борисова переводят из цеха 1 в цех 2. 

Остановимся коротко еще на одном свойстве полей просмотра — Lookup- 
Cache. Это свойство определяет, будут ли значения просматриваемого поля кэши- 
роваться, или просмотр будет осуществляться при каждом изменении текущей за- 
писи. Если просматриваемая таблица (та, из которой берутся данные) не изменяет- 
ся или изменяется редко, лучше задать LookupCache = true. Это существенно со- 
кратит затраты времени на просмотр, который будет осуществляться не в таблице, 
а в кэше, загружаемом один раз при открытии базы данных. Ho если в процессе pa- 
боты просматриваемая таблица изменяется, а LookupCache = true, то результат 
просмотра может быть неверным. В этих случаях надо вызывать метод Re- 
freshLookupList, чтобы обновить хранящийся список. 

Поля просмотра определяются до расчета вычисляемых полей в той же записи. 
Поэтому их значения можно использовать в вычисляемых полях, но не наоборот. 

Поля просмотра имеют еще одну интересную особенность. Дело в том, что для 
них предусмотрены специальные компоненты: DBLookupListBox и DBLookup- 
ComboBox — список и выпадающий список. Если вы поместите на форму один из 
этих компонентов, установите у него свойство DataSource, соответствующее таб- 
лице, имеющей поля просмотра, а в свойстве DataField выберете одно из полей 
просмотра, то значения просматриваемого поля сразу отобразятся в списке. При 
этом не надо заботиться о загрузке в список значений, как это приходится делать 
со списками DBListBox и DBComboBox. 


9.11 Программирование работы с базами данных 


9.11.1 Состояние набора данных 


В рассмотренных ранее простых приложениях практически не требовалось 
программирование. Все сводилось к размещению на форме компонентов и заданию 
их свойств. Но более изощренные приложения все-таки требуют программирова- 
ния и написания различных обработчиков событий. 

Начнем рассмотрение вопросов программирования работы с базами данных с 
основного свойства State компонента типа TTable, определяющего состояние набо- 
ра данных. Это свойство доступно только во время выполнения и только для чте- 
ния. Набор данных может находиться в одном из следующих основных состояний: 
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К ОИ ОДЕТ ИДИ ИХ РИА, 


ОР 


dsInactive Набор данных закрыт, данные недоступны 


45Вгомзе Данные могут наблюдаться, HO не могут изменяться. Это состояние 
по умолчанию после открытия набора данных 


dsEdit Текущая запись может редактироваться 
dsInsert Может вставляться новая запись 


dsSetKey Доступен режим поиска записи и операция задания диапазона из- 
менений SetRange. Может наблюдаться только ограниченное MHO- 
жество данных и не может проводиться редактирование или встав- 
ка новой записи 


Состояния могут устанавливаться в приложении во время выполнения, но не 
непосредственно, а с использованием различных методов. 

Метод Close закрывает соединение с базой данных, устанавливая свойство 
Active набора данных в false. При этом State переводится в состояние dsInactive. 

Метод Ореп открывает соединение с базой данных, устанавливая свойство 
Active набора данных в true. При этом State переводится в состояние dsBrowse. 

Метод Edit переводит набор данных в состояние dsEdit. 

Методы Insert и InsertRecord вставляют новую пустую запись в набор дан- 
ных, выполняют еще ряд операций, о которых вы можете посмотреть в справке 
C++Builder, и переводят State в состояние dsInsert. 

Методы EditKey, SetRange, SetRangeStart, SetRangeEnd и ApplyRange, свя- 
занные с поиском записи и с заданием допустимого диапазона изменения данных, 
переводят State в состояние dsSetKey. Эти методы будут рассмотрены позднее. 

Многие другие методы также устанавливают автоматически различные со- 
стояния набора данных. При программировании работы с базой данных надо сле- 
дить за тем, чтобы набор данных вовремя был переведен в соответствующее состоя- 
ние. Например, если вы стали редактировать запись, не переведя предварительно 
набор данных в состояние dsEdit методом Edit, то будет сгенерировано исключение 
EDatabaseError с сообщением «Dataset not in edit or insert mode» — «Набор дан- 
ных He в режиме Edit или Insert». 


9.11.2 Пересылка записи в базу данных 


Пока идет редактирование текущей записи, изменения осуществляются в бу- 
фере, а не в самой базе данных. Пересылка записи в базу данных производится 
только при выполнении метода Post. Метод может вызываться только тогда, когда 
набор данных находится в состоянии dsEdit или dsInsert. Этот метод можно вызы- 
вать явно, например, Tablel->Post(). Но кроме того он вызывается неявно при лю- 
бых перемещениях по набору данных, т.е. при перемещении курсора на новую те- 
кущую запись, если набор данных находится в состоянии dsEdit или dsInsert. Or- 
менить изменения, внесенные в запись, можно методом Cancel. При выполнении 
этого метода, если предварительно не был вызван метод Post, запись возвращается 
к состоянию, предшествовавшему редактированию, и набор данных переводится в 
состояние dsBrowse. 

В ряде случаев плохо то, что метод Post вызывается неявно при перемещениях 
по базе данных. Пользователь может по ошибке сделать неверные исправления в 
какой-то записи и, переместившись на другую запись, невольно занести их в таб- 
лицу без какой-то предварительной проверки. Надо принимать меры, чтобы без 
проверки данных и без подтверждения пользователем в базу данных ничего не за- 
носилось. Это можно сделать, используя множество событий компонента Table. 


550 — и Глава 9 


Перед началом выполнения каждого из рассмотренных выше методов и после` 
его выполнения генерируются соответствующие события набора данных Table. 
Например, перед выполнением метода Post возникает событие BeforePost, а после 
его окончания — событие AfterPost. Аналогичные события Beforelnsert и АЁег- 
Insert сопровождают выполнения метода Insert и т.п. Подобные события и надо 
использовать для проверки данных и получения подтверждения на их изменение. 

Один из множества возможных вариантов заключается в использовании собы- 
тия BeforePost. Обработчик этого события может иметь вид: 


void _fastcall TForml::TablelBeforePost (TDataSet *DataSet) 
{ 


if (проверка введенных данных) 

{ 

if (Application->MessageBox ( 
"Хотите занести текущую запись в базу данных?", 
"Подтвердите занесение в базу данных", 
MB YESNOCANCEL + МВ ICONQUESTION) != IDYES) 


DataSet->Cancel (); 
Abort (); 
} 
} 


else 
4 
Application->MessageBox ("Ошибочные данные", "Ошибка", 
МВ ICONSTOP) ; 
Abort (); 


} 
} 


К этому обработчику будет происходить обращение перед выполнением метода 
Post, как бы он не был вызван: явно или вследствие перемещения по базе данных, 
если текущая запись была изменена. В обработчике сначала производится проверка 
данных в записи. Если она дает неудовлетворительный результат, то пользователю 
дается сообщение об ошибочности данных и выполняется функция Abort, преры- 
вающая выполнение Post. Текущая запись остается в состоянии dsEdit, но ошибоч- 
ные данные в ней не сбрасываются, что позволяет пользователю исправить их. 

Если проверка данных в записи показала их правильность, то у пользователя 
запрашивается подтверждение изменений в базе данных. Если он ответит отрица- 
тельно, TO для набора данных выполняется метод Cancel, а затем выполняется 
функция Abort. Cancel возвращает данные в текущей записи к состоянию, которое 
было до их редактирования, т.е. уничтожает результаты редактирования. В опера- 
торе Cancel использована ссылка DataSet. Это параметр, передаваемый в обработ- 
чик события BeforePost и соответствующий набору данных, к которому применя- 
ется Post. Использование параметра DataSet позволяет написать обработчик в бо- 
лее общем виде и к такому обработчику можно обращаться при событиях в разных 
наборах данных. Для конкретизации вместо DataSet можно было бы использовать 
имя конкретного набора данных, например, Tablel. 

Takum образом, приведенный выше обработчик события BeforePost позволяет 
предотвратить непроизвольное или ошибочное изменение данных. 

Часто безопасность данных обеспечивается несколько иначе: при переходе в 
режим редактирования данные из текущей записи переносятся в какие-то обыч- 
ные окна редактирования, не связанные с данными, там проводится их изменение 
и после того, как проведены все проверки и получено подтверждение пользователя 
на их сохранение, эти данные переносятся в таблицу. Но для выполнения подоб- 
ных операций необходимо иметь доступ к отдельным полям записи. Позднее мы 
посмотрим, как это можно делать. 
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9.11.3 Кэширование изменений 


По умолчанию все изменения в наборе данных, завершаемые методами Post, 
Insert, Delete и т.п., заносятся в базу данных. Однако, возможен и другой режим 
работы, при котором все изменения, вносимые пользователем в записи, кэшируют- 
ся — т.е. сохраняются в памяти локально. В этом случае пользователь работает не 
с реальными данными, а с их копиями. И только по специальной команде все вне- 
сенные пользователем изменения заносятся в базу данных. 

Режим кэширования определяется свойством CachedUpdates компонента 
Table. По умолчанию это свойство равно false и кэширование не производится. 
Если установить его в true, то все изменения набора данных будут кэшироваться. 
Они передаются в базу данных только после выполнения метода ApplyUpdates. 
Если же после множества изменений выполнить метод CancelUpdates, то все изме- 
нения, произведенные после последнего выполнения ApplyUpdates, отменяются. 

Метод ApplyUpdates только передает изменения в базу данных на сохранение, 
но еще не фиксирует изменения данных. Метод CommitUpdates, который должен 
выполняться после ApplyUpdates, очищает буфер кэша, после чего он готов для 
приема новой порции информации, а измененные данные фиксируются в базе дан- 
ных. Если при фиксации данных произошла ошибка, можно применить метод 
Rollback, который аннулирует все изменения. 

Проверьте все это, построив простое приложение, вид которого показан на 
рис. 9.47. Индикатор Кэширование переключает режим кэширования. Кнопка Фик- 
сация фиксирует все сделанные изменения в базе данных. Кнопка Отмена отменяет 
сделанные изменения. Когда приложение закрывается, надо проверить, не работа- 
ло ли оно в режиме кэширования и не было ли сделано изменений, которые не за- 
фиксированы в базе данных. Если были, то следует спросить пользователя о необ- 
ходимости их сохранения и при положительном ответе зафиксировать изменения. 

Коды этого приложения очень простые. Для таблицы Tablel свойство Cached- 
Updates первоначально надо задать равным true. В приложение можно ввести пе- 
ременную modif, которая будет фиксировать наличие несохраненных изменений: 


bool modif = false; 


Для события OnClick индикатора Кэширование надо предусмотреть обработчик: 


Tablel->CachedUpdates = ! Tablel->CachedUpdates; 
BApplyUpdates->Enabled = Tablel->CachedUpdates; 
BCancelUpdates->Enabled = Tablel->CachedUpdates; 
if (Tablel->CachedUpdates) modif = false; 


Puc. 9.47. 
Приложение, демонстрирующее 
кэширование данных 


Иванович 1950:м 
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Na Павел Павлович 1975 м _ 


Антонина Антоновна 1965 ж ‚|. 
Харитон  Харитонович 1962 my 


552 Глава 9 


Он изменяет режим кэширования таблицы, делает доступными или недоступ- 
ными в зависимости от режима кнопки Фиксация (ее имя — BApplyUpdates) и От- 
мена (ее имя — BCancelUpdates) и, если включается режим кэширования, то сбра- 
сывается в false значение modif. 

Для событий AfterEdit, AfterDelete и AfterInsert компонента Tablel можно 
предусмотреть обработчик: | 


if (Tablel->CachedUpdates) modif = true; 


который фиксирует в переменной modif факт редактирования, удаления или 
вставки записи. 
Обработчик события OnClick кнопки Фиксация имеет вид 
Tablel->ApplyUpdates (); 


Tablel->CommitUpdates (); 
modif = false; 


Обработчик события OnClick кнопки Отмена имеет вид 


Tablel->CancelUpdates (); 
modif = false; 


В обоих обработчиках переменная modif сбрасывает в false, фиксируя отсутст- 
вие несохраненных изменений. 
Обработчик события OnCloseQuery формы имеет вид: 


if (Tablel->CachedUpdates && modif) 
switch (Application->MessageBox ( 
"Сохранить изменения в базе данных?", 
"Подтвердите изменения", 
MB YESNOCANCEL + МВ ТСОМОЧЕЗТТОМ)) 
{ 


case IDYES: Tablel->ApplyUpdates (); 
break; 

case IDCANCEL: CanClose = false; 
break; 

case IDNO: Tablel->CancelUpdates(); 


} 


При наличии не сохраненных изменений пользователю задается вопрос «Co- 
хранить изменения в базе данных?». При положительном ответе изменения сохра- 
няются методом ApplyUpdates. При отрицательном — изменения отменяются ме- 
тодом CancelUpdates. Если при получении запроса пользователь нажал кнопку 
Отмена, то приложение не закрывается (CanClose задается равным false). 

Сделайте такое приложение и поработайте с ним, чтобы почувствовать разли- 
чие в работе при наличии и отсутствии кэширования. 


9.11.4 Доступ к полям 


Поля отображаются объектами класса TField и производных OT него классов 
TStringField, TSmallintField, TBooleanField и т.п. Эти объекты могут создаваться 
тремя способами: 

Ш Автоматически генерироваться для каждого компонента набора данных (ТаЪ- 
le и др.) 

Ш Создаваться в процессе проектирования с помощью Редактора Полей 

Ш Создаваться программно в процессе выполнения приложения 

Автоматическая генерация объектов класса TField происходит в момент OT- 
крытия базы данных, если эти объекты не создаются другими способами: в процес- 
се проектирования с помощью Редактора Полей или программно во время выпол- 
нения. Объекты генерируются для всех полей таблицы (это может быть избыточно 
для конкретного приложения). 
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Создание объектов полей в процессе проектирования с помощью Редактора 
Полей было рассмотрено ранее. Этот вариант исключает автоматическое создание 
объектов. Таким образом, все поля, объекты которых не созданы с помощью Ре- 
дактора Полей, недоступны для приложения. Использование Редактора Полей, 
как мы видели, очень удобно, так как позволяет задать в процессе проектирования 
множество полезных свойств для каждого поля. 

Программное создание объектов класса TField используется сравнительно 
редко и мы его рассматривать не будем. 

Доступ к объектам полей возможен тремя способами: 


Ш По порядковому индексу объекта 
Ш По имени поля 
Ш По имени объекта 


Доступ по _порядковому индексу осуществляется через свойство TField* 


Fieldsfint i], где i — индекс объекта. Индексация, как всегда в C++Builder, начи- 
нается с 0. Например, Tablel->Fields[0] - это первый объект поля таблицы Tablel. 
Доступ по имени поля осуществляется с помощью метода FieldByName(«uma»). 
Например, Tablel->FieldByName(«Fam») — это объект, связанный с полем Fam. 
| Доступ по имени объекта возможен только к объектам, созданным с помощью 
Редактора Полей. По умолчанию C++Builder формирует имена объектов полей 
(Маше) из имени таблицы и имени поля. Например, Тае1Юер. Вы можете видеть 
эти имена, работая с Редактором Полей. Конечно, вы можете изменить это имя на 
любое другое. Обращение к объекту по имени не требует, в отличие от предыдущих 
вариантов, ссылки на таблицу. Вы можете просто написать TablelDep и это будет 
необходимый вам объект. 

Автоматически создаваемые объекты имени не имеют — их свойство Name 
пусто. Поэтому для них обращение по имени невозможно. 

Среди рассмотренных способов доступа к полям наиболее быстрым, конечно, 
является доступ по имени объекта. Его недостатком является жесткая кодировка 
поля, к которому производится обращение. Если надо, чтобы строка кода в разных 
ситуациях обращалась к разным полям, то надо использовать или доступ по ин- 
дексу Fields[i] (тогда индекс i можно сделать переменным), или по имени поля ме- 
тодом FieldByName(s) (строку $ можно сделать переменной). 

Вы уже видели множество свойств объектов класса TField и производных OT 
них классов. Это свойства ReadOnly, DisplayLabel, CustomConstraint и многие 
другие. Сейчас рассмотрим, как добраться до главного свойства объекта — храня- 
щегося в нем значения поля текущей записи. 

Значение поля хранится в свойстве Value. Тип этого свойства — Variant, т.е 
тип определяется типом поля. Например, Tablel->FieldByName(«Fam»)->Value — 
это строка, a Tablel->FieldByName(«Year_b»)->Value — это целое число. 

Имеется также ряд свойств, переводящих один тип значений в другой. Напри- 
мер, свойство AsString переводит тип любого поля в строку при чтении значения 
поля, и осуществляет обратный перевод строки в тип поля при записи значения 
поля. Вы можете написать 

EDep->Text = Tablel->FieldByName ("Dep") ->AsString; 


EYear->Text = Tablel->FieldByName ("Year b")->AsString; 
ESex->Text = Tablel->FieldByName ("Sex") ->AsString; 


и в окна редактирования EDep, EYear и ESex будут занесены в текстовом виде 3Ha- 
чения в текущей записи полей Dep, Уеаг_Ъ и Sex, хотя поле Dep имеет тип строки, 
поле Year_b — целое значение, а поле Sex - булево. Если для поля Sex вы не задава- 
ли значений Display Values, то в окне редактирования ЕЗех будут отображены зна- 
чения «true» или «false». Если же вы задали значения свойства DisplayValues, на- 
пример «м;ж» или «мужск;уженск», то отобразятся именно эти заданные значения. 
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To же свойство AsString работает и как обратное преобразование типов. Про- 
должая предыдущий пример вы можете после того, как пользователь отредактиро- 
вал значения в полях редактирования EDep, EYear и ESex, внести эти значения в 
текущую запись, например, следующим кодом: 

Tablel->Edit (); 

Tablel->FieldByName ("Dep") ->AsString = EDep->Text; 

Tablel->FieldByName ("Year b")->AsString = EYear->Text; 

Tablel->FieldByName ("Sex") ->AsString = ESex->Text; 

Tablel->Post (); 


Для полей Уеаг_Ъ и Sex текст будет преобразован соответственно в целое и бу- 
лево значение. При этом не обязательно, чтобы пользователь в окне ЕЗех писал 
полностью обозначение пола сотрудника. Ему достаточно написать только первую 
букву: «t» или «Ё», если отображаемые значения true и false, и «м» или «ж», если 
отображаемые значения «мужск» и «женск». 

Описанный выше способ, заключающийся в использовании для ввода и ото- 
бражения данных компонентов (в этом примере — Edit), не связанных непосредст- 
венно с данными, — один из наиболее надежных для редактирования записи в базе 
данных. Прежде, чем вносить отредактированные данные в таблицу, вы можете их 
‚ всесторонне проверить, запросить у пользователя подтверждение записи и только 
после этого заносить изменения в базу данных. При этом вы в процессе редактиро- 
вания и проверки не связаны ни с какими событиями и состояниями базы данных. 

Помимо AsString имеются еще аналогичные свойства AsInteger, AsFloat, 
AsBoolean, AsDateTime. Свойство AsInteger осуществляет преобразования между 
типом данного поля и целым 32-битным числом, свойство AsFloat делает то же са- 
мое для действительных чисел с плавающей запятой, свойство AsBoolean — для 
булевых значений, свойство AsDateTime — для значений дат и времени в приня- 
том в C++Builder формате TDateTime. 

В некоторых случаях вам может потребоваться узнать тип данного поля. Вы 
можете это узнать из свойства объекта поля DataType, которое может принимать 
значения: ftUnknown (неизвестное), ftAutoInc (автоматически нарастающее), 
ftString (строка) и т.д. 


9.11.5 Методы навигации 


Наборы данных имеют ряд методов, позволяющих осуществлять навига- 
цию — перемещение по таблице: 


MOORE E IEG LG GOBER ONDE EER IEME ISS NEL SEER ES BEDS SLE E EMILE DEI RERSGEESEES EAE VEEL LEE LER IELDE DE LES LEER ELEDEE LBA YEE POLIO SE LOLE TS ELE LE RELIES PELE ELLER а BIG EE SLA EB PRESSES ELE SE REG! 


First Перемещение к первой записи 

Last Перемещение к последней записи 

Next Перемещение к следующей записи 

Prior Перемещение к предыдущей записи 

MoveTo(int i) Перемещение к концу (при 1>0) или к началу (УхР 1<0) Hai 
записей 


Любое перемещение по набору, находящемуся в состоянии dsEdit, автомати- 
чески вызывает метод Post, который пересылает текущую запись, если она была 
изменена, в базу данных. И после этого уже невозможно применить метод Cancel 
для уничтожения изменений. Поэтому надо принимать меры, чтобы в наборе дан- 
ных, находящемся в состоянии dsEdit, перед любым перемещением происходила 
проверка правильности данных (в разделе 9.11.2 было показано, как это можно 
сделать), или перемещаться по набору в каком-то другом состоянии (например, в 
dsBrowse). 
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При перемещениях можно совершить ошибку, выйдя за пределы имеющихся 
записей. Например, если вы находитесь на первой записи и выполняете метод 
Prior, то вы выйдете за начало таблицы, аесли вы находитесь на последней записи 
и выполняете метод Next, то вы окажетесь после последней записи. Чтобы контро- 
лировать начало и конец таблицы, существуют два свойства: Е оф (end-of-file) — ко- 
Hell данных, и Bof (beginning of file) — начало данных. Эти свойства становятся 
равными true, если делается попытка переместить курсор соответственно за преде- 
лы последней или первой записи, а также после выполнения методов соответствен- 
но Last и First. 

Приведем пример. Пусть в вашем приложении имеется выпадающий список с 
именем CBdep, который вы хотите заполнить данными, содержащимися в полях 
Dep всех записей таблицы, соединенной с компонентом Tablel. Это можно сделать 
следующим кодом: 

CBdep->Clear (); 

Tablel->First(); 

while (!Tablel->Eof) 


{ 
CBdep->Items->Add (TablelDep->AsString) ; 
Tablel->Next (); 


} 
CBdep->ItemIndex = 0; 
Tablel->First(); 


Первый оператор кода очищает список CBdep. Второй — устанавливает Kyp- 
сор таблицы на первую запись. Далее следует цикл по всем записям, пока не дос- 
тигнута последняя, что проверяется выражением Tablel->Eof. Для каждой записи 
в список заносится значение поля Dep, после чего методом Next курсор перемеща- 
ется к следующей записи. После окончания цикла индекс списка и курсор табли- 
цы переводятся соответственно на первую строку и запись. 


9.11.6 Поиск записей 


Одна из важнейших для пользователя операций с базами данных — поиск за- 
писей по некоторому ключу. Существует несколько методик поиска записей, кото- 
рые можно назвать SetKey, FindKey, Lookup и Locate. 

Начнем с методики SetKey. Для ее применения таблица предварительно 
должна быть индексирована по тому полю, по которому должен будет проводиться 
поиск. Затем таблица устанавливается в состояние поиска dsSetKey. Для этого ис- 
пользуется метод SetKey. В состоянии dsSetKey набор данных воспринимает по- 
следующий оператор присваивания значения полю не как присваивание, а как за- 
дание ключа поиска. Поэтому после установки состоянии dsSetKey оператором 
присваивания устанавливается требуемое значение ключа поиска по интересую- 
щему полю. В заключение методом GotoKey курсор переводится на запись, в кото- 
рой значение указанного поля равно ключу. Если таких записей несколько, то 
курсор переводится на первую из них. Если соответствующая запись не находится, 
то метод GotoKey возвращает false. Для полей типа строк лучше использовать не 
метод GotoKey, а метод GotoNearest. Этот метод перемещает курсор на первую за- 
пись, значение поля в которой максимально близко к ключу. Т.е. он сработает и 
тогда, когда совпадение не полное. Метод GotoNearest можно применять и к циф- 
ровым полям. В этом случае он переместит курсор на первую запись, значение 
поля в которой больше или равно заданному значению ключа. 

Например, если вы хотите найти первую запись, в которой год рождения (поле 
Year_b) равен заданному пользователем в окне редактирования ЕУеаг, вы можете 
написать операторы: 


Tablel->IndexFieldNames = "Year b"; 
Tablel->SetKey (); 
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Tablel->FieldByName ("Year b")->AsString = EYear->Text; 
if (! Tablel->GotoKey ()) 
ShowMessage ("Запись не найдена"); 


Первый оператор индексирует набор данных по полю Year_b, второй переводит 
набор данных в состояние dsSetKey, третий задает ключ поиска, а четвертый осу- 
ществляет переход к соответствующей записи или сообщает об отсутствии такой 
записи. 

Если вы хотите найти в таблице сотрудника по его фамилии, заданной пользо- 
вателем в окне редактирование EFam, вы можете выполнить код: 

Tablel->IndexFieldNames = "Fam"; 

Tablel->SetKey(); 


Tablel->FieldByName ("Fam") ->AsString = EFam->Text; 
Tablel->GotoNearest (); 


Даже если точно такой фамилии не найдется, курсор перейдет на наиболее по- 
_ хожую (совпадающую по первым символам). 

Методика поиска FindKey еще богаче по своим возможностям. В этой методи- 
ке таблица также должна быть проиндексирована по тем ключевым полям, по ко- 
торым осуществляется поиск. Функция FindKey определена следующим образом: 


bool _fastcall FindKey(const System::TVarRec * KeyValues, 
const int KeyValues Size); 


Параметр KeyValues представляет собой открытый массив: разделяемый 3a- 
пятыми список значений полей, по которым индексирован набор данных, в той по- 
следовательности, в которой они входят в индекс. При этом не обязательно пере- 
числять все поля — достаточно перечислить первое или несколько первых. Пара- 
метр KeyValues_Size определяет индекс последнего поля в массиве, участвующего 
в поиске. Поскольку индексы начинаются с 0, то KeyValues_Size на единицу 
меньше количества полей, участвующих в поиске. 

Вместо FindKey для полей строкового типа можно использовать аналогичный 
метод FindNearest, обеспечивающий переход к наиболее совпадающей строке, 
если полного совпадения не получено. Объявление и параметры этого метода те 
же, что и в методе FindKey. Метод FindNearest можно применять и к цифровым 
полям. В этом случае он переместит курсор на первую запись, значение полей в ко- 
торой больше или равны заданных значений ключей. 

Для методов FindKey и FindNearest удобно применять макрос OPENARRAY, 
создающий временный открытый массив и определяющий его размер: 


OPENARRAY (TVarRec, (список ключей) ) 


Макрос ОРЕМАВВАУ может воспринимать список, включающий до 19 эле- 
ментов, разделенных запятыми. 

Рассмотрим примеры. Пусть мы хотим выполнить тот же поиск по фамилии, 
что и приведенный выше. В данном случае соответствующий код может иметь вид: 


Tablel->IndexFieldNames = "Fam"; 
Tablel->FindNearest (&TVarRec (EFam->Text) ,0); 


Если мы хотим выполнить аналогичный поиск, HO нас интересует не просто 
один из сотрудников с заданной фамилией, а работающий в конкретном подразде- 
лении, заданном пользователем в окне редактирования EDep, то поиск можно осу- 
ществить с помощью макроса ОРЕМАККАУ следующим образом: 


Tablel->IndexFieldNames = "Бер; Гат"; 
Tablel->FindNearest (OPENARRAY (ТУагВес, (EDep->Text, EFam->Text) )); 


Первый оператор индексирует таблицу по полям Dep и Fam, a второй задает 
ключи для этих полей. Конечно, не надо индексировать таблицу каждый раз перед 
осуществлением поиска. Достаточно выполнить это один раз. 
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Приведем еще один пример. Пусть мы хотим предоставить пользователю уско- 
ренный поиск фамилии. Пользователь будет набирать фамилию в окне EFam и при 
вводе каждого нового символа курсор должен перемещаться на запись, наиболее 
близко совпадающую с уже введенными символами. Для этого сначала надо ин- 
дексировать таблицу по полю Fam. А затем достаточно в событие OnChange окна 
редактирования EFam вставить обработчик 


Tablel->FindNearest (&TVarRec (EFam->Text) ,0); 


Теперь остановимся на методе Locate. Этот метод объявлен следующим обра- 
зом: . 
bool _fastcall Locate(const System::AnsiString KeyFields, 


const System::Variant &KeyValues, 
TLocateOptions Options) ; 


В качестве первого параметра KeyFields передается строка, содержащая спи- 
сок ключевых полей. В качестве второго параметра передается KeyValues — мас- 
CHB ключевых значений. А третий параметр Options является множеством опций, 
элементами которого могут быть loCaseInsensitive — нечувствительность поиска к 
регистру, в котором введены символы, и loPartialKey — допустимость частичного 
совпадения. Метод возвращает false, если искомая запись не найдена. 

В простейшем случае применение Locate отличается от рассмотренных ранее 
методов только отсутствием необходимости индексировать набор данных опреде- 
ленным образом. Например, поиск (в том числе и рассмотренный выше ускорен- 
ный поиск) по фамилии может осуществляться операторами 

TLocateOptions SearchOptions; 


SearchOptions << loPartialKey << loCaseInsensitive; 
Tablel->Locate ("Fam",EFam->Text, SearchOptions) ; 


причем он будет работать независимо от того, как индексирована база данных. 
Впрочем, если набор данных соответствующим образом индексирован, то поиск 
производится быстрее. 
Приведенный код можно сократить до двух операторов: 
TLocateOptions SearchOptions; 


Tablel->Locate("Fam", EFam->Text, 
SearchOptions<<loPartialKey<<loCaseInsensitive) ; 


При поиске по нескольким полям можно воспользоваться функцией 
VarArrayOf, которая формирует тип Variant из задаваемого ей массива парамет- 
ров любого типа. Например, рассмотренный ранее поиск по отделу и ии MO- 
жет быть осуществлен операторами ’ 

TLocateOptions SearchOptions; 

Variant locvalues[] = {EDep->Text, EFam->Text}; 


Tablel->Locate("Dep;Fam", VarArrayOf (locvalues,1), 
SearchOptions<<loPartialKey<<loCaselInsensitive) ; 


И в заключение о последнем методе поиска — Lookup. Этот метод определен 
следующим образом: 
System::Variant _fastcall Lookup ( 
const System:: AnsiString KeyFields, 


const System::Variant &KeyValues, 
const System::AnsiString ResultFields) ; 


Первые два параметра аналогичны методу Locate. Третий параметр — строка, 
перечисляющая поля, значения которых возвращаются в виде массива Variant. 
Если не найдено соответствующей записи, функция возвращает false. 

Например, если вы хотите найти запись, относящуюся к сотруднику, фами- 
лия которого указана в окне EFam, и вывести в окно EDep название отдела, в кото- 
ром он работает, то эти операции можно осуществить следующим образом: 
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EDep->Text = Tablel->Lookup("Fam",EFam->Text, "Dep") ; 


Метод Lookup не изменяет положения курсора. Он только возвращает значе- 
ния указанных полей. Они могут использоваться любым способом. В частности, 
они могут использоваться вместо параметра KeyValues в другом операторе Lookup 
или Locate. Это открывает широкие возможности формирования сложных запро- 
сов по нескольким таблицам. 


9.11.7 Методы установки диапазона допустимых значений 


Ранее рассматривались различные способы задания критериев отбора установ- 
кой соответствующих значений свойств полей и наборов данных. Теперь рассмот- 
рим коротко несколько методов, позволяющих задавать диапазон допустимых зна- 
чений поля во время выполнения приложения. Метод SetRangeStart переводит 
набор данных в состояние dsSetKey и следующий оператор присваивания значе- 
ния полю воспринимается как задание для поля нижней границы диапазона воз- 
можных значений. Метод SetRangeEnd действует аналогично, но последующий 
оператор присваивания воспринимается как задание верхней границы диапазона. 
После того, как пределы диапазона установлены, можно выполнить метод Apply- 
Range. При этом начнут использоваться установленные границы диапазона и дос- 
тупными для просмотра и редактирования будут только те записи, в которых зна- 
чения указанного поля находятся внутри диапазона. 

Например, операторы 


Tablel->IndexFieldNames = "Fam"; 
Tablel->SetRangeStart () ; 
Tablel->FieldByName ("Fam") ->AsString = "A"; 
Tablel->SetRangeEnd(); 
Tablel->FieldByName("Fam")->AsString = "I"; 


Tablel->ApplyRange(); 


приведут к TOMY, что доступными будут только записи сотрудников, мани ко- 
торых начинаются с букв «А», «Б», «В». 

На результаты работы методов SetRangeStart и SetRangeEnd для числовых 
полей влияет свойство набора данных KeyExclusive. Оно определяет, будут ли счи- 
таться сами заданные границы входящими в диапазон (при KeyExclusive = false, 
это значение принято по умолчанию), или не входящими (при KeyExclusive = 
true). Иначе говоря, при KeyExclusive = false используются операции отношения 
i, J, а при KeyExclusive = true — >, <. Например, если вы хотите отобрать записи, 
в которых год рождения сотрудников лежит в определенных пределах, то при коде 


Tablel->IndexFieldNames = "Year b"; 
Tablel->SetRangeStart (); 


Tablel->FieldByName ("Year b")->AsInteger = 1950; 
Tablel->SetRangeEnd(); 
Tablel->FieldByName ("Year b")->AsInteger = 1960; 


Tablel->ApplyRange (); 
будут отобраны записи, в которых год рождения лежит в пределах 1950 — 1960, 
включая годы 1950 и 1960. А при коде 


Tablel->IndexFieldNames = "Year b"; 
Tablel->SetRangeStart(); 


Tablel->FieldByName ("Year _b")->AsInteger = 1950; 
Tablel->KeyExclusive = true; 
Tablel->SetRangeEnd(); 
Tablel->FieldByName ("Year b")->AsInteger = 1960; 


Tablel->ApplyRange (); | 
записи, соответствующие 1950 году, не войдут в число отобранных. 
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Имеется и более простой способ установки диапазона — метод SetRange. Он 
определен следующим образом: 
void _fastcall SetRange(const System::TVarRec * StartValues, 
const int нах Size, 


const System: TVarRec * EndValues, 
const int EndValues Size) ; 


Открытые массивы Start Values и EndValues должны содержать соответствен- 
но нижние и верхние значения диапазонов полей, являющихся ключевыми. Та- 
ким образом, метод SetRange заменяет последовательное обращение к методам 
SetRangeStart, SetRangeEnd и ApplyRange. Например, приведенные ранее опе- 
раторы, задающие диапазон фамилий в отобранных записях, могут быть заменены 
следующими: 

Tablel->IndexFieldNames = "Fam"; 

Tablel->SetRange (&TVarRec("A"),0, &TVarRec("I'") , 0); 


Можно, конечно, использовать и другие способы работы с открытыми масси- 
вами типа TVarRec (в частности, макрос OPENARRAY), рассмотренные в разде- 
ле 9.11.6. 

Если вы хотите работать не просто со всеми сотрудниками, фамилии которых 
начинаются на «А» — «В», а с теми из них, которые работают в цехе 1, то приве- 
денные выше операторы можно изменить следующим образом: 

Tablel->IndexFieldNames = "Бер; Гам"; 

Tablel->SetRange (OPENARRAY (TVarRec, ("Цех 1","A")), 

OPENARRAY (TVarRec, ("Цех 1","I'"))); 


9.11.8 Методы модификации таблиц 


Помимо рассмотренных ранее методов модификации записей Table имеет так- 
же ряд методов, позволяющих модифицировать таблицы и индексы. Коротко пере- 
числим некоторые из них. 
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‘CreateTable ~ Meron создает новую таблицу, исходя из установок компонен-_ 
та Table, содержащихся в свойствах Fields или FieldDefs. 
Если таблица с именем, указанным в свойстве TableName 
уже имеется, она будет переписана. Применение этого метода 
позволяет, например, взять структуру существующей табли- 
цы, как-то изменить ее, затем изменить свойство Та еМате 
на имя новой таблицы и создать эту таблицу 


DeleteTable Метод уничтожает существующую таблицу, которая задана 
свойствами DatabaseName и Та ]еМаше. Таблицу надо пред- 
варительно закрыть 


RenameTable(s) Метод переименовывает существующую таблицу, присваивая 
ей новое имя, содержащееся в $. Одновременно переименовы- 
ваются все сопутствующие таблице файлы 


DeleteIndex(s) Удаляет вторичный индекс с именем $ из таблицы 


Ниже в качестве примера приведен код, создающий используемую в данной 
книге таблицу Dep. Предполагается, что в приложении имеется компонент Tablel, 
связанный с базой данных, в которой создается таблица. 

// Компонент Tablel делается неактивным 


Tablel->Active = False; 
// Указывается имя таблицы 
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Tablel->TableName = "Dep.db"; 

// Таблица содается, если в базе данных нет такой таблицы 
if(! Tablel->Exists) 

{ 

// Указывается тип таблицы 

Tablel->TableType = ttParadox; 

// Начало описания полей таблицы 
Tablel->FieldDefs->Clear(); 

// Создается указатель на объект описания поля 
TFieldDef *pNewDef = Tablel->FieldDefs->AddFieldDef (); 
// Описание первого поля 


pNewDef->Name = "Dep"; 
PNewDef->DataType = ftString; 
pNewDef->Size = 20; 
pNewDef->Required = True; 


// Описание второго поля 

pNewDef = Tablel->FieldDefs->AddFieldDef (); 
pNewDef->Name = "Proisv"; 
pNewDef->DataType = ftBoolean; 


// Описание индекса 
Tablel->IndexDefs->Clear(); 
// Индекс без имени - первичный ключ таблицы 
Tablel->IndexDefs->Add("", "Бер", 
TindexOptions() <<ixPrimary << ixUnique); 


// Создание таблицы методом CreateTable 
Tablel->CreateTable(); 

Tablel->Open (); 

// Вставка первой записи 

Tablel->Insert(); 

Tablel->FieldByName ("Dep")->AsString = "Бухгалтерия"; 
Tablel->FieldByName ("Proisv")->AsBoolean = false; 
Tablel->Post(); 


9.11.9 Модули данных 


При разработке сложных приложений, работающих с базами данных, приня- 
то разделять логику работы и пользовательский интерфейс. В C++Builder это no- 
могают сделать модули данных — компоненты контейнеры типа TDataModule. 

В C++Builder 5 для проектирования модулей данных появился очень удобный 
инструмент — Проектировщик Модулей Данных (Data Module Designer). Он вызыва- 
ется командой Не | New и выбором в окне Депозитария на странице New пиктограммы 
Data Module. В результате открывается диалоговое окно, представленное на рис. 9.48 
и 9.49. В левой панели по мере проектирования модуля данных вы можете видеть де- 
рево помещенных вами в модуль компонентов наборов и источников данных, их по- 
лей, ограничений и т.п. Правая панель содержит две страницы: Components — компо- 
ненты (рис. 9.48), и Data Diagram — диаграмма данных (рис. 9.49). 

Перенос в модуль новых компонентов осуществляется щелчком на соответст- 
вующей пиктограмме палитры библиотеки компонентов и последующим щелчком 
в левой панели Проектировщика Модулей Данных или на его странице 
Components. В результате в дереве и на странице Components появляются соответст- 
венно вершина дерева и пиктограмма компонента. 

В дереве или на странице Components вы можете получить доступ к любому 
компоненту или его полю. Выделив в дереве вершину какого-то компонента, на- 
пример, таблицы Table (на рис. 9.48 и 9.49 компоненты Table названы TDep и 
TPers), вы увидите в Инспекторе объектов свойства и события этого компонента. 
Щелкнув на вершине компонента Table правой кнопкой мыши, вы можете вы- 
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брать BO всплывшем меню раздел Fields Editor — вызов Редактора Полей, и Explore — 
вызов SQL Explorer. Таким образом, вы можете выполнять манипуляции с поля- 
ми, не покидая Проектировщик Модулей Данных. 

Если вы щелкнете правой кнопкой мыши на вершине полей Fields, вы увидите 
другое контекстное меню, в котором можете выбрать разделы Add fields — добавить 
поля, Add all fields — добавить все поля, New field — создание нового поля, например, 
вычисляемого. Так что вы можете непосредственно из окна Проектировщика Моду- 
лей Данных выполнять основные команды Редактора Полей. Впрочем, и из этого 
контекстного меню вы можете вызвать непосредственно Редактор Полей командой 
Fields Editor. Выделив в дереве вершину какого-то поля, вы увидите в Инспекторе 
Объектов его свойства и события. Таким образом, все проектирование модуля дан- 
ных и его компонентов осуществляется очень удсбно и наглядно. 

Вы можете перетаскивать в дереве вершины, изменяя таким образом инфор- 
мационные связи между компонентами. Например, вы можете перетащить верши- 
ны компонентов DataSource (на рис. 9.48 и 9.40 они названы DSDep и DSPers) в 
ту или иную вершину набора данных, и они автоматически свяжутся с соответст- 
вующими компонентами, например, с Table. В их свойства DataSet при этом зане- 
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сутся соответствующие значения. Если же вы перетащите вершину источника дан- 
ных в корневую вершину дерева, то источник данных не будет связан ни с каким 
набором данных. 

Теперь рассмотрим страницу Data Diagram — диаграмма данных (рис. 9.49) 
правой панели Проектировщика Модулей Данных. На этой странице вы можете 
наглядно изобразить или спроектировать взаимоотношения между наборами дан- 
ных, полями, ограничениями и т.п. Сначала рассмотрим возможности изображе- 
ния связей, уже установленных между компонентами с помощью их свойств. Для 
этого достаточно перетащить мышью соответствующие вершины из панели дерева 
в правую панель. Связи между появившимися на панели блоками указываются ав- 
томатически. С помощью мыши вы можете разместить блоки должным образом на 
площади диаграммы и установить их размеры. Щелкнув на блоке правой кнопкой 
мыши, вы можете выбрать из контекстного меню раздел Color, позволяющий ме- 
нять цвет фона компонента. 

Если вы перетаскиваете из дерева вершину, имеющую дочерние вершины, и 
держите при этом нажатой клавишу Ctrl, то перетащатся и дочерние вершины, 
причем в диаграмме они расположатся по горизонтали. Если же при перетаскива- 
нии такой вершины вы держите нажатыми клавиши Ctrl и Shift, то вершины распо- 
ложатся друг под другом. | 

В блоках, соответствующих наборам данных, вы можете видеть в правом верх- 
нем углу пиктограммы с символом «-». Нажимая их вы можете сворачивать бло- 
ки, оставляя в них только заголовки, и разворачивать, в результате чего будут 
видны списки полей, введенных вами в Редакторе Полей (на рис. 9.49 блоки раз- 
вернуты). 

Изображения связей, возникающих на диаграмме, различаются в зависимо- 
сти от типа связи. Первый тип связей указывает на соотношения между дочерни- 
ми и родительскими блоками. Они изображаются контурными стрелками, идущи- 
ми от дочернего блока к родительскому. На рис. 9.49 вы можете видеть подобные 
стрелки от полей к набору данных, от наборов данных к блоку базы данных и от 
базы данных к вершине Session. Эти типы связей отображают соотношения между 
родительскими и дочерними вершинами дерева и отображаются на диаграмме ав- 
томатически. Удалить их с диаграммы невозможно. 

Второй тип связей обусловлен заданием тех или иных свойств компонентов. 
Такая связь отображается закрашенной стрелкой, около которой появляется над- 
пись с именем свойства, посредством которого установлена связь. На рис. 9.49 вы 
можете видеть такие связи, входящие и выходящие из блока DSDep. Связь, около 
которой написано «DataSet», отображает связь между источником данных и набо- 
ром данных, осуществленную свойством DataSet. А связь, около которой написа- 
но «MasterSource», отображает связь через свойство MasterSource вспомогатель- 
ной таблицы TPers с главной таблицей TDep. 

Если вы щелкнете на связи, основанной на значении свойства, правой кноп- 
кой мыши, то можете выбрать из всплывшего меню раздел Remove Relationship — 
удалить связь. В результате связь разорвется и значение соответствующего свойст- 
ва компонента очистится. Далее вы можете прямо на диаграмме построить вместо 
уничтоженной связи другую. Но об этом подробнее будет сказано ниже при рас- 
смотрении способов проектирования модуля данных с помощью диаграммы. 

Третий вид связей отображает связь главной таблицы со вспомогательной. На 
рис. 9.49 вы можете видеть такую связь, идущую из блока вспомогательной табли- 
цы TPers в блок главной таблицы TDep. Около связи автоматически пишутся име- 
на полей, по которым осуществляется связь (на рис. 9.49 это поле Dep). Связь 
главной и вспомогательной таблицы можно разорвать приемом, аналогичным опи- 
санному для связей через свойства. 
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Четвертый вид связей отображает связь наборов данных через поля просмотра 
(см. раздел 9.10.2). На рис. 9.49 это связь между ТРег$ и TDep, на которой схема- 
тически изображен глаз и около которой написано имя результирующего поля 
просмотра — TPersPro. Подобные связи можно разрывать так же, как описанные 
выше. 

Местоположение и форму любой линии связи можно изменять. Если вы потя- 
нете курсором за один из концов связи, то можете переместить его, правда, в боль- 
шинстве случаев не непрерывно, а дискретно. А если вы потянете за какую-то из 
средних точек линии, то линия получит излом, который вы можете переместить в 
нужное место. 

Мы рассмотрели блоки, отображающие вершины дерева. Помимо этого вы 
сами можете создавать блоки комментариев. Для этого надо нажать быструю кноп- 
Ky Comment block (вторая снизу на рис. 9.49). Она позволит добавить на диаграмму 
поясняющие надписи (см. надпись вверху диаграммы на рис. 9.49). Нажатие кноп- 
ки Comment Allude (первая снизу) позволяет вам провести линию связи между лю- 
быми блоками, в частности, от блока комментария к одному из других блоков. Эти 
линии связи чисто иллюстративные и не имеют отношения к информационным 
связям. На рис. 9.49 подобные связи проведены от слов «Dep» и «Pers» в блоке 
комментария к соответствующим блокам наборов данных. Щелкнув правой кноп- 
кой мыши на подобной связи, вы можете во всплывшем меню выбрать изображе- 
ния, помещаемые в начале линии (раздел Starts With) и вее конце (раздел Ends With). 

Если у вас на рисунке блоки или связи перекрывают друг друга, вы можете 
менять их видимость, щелкнув правой кнопкой мыши и выбрав в контекстном 
меню раздел Bring to front (перенести наверх) или Send to back (перенести вниз). 

Проектировщик Модулей Данных позволяет печатать сформированное дерево 
или диаграмму данных. Для печати выделите нужную панель и выполните коман- 
ду File | Print или щелкните правой кнопкой мыши и выберите в контекстном меню 
раздел Print. Учтите, что печать текстов осуществляется в графическом режиме. 
Так что если возникают проблемы с печатью, проверьте, доступна ли в установке 
принтера опция Печать текста кок графики (Print Text аз Graphics). | 

Мы рассмотрели Проектировщик Модулей Данных только как средство ото- 
бражения и документирования информационных связей. Но в действительности 
возможности этого инструмента гораздо шире. Он позволяет визуально проектиро- 
вать связи в модуле данных. Рассмотрим, как. это можно делать, на следующем 
примере. 

Пусть мы хотим спроектировать модуль данных, содержащий два набора дан- 
ных базы данных dbP: главный, связанный с таблицей Dep, и вспомогательный, 
связанный с таблицей Pers. Связь должна осуществляться по полям Dep, содержа- 
щимся в обеих таблицах (см. раздел 9.10.1). Кроме того во втором наборе данных 
мы хотим ввести поле просмотра Pro, содержащее данные поля Proisv из таблицы 
Оер (см. раздел 9.10.2). 

Перенесите в окно Проектировщика Модулей Данных (в панель дерева или на 
страницу Components) два компонента набора данных Table. Задайте в них базу дан- 
ных (свойство DatabaseName) равным dbP, а имена таблиц (свойства TableName) 
задайте равным Dep в Tablel и Pers в Table2. Для второго набора данных Table2 за- 
дайте IndexName равным depfio или IndexFieldNames равным «Dep;Fam;Nam; 
Par». Это необходимо, чтобы в наборе данных Table2 в индексе. фигурировало поле 
Dep, которое потребуется для связи наборов данных друг с другом. 

Теперь можно приступать к визуальному проектированию связей компонен- 
тов с помощью диаграммы. Откройте в Проектировщике Модулей Данных панель 
диаграммы и перетащите на нее из дерева вершины, связанные с Та Ше1 и Table2. 
Нажмите кнопку Master Detail (вторая сверху — см. рис. 9.50), создающую связь 
типа Главная таблица — Вспомогательная таблица. Щелкните мышью на блоке, 
отображающем Tablel, и, не отпуская кнопку мыши, переместите курсор в блок, 
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отображающий Та е2. За курсором будет тянуться линия. В момент отпускания 
кнопки мыши над блоком Table2 появится диалоговое окно, рассмотренное ранее 
в разделе 9.10.1 (рис. 9.44). В этом окне вы должны указать, что хотите осущест- 
вить связь по полям Dep обеих таблиц. На диаграмме появится связь, отображаю- 
щая зависимость Главная таблица — Вспомогательная таблица (рис. 9.50). Около 
связи будет написано имя поля (Dep), по которому осуществляется связь. Одновре- 
менно в дереве появится новый компонент — DataSourcel в вершине, связанной с 
Та е1. Если вы перетащите вершину DataSourcel на страницу Data Diagram, то 
увидите, что новый компонент осуществляет связь наборов данных с помощью сво- 
его свойства DataSet и свойства MasterSource компонента Table2. В Инспекторе 
Объектов вы можете увидеть, что в свойствах всех компонентов установились тре- 
буемые значения. 


Рис. 9.50. [ед DataModulel _ 
Пример проектирования > DataModule1 ; 
='.9§@, Default {Session} 
У A © р 5% ФР (Alias) | 
помощью диаграммы 85% ОЕРОВ {Tablet} + {| Г ОЕРОВ ЕО 


& Constraints Ro] | В (rabiet) EE пе. 
9, DataSourcel 1108 ee И О 
а FieldDefs Е se eas 
oy Fields 
; By IndexDefs 


Constraints al 
w§, DataSource2 
- 5 FieldDefs 


Теперь давайте введем в набор данных Table2 поле просмотра Pro. Нажмите 
на странице Data Diagram кнопку Lookup (третья снизу) и проведите курсором ли- 
нию от блока Та е2 к блоку Tablel. Перед вами откроется окно задания поля про- 
смотра (см. раздел 9.10.2, рис. 9.45). Задайте в нем ту же информацию, которая 
показана на рис. 9.45. В результате на диаграмме в блоке Та е2 появится имя вве- 
денного поля просмотра, а между блоками ТаЫе1 и Table2 появится линия связи. 
Правда, разместится она под введенной ранее связью, отображающей соотношение 
главной и вспомогательной таблиц. Чтобы получить изображение, подобное рис. 
9.50, можно щелкнуть правой кнопкой мыши на этой верхней связи и во всплыв- 
шем меню выбрать раздел Send to back. Тогда наверху окажется связь, определяе- 
мая полем просмотра. Далее можно курсором мыши потянуть ее за середину вверх 
и разместить так, как показано на рис. 9.50. 

Вам осталось только добавить в модуль источник данных DataSource2, свя- 
занный с Table2. Для этого надо щелкнуть на пиктограмме DataSource в палитре 
компонентов, а затем щелкнуть в панели дерева Проектировщика Модулей Дан- 
ных. Если при этом у вас будет выделена вершина Table2, то новый компонент ав- 
томатически свяжется с этим набором данных. Останется только перетащить его 
на диаграмму. Но если вы занесете источник в корневую вершину дерева, то он 
появится в дереве как самостоятельная вершина. Далее имеется две возможности 
связать ее с Table2. Можно в дереве перетащить эту вершину в вершину Table2. A 
можно сначала перетащить DataSource2 на диаграмму, нажать кнопку Property 
(первая сверху) и провести связь от блока DataSource2 к блоку Table2. Во всех Ba- 
риантах результат будет одинаковым — компонент DataSource2 сзяжется с набо- 
ром данных Table2 через свое свойство DataSet. 

Проектирование набора данных почти завершено. Осталось только выбрать в 
дереве или на диаграмме поочередно Tablel и Table2 и с помощью контекстного 
меню, как описывалось ранее, задать отображаемые поля наборов данных, свойст- 
ва этих полей, ограничения и вычисляемые поля, если все это требуется. 
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Из рассмотренного примера видно, что введенный в C++Builder 5 Проектиров- 
щик Модулей Данных является мощным и удобным инструментом визуального 
проектирования и документирования. Особенно, конечно, он удобен в задачах, 
значительно более сложных, чем рассмотренная выше, с множеством наборов и ис- 
точников данных и сложными связями между ними. 


9.12 Пример программирования работы 
с базой данных 


Попробуйте построить пример, использующий различные способы программи- 
рования работы с базами данных. Этот пример вы можете найти на прилагаемом к 
книге диске. Общий вид примера во время выполнения показан на рис. 9.51 и 9.52. 


Рис 9 51. |} + Йокальные БД 
Приложение работы с > ПОИСК СОТРУДНИКОВ ПО ПОДРАЗЕЛЕНИЯМ _ 
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Левая часть окна приложения предоставляет пользователю возможность про- 

сматривать список сотрудников NO подразделениям или во всех подразделениях 
сразу. 
Приложение содержит два компонента набора данных Tablel и Table2. Набор 
данных Tablel связан с таблицей Dep базы данных dbP. Это головная таблица при- 
ложения. С Tablel связан компонент источника данных DataSourcel. Набор дан- 
ных Table2 связан с таблицей Pers. Это вспомогательная таблица, связанная с 
Tablel. Поэтому в Table2 установлены свойства MasterSource = DataSourcel и 
MasterFields = Dep. С Table2 связан источник данных DataSource2, а с ним — 
компонент TDBGrid, названный Tpers. В этом компоненте отображается список 
сотрудников. 

Диалоговое окно Подразделение представляет собой выпадающий список — 
компонент типа TComboBox, названный СВФер. В него в момент создания формы 
загружаются значения полей таблицы Tablel, т.е. названия отделов. Последней 
строкой в список заносится строка «все отделы». При выборе пользователем этой 
строки в таблице Tpers должны отображаться сотрудники всех отделов. А при вы- 
боре пользователем в списке названия отдела в таблице Tpers должны отображать- 
ся только сотрудники выбранного отдела. 

В качестве окна редактирования Тип подразделения, отражающего характер 
подразделения, можно взять компонент DBEditl класса TDBEdit, соединенный с 
Tablel через источник данных DataSourcel и настроенный на поле Proisv. При 
выборе пользователем подразделения в списке CBdep в окне ОВЕЗИ1 должен ото- 
бражаться характер этого подразделения. 
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Посмотрим, как все это можно обеспечить. Обработчик события OnCreate фор- 
мы обеспечивает активизацию наборов данных и заполнение списка CBdep: 


Tablel->Active = true; 
Tablel->First(); 
CBdep->Clear(); 

while (!Tablel->Eof) 


{ 
CBdep->Items->Add (TablelDep->AsString) ; 
Tablel->Next (); 


} 

CBdep->Items->Add("Bce отделы"); 
CBdep->ItemiIndex = 0; 
Tablel->First(); 

Table2->Active = true; 


Этот код устанавливает курсор набора данных Tablel на первую запись, очи- 
щает список CBDep, а затем в цикле заносит в список все значения поля Dep из Ha- 
бора данных Та Ше1. Затем в список добавляется строка «все отделы», чтобы мож- 
но было в дальнейшем просматривать список сразу по всем отделам. После этого 
индекс списка устанавливается на первую строку, а курсор набора данных уста- 
навливается на первую запись. 

Теперь надо обеспечить управление головным набором данных Tablel co сто- 
роны списка CBDep. Для этого в обработчик его события OnChange вставляется 
код: | 

if (CBdep->ItemIndex == CBdep->Items->Count-1) 

{ 

Table2->MasterFields = ""; 
Table2->IndexFieldNames = "Fam;Nam; Par"; 
DBEditl->DataSource = NULL; 

} 


else 


{ 
Table2->MasterFields = "Dep"; 
Table2->IndexFieldNames = "Dep;Fam;Nam; Par"; 
Tablel->FindNearest (&TVarRec (CBdep->Text) ,0); 
DBEdit1l->DataSource = DataSourcel; 


} 

/* Передача фокуса таблице Tpers, иначе в ней 
не отразятся изменения */ 

TPers->SetFocus (); 


Если в списке выбрана последняя строка («все отделы»), связь таблиц Та е1 
и Table2 разрывается заданием пустого значения свойства MasterFields в таблице 
Table2. Разрывается связь окна DBEditl с источником данных. Таблица Та е2 
индексируется по алфавиту сотрудников. Последний оператор обработчика пере- 
дает фокус компоненту Трег$. Этот оператор необходим, так как без него не будет 
видно изменение в Tpers сразу после изменения в списке CBDep. 

Если в списке CBDep выбран один из отделов, TO восстанавливается связь 
Table2 и DBEditl с таблицей Tablel. Изменяется индексация вспомогательной 
таблицы Table2, чтобы в индекс входило ключевое поле Dep, по которому связаны 
таблицы. Методом FindNearest осуществляется поиск в Та Ше1 записи, соответст- 
вующей выбранному отделу. При изменении текущей записи набора данных 
Tablel автоматически изменяются данные, отображаемые в Tpers и DBEdit1. 

Теперь рассмотрим вспомогательные элементы левой страницы приложения. 
Индикатор Подразделение введен в приложение для того, чтобы при отображении 
полного списка сотрудников всех подразделений пользователь мог бы посмотреть, 
кто в каком отделе работает. Обработчик события OnClick индикатора имеет вид: 


Table2Dep->Visible = CheckBox1->Checked; 
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В зависимости от состояния индикатора этот оператор делает видимым или не- 
видимым столбец поля Dep в таблице. 

Внизу левой части окна приложения! расположен навигатор и кнопка Больше, 
которая делает видимой форму Еогт2, содержащую характеристику и фотогра- 
фию сотрудника. Эта форма уже рассматривалась выше в разделе 9.7 (см. 
рис. 9.41). 

Теперь перейдем к рассмотрению правой части окна приложения. Ее занимает 
двухстраничный компонент PageControll класса TPageControl. Страница Отбор. 
представлена на рис. 9.51. Фильтрация данных в несколько другом варианте уже 
была рассмотрена в разделе 9.5.5, где вы и можете посмотреть, как она осуществ- 
ляется. Окно Editl быстрого поиска фамилии имеет обработчик события OnChan- 
ge вида: 


if (CBdep->Text == "все отделы") | 
Table2->FindNearest (&TVarRec (Editl->Text),0); 
else 


{ 

TLocateOptions SearchOptions; 

Variant locvalues[] = {CBdep->Text, Editl->Text}; 

Table2->Locate ("Dep; Fam", VarArrayOf (locvalues,1), 
SearchOptions<<loPartialKey<<loCaseInsensitive) ; 


} 


Когда установлен режим «все отделы», поиск проводится методом FindNea- 
rest (это сделано просто для того, чтобы показать разные методы — можно было бы 
использовать и Locate). При этом в качестве ключа в метод передается содержимое 
окна Editl. В остальных вариантах (при заданном отделе) поиск осуществляется 


методом Locate, в который передается два параметра — отдел, указанный в 
CBdep->Text, и содержимое Editl->Text. 
Рассмотрим теперь вторую страницу компонента PageControll — страницу 


Правка, представленную на рис. 9.52. Эта страница предназначена для редактиро- 
вания текущей записи. В настоящем приложении такая страница, конечно, долж- 
на открываться, только если пользователь сообщил пароль, допускающий его к ре- 
дактированию базы данных. 


Рис. 9.52. 

Приложение работы с 
базами данных в режиме 
правки записи | 


`Борис Борисович 1937 


Ирина Ивановна 1971 
Nasea Павлович 1975 
| Щех1 Петров Петр Петрович 1960 


На этой странице пользователь может изменить значения полей текущей за- 
писи, например, перевести сотрудника из одного отдела в другой (именно этот мо- 
мент изображен на рисунке). Щелкнув на кнопке Больше, он может посмотреть и 
изменить характеристику сотрудника. Изменение фиксируется программой по 
значению свойства Modified компонента DBMemol, расположенного на дополни- 
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тельной форме (см. рис. 9.41), вызываемой этой кнопкой. На той же дополнитель- 
ной форме пользователь может изменить фотографию сотрудника, занеся изобра- 
жение из файла с этой фотографией в буфер Clipboard, а затем щелкнув на окне фо- 
тографии DBImagel и скопировав файл из Clipboard быстрыми клавишами Ctrl-V. 
Факт того, что пользователь изменил фотографию фиксируется по событию Оп- 
Click окна, содержащего ее изображение. Для этого в коде предусмотрена перемен- 
ная ChangePhoto, которая при щелчке на фотографии устанавливается в true. 
Все окна и другие компоненты отображения данных на странице Правка — 
_ обычные компоненты, не связанные с данными. Т.е. используются, например, 
компоненты Edit, а не DBEdit. Это позволяет развязать процесс редактирования 
информации и процесс пересылки ее в базу данных. В таблице TPers в левой части 
окна приложения задано в свойстве Options подсвойство dgEditing = false, что не 
‚ дает возможности пользователю непосредственно редактировать данные в таблице. 
В компоненты страницы Правка заносятся значения полей таблицы Table2 с 
помощью размещенного в обработчике события OnAfterScroll компонента Table2 
кода: 
if (PageControll->ActivePage == TabEdit) 
{ 
RGF->ItemIndex = 0; 
CBEDep->ItemIndex = 
CBEDep->Items->IndexOf (Table2Dep->AsString) ; 
EFam->Text = Table2Fam->AsString; 
ENam->Text Table2Nam->AsString; 
EPar->Text Table2Par->AsString; 
SEYear->Value = Table2Year b->AsInteger; 
if (Table2Sex->AsBoolean) 
RGSex->ItemiIndex = 0; 
else RGSex->ItemIndex = 1; 
} 


В этом коде следует обратить внимание на оператор 
СВЕБер->Тфетм1паех = CBEDep->Items->IndexOf (Table2Dep->AsString) ; 


I 


Почему он He записан проще: 
CBEDep->Text = Table2Dep->AsString; 


т.е. почему свойству выпадающего списка CBEDep->Text просто He присвоить зна- 
чение поля Dep? Дело в том, что в CBEDep установлено свойство Style = csDrop- 
DownList, которое исключает возможность для пользователя редактировать текст 
и тем самым указать, например, неверное название подразделения. Но при этом и 
программно невозможно присвоить значение свойству Text. Поэтому приходится с 
помощью метода IndexOf, присущего свойству CBEDep->Items (как любой пере- 
менной типа TStrings), искать индекс строки, текст которой совпадает со значени- 
ем поля, а затем присваивать этот индекс свойству CBEDep->ItemIndex. 

К приведенному выше коду осуществляется обращение при событии OnAfter- 
Scroll компонента Table2, т.е. после любого перемещения по набору данных Tab- 
le2. К, этому же коду осуществляется обращение при событии OnChange компонен- 
та PageControll, т.е. при переключении страницы. Только при переключении 
страницы к нему еще добавляется оператор 


Form2->DBMemol->ReadOnly = 
! (PageControll->ActivePage == TabEdit) ; 


который делает окно просмотра характеристики доступным или недоступным для 
редактирования в зависимости от того, какая страница открыта. 

Кнопка Записать осуществляет пересылку результатов редактирования в базу 
данных. Код обработчика ее события OnClick имеет вид: 
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AnsiString $; 
const .AfisiString: 81 =","; 


5=""; 


if (Table2Dep->AsString != CBEDep->Text) 
s = "отдел"; 

if (Table2Fam->AsString != EFam->Text) 

{ 
i. 48 ee ee eke 
s += " фамилию"; 


} 


if (Form2->DBMemol->Modi fied) 
{ 
if. (s t= °*) 3:38 4217 
s += " характеристику"; 
у 
if (ChangePhoto) 
{ 


a0. (Ae. ) 6.8? 
$ += " фотографию"; 
} 
a ia ТР 
if (Application->MessageBox ( 
("Действительно хотите изменить "+5+"?").с str(), 
"Подтвердите занесение в базу данных", 
MB YESNO + MB ICONQUESTION) == IDYES) 


Table2->Edit (); 
Table2Dep->AsString 
Table2Fam->AsString 
Table2Nam->AsString ENam->Text; 

Table2Par->AsString EPar->Text; 

Table2Year b->AsInteger = SEYear->Value; 

Table2Sex->AsBoolean = (RGSex->ItemIndex == 0); 

CanPost = true; 

Table2->Post (); 

CanPost = false; 

Form2->DBMemol->Modified = false; 

ChangePhoto=false; 

}; 

Первые операторы этого кода, данные с некоторым сокращением, формируют 
запрос пользователю типа «Действительно хотите изменить отдел, характеристи- 
ку?», в котором указано то, что пользователь изменил. При положительном ответе 
пользователя на этот запрос осуществляется пересылка данных из окон редактиро- 
вания в поля и выполняется метод Post. В заключение сбрасывается свойство 
Modified компонента отображения характеристики и переменная ChangePhoto, 
фиксирующая изменения фотографии. 

Перед вызовом метода Post и после этого вызова в коде вы можете видеть опе- 
раторы, изменяющие переменную CanPost. Что это за переменная и зачем она вве- 
дена в приложение? Дело в том, что надо предотвратить несанкционированную за- 
пись модифицированной характеристики через связанное с данными окно DBMe- 
“mol на форме Form2 или несанкционированную запись измененной фотографии 
через связанное с данными окно типа TDBImage на форме Form2 при случайном 
или намеренном перемещении пользователя по набору данных. Данные должны 
изменяться только после щелчка пользователя на кнопке Записать и положитель- 
ного ответа на запрос программы. Поэтому в обработчик события BeforePost ком- 
понента Table2 введен оператор 


CBEDep->Text; 
EFam->Text; 
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if (! CanPost) 

{ 
DataSet->Cancel (); 
Abort (); 

} 


Он прерывает запись данных, если переменная CanPost = false. Т.е. при пере- 
мещениях по таблице запись производиться не будет. A при щелчке на кнопке 30- 
писать перед вызовом Post переменная CanPost делается равной true и в этом слу- 
чае запись данных производится. 

Реализация кнопок Вставить и Удалить, которые позволяют соответственно вста- 
вить новую запись или удалить текущую запись, проблем не вызывает. В обработ- 
чике события OnClick кнопки Вставить выполняется метод Table2->Insert(), после 
чего в окна редактирования передаются значения полей по умолчанию. После их 
заполнения пользователь должен щелкнуть на копке Записать и внесенные данные 
будут занесены в таблицу Pers. 

Но для Toro, чтобы можно было вставить новую запись, необходимо выпол- 
нить одно условие: в набор данных Та Ше2 не должно передаваться поле Num. Это 
поле в базе данных задано как автоматически нарастающее и обязательно присут- 
ствующее в каждой записи. Если вы не включили это поле в набор данных Table2, 
то база данных сама даст ему уникальное значение. Если же вы включили это поле 
в набор данных Та Ше2, то при попытке выполнить метод Post вы получите сооб- 
щение о том, что значение этого поля не задано. А задать вы его не сможете, так 
как оно автоматически изменяемое. Поэтому вам не удастся включить вставлен- 
ную новую запись в базу данных. 

В обработчик события OnClick кнопки Удалить вставляется оператор 

if (Application->MessageBox ( 

"Действительно хотите удалить запись?", 
"Подтвердите удаление записи", 


MB УЕЗМО + MB ICONEXCLAMATION) == IDYES) 
Table2->Delete(); 


который после положительного ответа пользователя на вопрос программы удаляет 
текущую запись. 

Мы рассмотрели один из возможных примеров работы с базой данных. Под- 
робнее вы можете посмотреть этот пример на диске, прилагаемом к книге. Пользу- 
ясь сведениями о программировании работы с базами данных, изложенными ра- 
нее, вы, наверное, сможете сами спроектировать и более сложное, и более полезное 
для вас приложение. 


Создание приложений 
для работы с базами данных 
в сети 


10.1 Основы языка SQL и его использование 
в приложениях 


10.1.1 Общие сведения 


Язык SQL (Structured Query Language — язык структурированных запросов) 
был создан Microsoft в конце 70-ых годов и получил через некоторое время широ- 
кое распространение. Он позволяет формировать весьма сложные запросы к базам 
данных. Запрос — это вопрос к базе данных, возвращающий запись или множест- 
во записей, удовлетворяющих вопросу. | 

К сожалению, SQL в настоящее время недостаточно стандартизован. Сущест- 
вует стандарт SQL ANSI, но существует и множество диалектов, с которыми рабо- 
тают различные системы. Например, Sybase SQL Server и Microsoft SQL использу- 
ют синтаксис, существенно отличающийся от стандарта ANSI. InterBase, Oracle и 
многие другие серверы в основном придерживаются стандарта ANSI, но каждый 
разработчик вносит в него и свои усовершенствования. Ниже изложение будет ос- 
новываться на диалекте, принятом в локальном сервере InterBase, с которым мы 
позднее познакомимся. Впрочем, поскольку речь будет идти только об основных 
операторах языка, расхождение в их синтаксисе между различными диалектами 
невелико. А чтобы действительно изучить SQL, надо обратиться к документации 
той системы, с которой вы работаете. 

C++Builder позволяет приложению при помощи запросов SQL использовать 
данные: 


Ш Таблиц PARADOX и dBase — используется синтаксис локального SQL. 


Ш Локального сервера InterBase — полностью поддерживается соответствующий 
синтаксис. 


Ш Удаленных серверов SQL через драйверы SQL Links. 


Общие правила синтаксиса SQL очень просты. Язык SQL не чувствителен к ре- 
гистру, так что, например, рассмотренный ниже оператор Select можно писать и 
SELECT, и Select, и select. Если используется программа из нескольких операто- 
ров SQL, то в конце каждого оператора ставится точка с запятой «;». Впрочем, 
если вы используете всего один оператор, то точка с запятой в конце не обязатель- 
на. Комментарий может писаться и в стиле С: /*<комментарий>*/, а в некоторых 
системах и в стиле Pascal: {<комментарий>}. Вот, собственно, и все правила. 

В рамках данной книги невозможно рассмотреть все конструкции языка SQL. 
Мы остановимся только на самых распространенных. Более подробные сведения 
вы можете найти в книге [8]. 
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10.1.2 Оператор выбора Select 


10.1.2.1 Отбор записей из таблицы 


В этом разделе мы познакомимся с наиболее часто используемым оператором 
SQL — оператором выбора Select. Этот оператор возвращает одно или множество 
значений, которые могут представлять собой значения указанных полей записей, 
удовлетворяющих указанному условию и упорядоченных по заданному критерию. 

Хотя мы еще не рассматривали компонент C++Builder Query, специально 
предназначенный для выполнения запросов SQL, но при знакомстве с оператором 
Select полезно сразу пробовать записывать его в различных вариантах и смотреть 
получающиеся результаты. Поэтому откройте новое приложение C++Builder, пе- 
ренесите на форму компонент Query со страницы библиотеки Data Access и устано- 
вите его свойство DatabaseName равным dbP — базе данных Paradox, с которой 
мы имели дело в главе 9. В некоторых случаях полезно изменить этот псевдоним 
на ib — аналогичную базу данных InterBase. Обе базы данных содержатся Ha при- 
лагаемом к книге диске. Можете списать их оттуда и установить соответствующие 
псевдонимы (см. раздел 9.3). 

Поместите на форму компонент DataSource и в его свойстве DataSet задайте 
Оиегу1. Поместите также на форму компонент DBGrid и вего свойстве DataSource . 
задайте DataSourcel. 

Теперь ваше тестовое. приложение для экспериментов с языком SQL готово. 
Операторы SQL вы можете писать в свойстве SQL компонента Queryl, а чтобы уви- 
деть результаты выполнения написанного оператора, вам надо будет устанавли- 
вать значение свойства Active компонента Queryl в true. Это надо будет делать по- 
сле записи каждого нового оператора. 

Теперь начнем рассмотрение оператора Select. Одна из форм этого SReperape 
имеет синтаксис: 


SELECT <список имен полей> FROM <таблица> 
WHERE <условие отбора> ORDER BY <список имен полей>; 


Элементы оператора WHERE и ORDER ВУ не являются обязательными. Эле- 
мент WHERE определяет условие отбора записей: отбираются только те, в кото- 
рых условие выполняется. Элемент ORDER ВУ определяет упорядочивание воз- 
вращаемых записей. 

<таблица> — это не компонент Table, а именно та таблица базы данных, из 
которой осуществляется отбор, например, Pers. 

Начнем подробное рассмотрение данного оператора со списка полей после 
ключевого слова Select, содержащего имена тех полей таблицы, которые будут 
возвращены. Имена разделяются запятыми. Например, оператор 


SELECT Fam, Nam, Par, Year b FROM Pers } 


указывает, что следует вернуть поля Fam, Nam, Раги Year_b из таблицы Pers. За- 
пишите его в свойстве SQL компонента Queryl, установите значение свойства Ac- 
tive компонента Queryl в true и посмотрите результаты. 

Если указать вместо списка полей символ «*» — это будет означать, что требу- 
ется вернуть все поля. Например, оператор 


SELECT * FROM Pers 


означает выбор всех полей. 

В списке могут быть не только сами поля, но и любые выражения от них с 
арифметическими операциями +, -, *, /. После выражения может записываться 
псевдоним выражения в форме: AS <псевдоним>. В качестве псевдонима может 
фигурировать любой идентификатор, на который потом можно будет при необхо- 
димости ссылаться. Указанный псевдоним будет при отображении результатов фи- 
гурировать в заголовке таблицы. 
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Такими простыми средствами создаются аналоги вычисляемых полей, кото- 
рые при использовании компонента Table требовали гораздо больших усилий и на- 
писания обработчика события OnCalcFields. Впрочем, в обработчике можно было 
написать сколь угодно сложную программу вычисления, что в данном случае за- 
труднительно. Правда, как мы увидим позже, компонент Query, работающий в 
C++Builder с SQL, позволяет создавать вычисляемые поля и с помощью обработчи- 
ка события OnCalcFields. 

Приведем пример использования выражения: 


SELECT Fam, Nam, (2000-Year b) AS Age FROM Pers 


Этот оператор создает поле Age, вычисляемое по формуле (2000-Уеаг_Ъ). 

Теперь рассмотрим форму представления условия отбора, задаваемого после 
ключевого слова WHERE. Это условие определяет критерий, по которому отбира- 
ются записи. Оператор Select отбирает только те записи, в которых заданное усло- 
вие истинно. Условие может включать имена полей (кроме вычисляемых), KOH- 
станты, логические выражения, содержащие арифметические операции, логиче- 
ские операции and, or, not и операции отношения: 


ELLOS TALE LITE LES: RGSS x : MEMES BENGE LEO SLES LOE ILLICIT ELSE LESSEE EVE TEESE LEE SELL EL LEE LES SI ASE ES SRE LOSE PETES EEN EEE EEESI BEES AES LAE EGON НИИ НИЗА 


= paBHO 
> больше 

>= больше или равно 

< меньше 

<= меньше или равно 

|= не равно 

Like наличие заданной последовательности символов 
between ... and диапазон значений 

in соответствие элементу множества 


Первые шесть операций очевидны. Например, оператор 

SELECT Fam FROM Pers WHERE Sex=false and Year b > 1960 
‘отберет записи, относящиеся к женщинам, родившимся после 1960 года. 

Операция Like имеет синтаксис: 

<none> LIKE '<последовательность символов>' 

Эта операция применима к полям типа строк и возвращает true, если в строке 
встретился фрагмент, заданный в операции как <последовательность символов>. 
Заданным символам может предшествовать и их может завершать символ процен- 
та «%», который означает — любое количество любых символов. Если символ про- 


цента не указан, то заданная последовательность символов должна соответство- 
вать только целому слову. Например, условие 


Fam LIKE 'А%' 
означает, что будут отобраны все записи, начинающиеся с заглавной русской бук- 
вы «А» (операция Like различает строчные и прописные символы). Условию 

Fam LIKE 'Иванов%' 
будут удовлетворять фамилии «Иванов» и «Иванова», а условию 

Fam LIKE '%ван%"' 


кроме этих фамилий будет удовлетворять, например, фамилия «Иванников». 
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Операция between ... and имеет синтаксис: 


<полё> between <значение> and <значение> 


и задает для указанного поля диапазон отбираемых значений. Например, оператор 
SELECT Fam, Year b FROM Pers WHERE Year b BETWEEN 1960 AND 1970 
отберет записи сотрудников в заданном диапазоне возраста (включая граничные 


значения 1960 и 1970). 
Операция In имеет синтаксис: 


<поле> in (<множество>) 
И отбирает записи, в которых значение указанного поля является одним из элемен- 
тов указанного множества. Например, оператор 

SELECT Fam, Уеаг Ю FROM Pers WHERE Fam 1М№('Иванов', 'Петров', 'Сидоров') 


отберет записи сотрудников с заданными фамилиями, а оператор 
SELECT Fam, Year b FROM pers WHERE Year b IN(1950,1960) 


отберет записи сотрудников указанных годов рождения. 

Элемент оператора Select, начинающийся с ключевых слов ORDER ВУ, опре- 
деляет упорядочивание (сортировку) записей. После этих ключевых слов следует 
список полей, определяющих сортировку. Можно указывать только поля, фигури- 
рующие в списке отобранных (в списке после ключевого слова SELECT). Причем 
эти поля могут быть и вычисляемыми. 

Если в списке сортировки указано только одно поле, то сортировка произво- 
дится по умолчанию в порядке нарастания значений этого поля. Например, опера- 
тор 


SELECT Dep, Fam, Уеаг _b FROM Pers ORDER ВУ Year b 
задает упорядочивание возвращаемых значений по нарастанию года рождения. 


Если желательно располагать результаты по убыванию значений, то после имени 
поля добавляется ключевое слово DESC: 


SELECT Dep, Fam, Year Ю FROM Pers ORDER BY Year b DESC 
Если в списке после ORDER BY перечисляется несколько полей, то первое из 
них — главное и сортировка проводится прежде всего по значениям этого поля. За- 


писи, имеющие одинаковое значение первого поля упорядочиваются по значениям 
второго поля и т.д. Например, оператор 


SELECT Dep, Fam, Year b FROM Pers ORDER BY Dep, Fam 
сортирует записи прежде всего по отделам (значениям поля Dep), a внутри каждо- 
го отдела — по алфавиту. Оператор 
_ЗЕЬЕСТ Dep, Fam, Уеаг Ю, Sex FROM Pers ORDER BY Dep, Sex, Fam 


сортирует записи по отделам, полу и алфавиту. 


10.1.2.2 Совокупные характеристики 


Оператор Select позволяет возвращать не только множество значений полей, 
но и некоторые совокупные (агрегированные) характеристики, подсчитанные по 
всем или по указанным записям таблицы. Одна из функций, возвращающих такие 
совокупные характеристики, соип(<условие> ) — количество записей в таблице, 
удовлетворяющих заданным условиям. Например, оператор 


SELECT count(*) FROM Pers 


подсчитает полное количество записей в таблице Pers. А оператор 
SELECT count (*) FROM Pers WHERE ПБер='Цех 1' 


выдаст число записей сотрудников цеха 1. 
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Оператор, использующий ключевое слово DISTINCT (уникальный), выдаст 
число неповторяющихся значений в указанном поле. Например, оператор 


SELECT count (DISTINCT Dep) FROM Pers 


вернет число различных подразделений, упомянутых в поле Dep таблицы Pers. 

Функции пищ(<поле>), тах(<поле>), avg(<noje>), зит(<поле>) возвращают 
соответственно минимальное, максимальное, среднее и суммарное значения ука- 
занного поля. Например, оператор 


SELECT min(Year b), мах (Уеаг b), ауд (Уеаг b) FROM Pers ' 


вернет минимальное, максимальное и среднее значение года рождения, a оператор 


SELECT min(2000-Year b), мах (2000-Уеаг b), avg(2000-Year b) 
FROM Pers WHERE Dep='Byxrastepua ' 


выдаст вам аналогичные данные, HO относящиеся к возрасту сотрудников бухгал- 
терии. 

В операторе Select вы можете указывать не только суммарные характеристи- 
ки, но и любые выражения от них. Например, оператор 


SELECT 1999-(min(Year b)+max(Year_b))/2 FROM Pers 
WHERE Dep='Byxrantepua' 


выдаст моду (среднее между максимальным и минимальным значениями) возраста 
сотрудников бухгалтерии. Здесь надо обратить внимание на то, что оператор вер- 
нет округленное до целого значение моды, поскольку в выражении использованы 
только целые числа и поэтому осуществляется целочисленное деление. Если же вы 
в том же операторе замените делитель «2» на «2.», т.е. укажете его как действите- 
льное значение, то и результат будет представлен действительным числом. 

При использовании суммарных характеристик надо учитывать, что в списке 
возвращаемых значений после ключевого слова SELECT могут фигурировать или 
поля (в том числе вычисляемые), или совокупные характеристики, но не могут фи- 
гурировать и те, и другие (без указания на группирование данных, о чем будет ска- 
зано ниже). Это очевидно, так как оператор может возвращать или множество зна- 
чений полей записей, или суммарные характеристики по таблице, но не может 
возвращать эти несовместимые друг с другом данные. Поэтому нельзя, например, 
записать оператор 


SELECT Fam, max(Year b) FROM Pers 


в котором мы пытаемся определить фамилию самого молодого сотрудника. Впро- 
чем, эту задачу можно решить с помощью вложенных запросов, которые рассмот- 
рены ниже. 

Смешение в одном операторе полей и совокупных характеристик возможно, 
если использовать группировку записей, задаваемую ключевыми словами GROUP 
ВУ. После этих ключевых слов перечисляются все поля, входящие в список 
ЗЕГЕСТ. В этом случае смысл совокупных характеристик изменяется: они прово- 
дят вычисления не по всем записям таблицы, а по тем, которые соответствуют оди- 
наковым значениям указанных полей. Например, оператор 


SELECT Dep, count(*). FROM Pers GROUP ВУ Dep 
вернет таблицу, в которой будет 2 столбца: столбец с названиями отделов, и стол- 
бец, в котором будет отображено число сотрудников в каждом отделе: 

При группировании записей с помощью GROUP ВУ можно вводить условия 


отбора записей с помощью ключевого слова HAVING. Например, если переписать 
приведенный выше оператор следующим образом: 


SELECT Dep, count(*) FROM Pers GROUP ВУ Dep HAVING Dep <> "'Бухгалтерия' 
то в таблице будут строки, относящиеся KO всем отделам, кроме бухгалтерии. 
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Впрочем, не все базы данных поддерживают синтаксис HAVING. При исполь- 
зовании базы данных dbP (Paradox) компонент Query не работает с HAVING. Для 
базы данных InterBase никаких проблем с HAVING не возникает. 


10.1.2.3 Вложенные запросы 


Результаты, возвращаемые оператором Select, можно использовать в другом 
операторе Select. Причем это относится и к операторам, возвращающим совокуп- 
ные характеристики, и к операторам, возвращающим множество значений. На- 
пример, в предыдущем разделе нам не удалось узнать фамилию самого молодого 
сотрудника. Теперь это можно сделать с помощью вложенных запросов: 


SELECT Рам, Уеаг b FROM Pers 
WHERE Year b=(SELECT max(Year b) FROM Pers) 


В этом операторе второй вложенный оператор SELECT max(Year_b) FROM 
Pers возвращает максимальный год рождения, который используется в элементе 
WHERE основного оператора Select для поиска сотрудника (или сотрудников), 
чей год рождения совпадает с максимальным". 

Вложенные запросы могут обращаться к разным таблицам. Пусть, например, 
мы имеем две аналогичных по структуре таблицы Pers и Pers], относящиеся к раз- 
ным организациям, и хотим в таблице Pers найти всех однофамильцев сотрудни- 
ков другой организации. Чтобы проверить работу с несколькими таблицами, вы 
можете открыть в Database Desktop свою таблицу Pers, выполнить команду 
Table | Restructure, ничего не меняя в структуре, щелкнуть на кнопке Save as и сохра- 
нить ту же таблицу в том же каталоге, где была исходная таблица Pers, но под но- 
вым именем Pers|. Если хотите, можно в ней внести записи, отличные от таблицы 
Pers, чтобы эти таблицы чем-то различались. Впрочем, можно все это и не делать, 
заменив в приведенных ниже примерах таблицу Pers] таблицей Pers, т.е. работая с 
одной таблицей. Смысл операторов все равно будет понятен. 

Итак, вернемся к задаче определения всех однофамильцев в этих двух табли- 
цах. Это можно сделать оператором 


SELECT * FROM Pers WHERE Fam IN (SELECT Fam FROM Pers1) 


Вложенный оператор Select Fam from Рег$1 возвращает множество фамилий 
из таблицы Рег5|, а конструкция WHERE основного оператора Select отбирает из 
фамилий в таблице Pers те, которые имеются в множестве фамилий из Регз]. 

При работе в условии WHERE с множествами записей можно использовать 
ключевые слова: АП и Any. АП означает, что условие выполняется для всех запи- 
сей, а Апу — хотя бы для одной записи. Например, оператор 


SELECT * FROM Pers WHERE Year b >= ALL (SELECT Year b FROM Регз1) 


ищет сотрудников в Pers, которые He старше любого сотрудника в Persl. Кстати, 
если в этом операторе заменить Pers! на Pers, то получим список самых молодых CO- 
трудников организации, который мы получали ранее другим способом. А оператор 


SELECT * FROM Pers WHERE Year _b > ANY (SELECT Year _b FROM Pers1) 
ищет сотрудников в Pers, которые моложе хотя бы одного сотрудника в Pers]. 


10.1.2.4 Объединения таблиц 


В запросе можно объединить данные двух или более таблиц. Пусть, например, 
вы хотите получить список сотрудников всех производственных подразделений. В 
таблице Pers мы имеем список сотрудников с указанием в поле Dep подразделений, 
в которых они работают. А в таблице Dep мы имеем список всех подразделений в 
поле Dep и характеристику каждого подразделения в поле Prosv (true, если под- 
разделение производственное). Тогда получить список сотрудников всех производ- 
ственных подразделений можно оператором: 
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SELECT Pers.* FROM Pers, Dep 
WHERE (Pers.Dep=Dep.Dep) AND (Dep. Proisv=true) 9 


В нем мы обращаемся сразу к двум таблицам Pers и Dep, которые перечислены 
после ключевого слова ЕКОМ. Поэтому каждое имя поля предваряется ссылкой на 
таблицу, к которой оно относится. Впрочем, это надо делать только для полей, имя 
которых повторяется в разных таблицах (поле Dep). Перед полем Proisv ссылку Ha 
таблицу можно опустить. В конструкции WHERE условие Pers.Dep=Dep.Dep 
ищет запись в таблице Dep, в которой поле Dep совпадает с полем Dep текущей за- 
писи таблицы Pers. А условие Dep.Proisv=true отбирает те записи, в которых в таб- 
лице Dep найденному подразделению соответствует поле Proisv = true. 

В операторах, работающих с несколькими таблицами, обычно каждой таблице 
дается псевдоним, сокращающий ссылки на таблицы, а иногда придающий им неко- 
торый смысл, вытекающий из данного применения. Псевдоним таблицы может запи- 
сываться в списке таблиц после слова FROM, отделяясь от имени таблицы пробелом. 
Например, приведенный выше оператор может быть переписан следующим образом: 


SELECT Р.* FROM Pers Р, Dep D 
WHERE (P.Dep=D. Dep) AND(D.Proisv=true) 


В этом примере таблице Pers дан псевдоним P, а таблице Dep — О. Конечно, 
эти псевдонимы действуют только в данном операторе и не имеют никакого отно- 
шения к псевдонимам баз данных, которые мы постоянно используем. 

Возможно самообъединение таблицы. В этом случае одной таблице даются два 
псевдонима. Пусть, например, мы хотим найти всех ровесников в организации. 
Это можно сделать оператором 


SELECT pl.fam, p2.fam, р1.уеаг р FROM Pers pl, Pers p2 
WHERE (pl.year b = p2.year b) AND (pl.fam != p2.fam) 


В этом примере для таблицы Pers мы ввели два псевдонима: pl u p2. В конст- 
рукции WHERE мы ищем в этих якобы разных таблицах записи с одинаковым го- 
дом рождения. Второе условие pl.fam != p2.fam нужно, чтобы сотрудник He ото- 
бражался в результатах как ровесник сам себя. Правда, приведенный оператор вы- 
дает в результате по две записи на каждую пару ровесников, сначала, например, 
«Николаев — Андреев», а потом «Андреев — Николаев». Чтобы исключить такое 
дублирование можно добавить еще одно условие — pl.Fam < p2.Fam: 

SELECT pl.fam, p2.fam, р1.уеаг b FROM Pers pl, Pers p2 

WHERE: (pl.year b = p2.year b) AND (pl.fam != p2.fam) 
and(pl.Fam < p2.Fam) 


Дополнительное условие упорядочивает появление фамилий в pl и p2 и uc- 
ключает дублирование результатов. 

До сих пор мы рассматривали объединения, основанные на однозначном соот- 
ветствии записей двух таблиц, когда каждой записи в первой таблице находилась 
соответствующая ей запись во второй таблице. Возможны и другие виды объедине- 
ний, которые выдают записи независимо от того, есть ли соответствующее поле во 
второй таблице. Это внешние объединения (ошег join). Их три типа: левое, правое и 
полное. Левое объединение (обозначается ключевыми словами LEFT OUTER JOIN 
... ОМ) включает в результат все записи первой таблицы, даже Te, для которых не 
имеется соответствия во второй. Правое объединение (обозначается ключевыми 
словами RIGHT OUTER JOIN ... ОМ) включает в результат все записи второй таб- 
лицы, даже если им нет соответствия в записях первой. Полное объединение (обо- 
значается ключевыми словами FULL OUTER JOIN ... ОМ) включает в результат 
объединение записей обеих таблиц, независимо от их соответствия. 

Пусть, например, у вас есть таблица сотрудников некоей компании Pers и есть 
таблица Chef, в которой занесены данные на членов совета директоров этой компа- 
нии. В число членов совета входят и сотрудники компании, и посторонние лица. 
Для определенности положим, что в таблице Pers имеются записи на сотрудников 
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«Иванов» и «Петров», причем Петров является членом совета, а Иванов — нет. В 
табЛице Chef имеются записи на членов совета «Петров» и «Сидоров», причем Си- 
доров — не сотрудник компании. Тогда оператор 


SELECT * FROM Pers LEFT OUTER JOIN Chef ON Pers.Fam = Chef.Fam 


выдаст результат вида: 


ОО ИИА ЗАЕСООНТА oneal СЕ 
т 


Оператор задал левое объединение таблицы Pers (она указана после ключевого 
слова FROM) с таблицей Chef (она указана после ключевых слов LEFT OUTER 
JOIN). Условие объединения указано после ключевого слова ОМ и заключается в 
совпадении фамилий. 

Как показано, результат включает все поля и таблицы Pers, и таблицы Chef. 
Число строк соответствует числу записей таблицы Pers. В строках, относящихся к 
записям, для которых в Chef не нашлось соответствие, поля таблицы Chef остаются 
пустые. 

Оператор правого объединения 


SELECT * FROM Pers RIGHT OUTER JOIN Chef ON Pers.Fam = Chef.Fam 


выдаст результат вида: 


Поля таблицы Pers Поля таблицы Chef 
И ccd Пани с. ce POOR ae | 


Число строк соответствует числу записей таблицы Chef. В строках, относя- 
щихся к записям, для которых в Pers не нашлось соответствие, поля таблицы Pers 
остаются пустые. 

Оператор полного объединения 


SELECT * FROM Pers FULL OUTER JOIN Chef ОМ Pers.Fam = Chef.Fam 
выдаст результат вида: 


Поля таблицы Pers Поля таблицы Chef 
perpen 2500 oath aaiecosd (dd WS | emp Аи 


Сидоров 


— SS Е -——— - E А 


В нем к строкам, относящимся к таблице Pers, добавлены строки, относящиеся 
к таблице Chef, для которых не нашлось соответствия в таблице Pers. 


10.1.3 Операции с записями 


В этом и нескольких последующих разделах вы уже не сможете проверять 
операторы SQL с помощью вашего тестового приложения. Или обойдитесь пока без 
проверки, или посмотрите сначала раздел 10.3.3 и проверяйте операторы с помо- 
щью программы WISQL. Ges 
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Вставка новой записи в таблицу осуществляется оператором Insert, который 
может иметь вид: \ 


INSERT INTO <имя таблицы> (<список полей>) VALUES (<список значений>) 


В списке перечисляются только те поля, значения которых известны. Осталь- 
ные могут опускаться. Для пропущенных полей значения берутся по умолчанию 
(если значения по умолчанию заданы) или поля остаются пустыми. 

Например: 

INSERT INTO Pers (Fam, Nam, Par, Sex) 

VALUES ('UABaHosB', 'Андрей', 'Андреевич', true) 


В этом примере не указан год рождения. Он подставится по умолчанию и в 
дальнейшем может быть уточнен. 

Другая форма оператора Insert использует множество значений, возвращае- 
мых оператором Select. Этот оператор может выбирать записи из какой-то другой 
таблицы и вставлять их в данную. Синтаксис этой формы Insert : 


INSERT INTO <имя таблицы> <оператор Select> 


Пусть, например, вы создали таблицу Old Pers пожилых людей вашей органи- 
зации и хотите заполнить ее соответствующими записями из таблицы Pers. Это 
можно сделать одним оператором: 


INSERT INTO Old Pers SELECT * FROM Pers WHERE Year b < 1939 


Таблица Old Pers сразу заполнится множеством соответствующих записей из 
Pers. 

Приведенную форму оператора Insert можно использовать для копирования 
всех данных одной таблицы в другую, причем эти таблицы могут быть созданы 
разными СУБД. 

Редактирование записей осуществляется оператором Update: 


UPDATE <имя таблицы> SET <список вида <поле>=<выражение>> 
WHERE <условие> 


Наличие в этом операторе условия позволяет редактировать не только одну за- 
пись, но сразу множество их. Например, если при очередной реорганизации пред- 
приятия решили слить «Цех 1» и «Цех 2» в один «Цех 1», то исправление всех за- 
писей в таблице можно сделать одним оператором: | 


UPDATE Pers SET Dep = 'Цех 1' WHERE Dep = 'Цех 2' 


Удаление записей осуществляется оператором Delete: 

DELETE FROM <имя таблицы> WHERE <условие> 

Наличие в операторе условия позволяет удалять не только одну, но сразу мно- 
жество записей. Например, если при реорганизации предприятия подразделение 


«Цех 1» ликвидировали и всех его сотрудников уволили из штата данной органи- 
зации, то удалить из таблицы все соответствующие записи можно оператором: 


DELETE FROM Pers WHERE Dep = 'Цех 1' , 


10.1.4 Операции с таблицами 


Создание новой таблицы осуществляется оператором Create Table: 


CREATE TABLE <имя таблицы> (<список вида <имя поля> <тип> (<размер>) >) 


Размер указывается только для полей строковых и некоторых других типов. 
После объявления некоторых полей могут включаться слова PRIMARY KEY, что 
указывает на то, что данное поле входит в первичный ключ. Кроме того после объ- 
явления некоторых полей можно вставлять слова МОТ NULL, означающие, что 
значение этого поля обязательно должно быть задано в каждой записи. Например: 
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CREATE TABLE Person ( 

Fam char(15) NOT NULL PRIMARY KEY, 
Nam char(15) NOT NULL PRIMARY KEY, 
Par char(15) NOT NULL PRIMARY KEY, 
Year b integer 

) 

Приведенная форма оператора Create Table — простейшая. Более сложные 
формы позволяют задавать в таблице вычисляемые поля, значения по умолчанию, 
ограничения значений, связывать разные таблицы по ключам и многое другое. 
Подробнее это все рассмотрено в книге [8]. 

Удаление таблицы осуществляется оператором Drop Table: 


DROP TABLE <имя таблицы> 


Надо учесть, что удаление таблицы в корне отличается от удаления в ней всех 
записей. При удалении даже всех записей сама таблица (ее структура) остается, а 
оператор Drop Table полностью уничтожает таблицу. 


Модификация структуры существующей таблицы осуществляется оператором 
Alter Table: 


ALTER TABLE <имя таблицы> <действие> <имя поля> <тип DWAaAHHbIX> 


В этом операторе <действие> может принимать значения ADD — добавить но- 
вое поле, или DROP — удалить существующее поле. Если поле добавляется, то для 
него надо указывать <тип данных>. Если поле удаляется, то тип данных не указы- 
вается. Приведем пример оператора модификации структуры: 


ALTER TABLE Pers DROP Уеаг Ю, ADD Age integer 


10.1.5 Операции с индексами 


Индексы существенно ускоряют процесс поиска и' упорядочивания записей 
таблицы. Если в операторе Select содержится элемент упорядочивания ORDER BY 
и перечисляемые поля совпадают с определенными в индексе, упорядочивание бу- 
дет использовать этот индекс и произойдет с малыми затратами времени. В про- 
тивном случае индекс использоваться не будет и упорядочивание потребует боль- 
шего времени. | | 

Создание нового индекса осуществляется оператором Create Index: 


CREATE INDEX <имя индекса> ОМ «имя таблицы > <список полей> 


Например: 

CREATE INDEX depyear ON Pers Dep, Year b 

Удаление существующего индекса осуществляется оператором Drop Index: 
DROP INDEX <имя таблицы >.<имя индекса> 

Например: 

DROP Index Pers.depyear 


Если таблица многократно изменяется и в нее вносится много новых записей, 
индексы могут оказаться разбалансированы и их эффективность при выполнении 
запросов уменьшается. В этом случае полезно проводить повторное создание и ба- 
лансировку индекса последовательным применением операторов деактивации и 
активации: 


ALTER INDEX <имя индекса> DEACTIVATE 
ALTER INDEX <имя индекса> ACTIVATE 
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10.1.6 Компонент Query 


10.1.6.1 Общие сведения 


Мы рассмотрели основные операторы SQL. Теперь посмотрим, как этот язык 
можно использовать в приложениях. Для этого существует компонент набора дан- 
ных класса TQuery. Он имеет большинство свойств и методов, совпадающих с 
Table, и компонент Query может во многих случаях включаться в приложения 
вместо Table. Дополнительные преимущества Query — возможность формировать 
запросы на языке SQL. 

Рассмотрим коротко сравнительные характеристики Table и Query. При рабо- 
те с локальными базами данных чаще используется Table. С его помощью проще 
не только просматривать таблицу базы данных, но и модифицировать записи, уда- 
лять их, вставлять новые записи. Однако, при работе с серверными базами данных 
компонент Table становится мало эффективным. В этом случае он создает на ком- 
пьютере пользователя временную копию серверной базы данных и работает с этой 
копией. Естественно, что подобная процедура требует больших ресурсов и сущест- 
венно загружает сеть. 

Этот недостаток отсутствует в компоненте Query. Если запрос SQL сводится к 
просмотру таблицы (запрос Select), то результаты этого запроса (а не сама исход- 
ная таблица) помещается во временном файле на компьютере пользователя. Прав- 
да, в отличие от набора данных, создаваемого Table, это таблица только для чте- 
ния и не допускает каких-то изменений. Впрочем, это ограничение можно обойти, 
и в дальнейшем будет показано, как это можно делать. Если же запрос SQL связан 
с какими-то изменениями содержания таблицы, то никаких временных таблиц не 
создается. BDE передает запрос на сервер, там он обрабатывается и в приложение 
возвращается информация о том, успешно ли завершена соответствующая опера- 
ция. Благодаря такой организации работы эффективность Query при работе в сети 
становится много выше, чем эффективность Table. К тому же язык SQL позволяет 
формулировать сложные запросы, которые не всегда можно реализовать в Table. 

С другой стороны при работе с локальными базами данных эффективность 
Query заметно ниже эффективности Table. Замедление вычислений получается 
весьма ощутимым. : 

Исходя из этого краткого обзора возможностей Table и Query, можно заклю- 
чить, что в серверных приложениях обычно целесообразнее использовать компо- 
нент Query, а при работе с локальными базами данных — компонент Table. 

Чтобы ознакомиться с Query, откройте в C++Builder новое приложение и по- 
местите на форму компоненты Query, DataSource, DBGrid. В свойстве DataSet 
компонента DataSourcel задайте Queryl, а в свойстве DataSource компонента 
DBGrid1 задайте DataSourcel. Таким образом, мы создали обычную цепочку: на- 
бор данных (Queryl), источник данных (DataSourcel), компонент визуализации и 
управления данными (DBGrid1). А теперь займемся интересующим нас компонен- 
TOM Query. 

Основное свойство компонента Query — SQL, имеющее тип TStrings. Это спи- 
сок строк, содержащих запросы SQL. В процессе проектирования приложения 
обычно необходимо, как будет показано ниже, сформировать в этом свойстве неко- 
торый предварительный запрос SQL, который показал бы, с какой таблицей или 
таблицами будет проводиться работа. Но далее во время выполнения приложения 
свойство SQL может формироваться программно методами, обычными для класса 
TStrings: Clear — очистка, Add — добавление строки и т.д. 

Настройку компонента Query в процессе проектирования можно производить 
вручную, как это делается со всеми компонентами; или с помощью специального 
Визуального Построителя Запросов. Его вызов производится щелчком правой 
кнопки мыши на компоненте Query и выбором из всплывающего меню раздела SQL 
Builder. Останавливаться на работе с Визуальным Построителем Запросов мы He бу- 
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дем. Ознакомьтесь с ним самостоятельно, пользуясь встроенной справкой 
C++Builder. Работа с ним рассмотрена также в книге [8]. Следует сказать, что воз- 
можности визуального построителя запросов в целом не очень велики, так что 
обычно ручная настройка предпочтительнее. 

Прежде, чем приступать к ручной настройке, в свойстве DataBaseName ком- 
понента Query надо задать, как это делается и для компонентов Table, базу дан- 
ных, с которой будет осуществляться связь. База данных задается выбором из вы- 
падающего списка псевдонимов, или указанием полного пути к каталогу или фай- 
лу (в зависимости от используемой СУБД). 


ОСЕНИ ОФ a He ККИ DEIR LEAN AL С GOL МАЕК АЕ АВЕ ФХУ МКИ КОЕК ККИ ESAS PPLE IEP PLIABLE IEA LEASE ОКИ НАСИЛИЮ SEAS LEASE 


Предупреждение --- 


Не устанавливайте свойство DataSource — как вы увидите позднее, это свойство имеет отно- 
шение к приложениям с несколькими связанными таблицами и в других случаях не устанавли- 
вается. 


И С О Ио ИАА ДЕР ВОНИ ЗСУ 


Свойства TableName, которое было в компоненте Table, в Query нет, т.к. таб- 
лица, с которой ведется работа, будет указываться в запросах SQL. Поэтому преж- 
де всего надо занести в свойство SQL запрос, содержащий имя таблицы, с которой 
вы хотите работать. 


GLEE ЧАИ ПАО ИИЦ ее та 


Предупреждение =» 
Прежде, чем начинать детальную настройку компонента Query, надо сформировать в его 
свойстве SQL запрос, в котором указывается таблица и перечисляются параметры, если они 
используются в приложении. Пока такой запрос в SQL отсутствует, дальнейшая настройка 
Query невозможна. Запрос, заносимый в SQL в начале проектирования, носит чисто служеб- 
ный esis nai B дальнейшем вы можете его призрак: заменить на любой другой и 


PRD R ORIN 


IEG IRE ROPES LOGOS LIES INE SEE OOP LE ИСУ GBR ERE RE АКУЛ 


О DESIG BREESE ALLENDE ICL’ SS LEER LEE EDS BEELER ER 


Sainoe! hiicnielanreath вами в SQL в начале проектирования, может иметь, Ha- 
пример, следующий вид: 


Select * from pers 


После этого система поймет, с какой таблицей будет проводиться работа, и 
можно будет настроить поля в Query. Если работа будет проводиться с нескольки- 
ми таблицами, вы можете все их указать в запросе. Например: 


Select * from pers, dep 


После того, как соответствующий запрос написан, можете установить свойст- 
во Active компонента Query в true. Если все выполнено правильно, то вы увидите 
в компоненте DBGridl информацию из запрошенных таблиц. 
| Можете запустить свое приложение на выполнение и посмотреть его в работе. 
Оно предоставляет вам возможность просматривать записи, но, к сожалению, не 
позволяет их редактировать. Это связано с тем, что запрос Select возвращает таб- 
лицу только для чтения. Впрочем, в таком простом приложении, как наше, это 
легко исправить. Достаточно установить в компоненте Queryl свойство 
RequestLive в true. Это позволяет возвращать как результат запроса изменяемый, 
«Живой» набор данных, вместо таблицы только для чтения. Точнее, установка 
RequestLive в true делает попытку вернуть «живой» набор данных. Успешной эта 
попытка будет только при соблюдении ряда условий, в частности: 


Ш набор данных формируется обращением только к одной таблице 
Ш набор данных не упорядочен (в запросе не используется ORDER ВУ) 


Ш в наборе данных не используются совокупные характеристики типа Sum, Co- 
unt и др. 


Ш набор данных не кэшируется (свойство CashedUpdates равно false) 
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В нашем примере все эти условия соблюдаются. Так что можете установить 
RequestLive в true и пользователь сможет редактировать данные, удалять записи, 
вставлять новые записи. 

Ваше приложение можно усовершенствовать так же, как вы делали это в гла- 
ве 9 с приложением на основе Table. Для управления отображением данных, как и 
в компоненте Table, имеется уже известный вам Редактор Полей (Field Editor). Вы- 
звать его можно или двойным щелчком на Query, или щелчком правой кнопки 
мыши Ha Query и выбором Fields Editor из всплывающего меню. С Редактором Полей 
вы уже знакомы (см. раздел 9.5.2 главы 9). В нем вы можете добавить имена полу- 
чаемых полей (щелчок правой кнопкой мыши и выбор раздела меню Add), задать 
заголовки полей, отличающиеся от их имен, сделать какие-то поля невидимыми 
(Visible), не редактируемыми (ReadOnly), в логических полях можете задать вы- 
свечиваемые слова (да;нет), задать формат высвечивания чисел, создать вычисляе- 
мые поля, поля просмотра, задать диапазоны значений и многое другое. Если вы 
создали для полей таблицы словарь (см. раздел 9.6 главы 9), то всего этого вам де- 
лать не придется, так как, добавив нужные поля в Редакторе Полей, вы уже будете 
иметь для них заголовки и все прочие атрибуты. 


10.1.6.2 Динамические запросы и параметры Query 


Все запросы SQL, которые мы до сих пор рассматривали — это так называе- 
мые статические запросы. В них фиксировано все: имена таблиц, поля, констан- 
ты в выражениях и т.п. Но помимо таких статических запросов SQL допускает и 
динамические запросы, использующие параметры. Причем параметры можно при- 
менять вместо имен таблиц, имен полей и их значений. Значения этих параметров 
передаются извне и тем самым, не изменяя текст самого запроса, можно менять 
возвращаемый им результат. 

Параметры задаются в запросе с двоеточием, предшествующим имени пара- 
метра: 


:<имя параметра> 


Например, вы можете записать в запросе Select элемент WHERE в виде: 
WHERE Year b <= :PYear 


В этом случае вы сравниваете год рождения не с какой-то константой, а CO зна- 
чением параметра, который вы назвали PYear. 

Теперь обратимся к компоненту Query. Если вы введете в его свойство SQL за- 
прос, содержащий параметры, например: 

Select * from pers where (year b>:PYear) and (dep=:Dep) 


а потом щелкнете в Инспекторе Объектов на свойстве Params, вам откроется диа- 
логовое окно со списком объектов — указанных вами в запросе параметров РУеаг 
и Dep (см. рис. 10.1). В этом списке вы можете выделять по очереди параметры и в 
Инспекторе Объектов устанавливать их свойства. Это свойства: 


EERE ECE Ия ь Е ИЯ Я СВОИ, 


И 


‘DataType тип данных параметра (int, string u т.п.) 

Маше имя параметра 

ParamType тип параметра (используется при обращении к 
процедурам, хранимым на сервере — см. раз- 
дел 10.3.5.2) 

Value значение параметра по умолчанию 


Type — подсвойство Value тип значения по умолчанию 
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Рис. 10.1. 
Окно задания атрибутов параметров 


После того, как вы установили свойства всех параметров, можете использо- 
вать их при программировании приложения. 

Программный доступ к параметрам во время выполнения приложения осуще- 
ствляется аналогично доступу к полям набора данных. Свойство Params является 
указателем на массив параметров типа TParam, к элементам которого можно обра- 
щаться по индексу через его свойство Items[Word Index]. Последовательность, в 
которой располагаются параметры в массиве, определяется последовательностью 
их упоминания в запросе SQL. 

Значения параметров, как и значения полей, определяются такими свойства- 
ми объектов — параметров, как Value, AsString, AsInteger и т.п. (см. подробнее в 
разделе 9.11.4 главы 9 о свойствах похожих объектов — полей). Например, опера- 
тор 

for (int I = 0; Г < Queryl->Params->Count; I++) 

if (Queryl->Params->Items[I]->IsNull && 


Queryl->Params->Items[I]->DataType == ftInteger) 
Queryl->Params->Items[I]->AsInteger = -1; 


задаст значение «-1» всем целым параметрам, которым до этого не было присвоено 
значение. В нем использовано свойство Count — число параметров, свойство Is- 
Null, равное true, если параметру не задано никакое значение, свойство DataType, 
указывающее тип параметра, и свойство AsInteger, дающее доступ к значению па- 
раметра как к целому числу. 

Другой пример: операторы 


Queryl->Params->Items[0]->AsInteger = 1950; 
Queryl->Params->Items[1]->AsString = "Бухгалтерия"; 


задают значения первому (индекс 0) и второму (индекс 1) параметрам компонента 
Queryl, в свойстве SQL которого записан приведенный ранее оператор Select с па- 
раметрами :РУеаг и :Dep. Поскольку в этом операторе параметр :PYear упоминает- 
ся первым, то его индекс равен 0. 

Кроме свойства Items у Params есть еще одно свойство — ParamValues. Оно 
представляет собой массив значений параметров типа Variant. В качестве индекса 
в это свойство передается имя параметра или несколько имен, разделяемых точка- 
ми с запятой. Например, операторы 


Queryl->Params->ParamValues["PYear"] = 1950; 
Queryl->Params->ParamValues["Dep"] = "Бухгалтерия"; 


задают те же значения параметрам, что и приведенные выше. Преимуществом яв- 
ляется то, что при записи этих операторов не надо помнить индексы параметров. 
Другим преимуществом свойства ParamValues является возможность задать зна- 
‚ чения сразу нескольким параметрам. Например: 


Variant раг[] = {1950, "Бухгалтерия" }; 
Queryl->Params->ParamValues["PYear;Dep"] = VarArrayOf(par,1); 


Другой способ обращения к параметрам, при котором не надо помнить UX ин- 
дексы — использование метода РагатВуМаше компонента Query. Например, опе- 
раторы 


Создание приложений для работы с базами данных в сети 585 


Queryl->ParamByName ("PYear")->AsInteger = 1950; 
Queryl->ParamByName ("Dep")->AsString = "Бухгалтерия"; 


задают параметрам с именами РУеаг и Dep те же значения, что и приведенные ра- 
нее операторы. 

Следует оговориться, что задание нового значения параметру само по себе еще 
не обеспечивает влияния на возвращаемый из запроса результат. Надо повторно 
выполнить данный запрос, чтобы ощутить изменения. Но о том, как это делается, 
будет рассказано позднее. 


10.1.6.3 Основные свойства Query, связывание таблиц 


Большинство свойств Query аналогичны свойствам Table, рассмотренным ранее 
(см. раздел 9.5 главы 9). Объекты полей создаются автоматически для тех полей, ко- 
торые перечислены в операторе SQL. Программный доступ к этим полям осуществля- 
ется так же, как в Table, с помощью свойства Fields (например, Queryl->Fields[0]) 
или методом FieldByName (например, Оиегу1->Е1е!4ВуМате("Оер”)). Можно также 
‚ создавать объекты полей с помощью Редактора Полей, вызываемого двойным щелч- 
ком Ha Query или из меню, всплывающего при щелчке Ha Query правой кнопкой 
мыши. В этом случае доступ к объекту поля можно осуществлять также и по его име- 
ни (например, Queryl Dep). | 


mn р е ду п Pp e жд е H и е О О аи 


При использовании для Query Редактора Полей надо добавлять в нем все поля, перечислен- 
ные в операторе SQL. Иначе поля, не добавленные в Редакторе Полей, не будут доступны. 


О О С О а О С CRIES LEE RESELLER ай 
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Доступ к полям по имени возможен только в случае, если объекты полей были созданы с по- 

мощью Редактора Полей. 

Для доступа к значениям полей используются те же их свойства Value, 
AsString, AsInteger ит.п., что и в Table. Точно так же, как в Table, можно осуще- 
ствлять навигацию по набору данных, устанавливать фильтры, ограничивать вво- 
димые значения полей, кэшировать изменения. 

Из свойств, отличных от Table, остановимся на свойстве DataSource. Это 
свойство позволяет строить приложения, содержащие связанные друг с другом 
таблицы. Рассмотрим, как это делается, на том же примере, который использовал- 
ся в главе 9 при рассмотрении Table. Пусть мы хотим построить приложение, 
включающее в себя таблицу Dep, содержащую список отделов (в поле Dep) и их ха- 
рактеристику, в качестве головной таблицы и таблицу персонала Pers, содержа- 
щую в поле Dep имя отдела, в котором работает каждый сотрудник. Мы хотим, 
чтобы при выборе записи в таблице Dep в таблице Pers отбирались только записи, 
относящиеся к выбранному отделу. 

Откройте новое приложение. Перенесите на форму компоненты Queryl, 
DataSourcel, DBGrid1 и соедините их обычной цепочкой: в DBGridl задайте свой- 
ство DataSource равным DataSourcel, ав DataSourcel задайте свойство DataSet 
равным Queryl. Компонент Queryl настройте на таблицу Dep. Для этого установи- 
те свойство DatabaseName (например, dbP), а в свойстве SQL напишите оператор 


Select * from Dep 


Установите свойство Active в true и убедитесь, что все работает нормально: в 
DBGrid1 должно отобразиться содержимое таблицы Dep. 

Создайте другую аналогичную цепочку, перенеся на форму компоненты 
Query2, DataSource2, DBGrid2, и свяжите ее с таблицей Pers запросом 
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Select * from Pers 


в компоненте Query2. Установите свойство Active компонента Query2 в true ив 
DBGrid2 должно отобразиться содержимое таблицы Pers. 

Вы можете запустить приложение и убедиться, что оно работает, но таблицы 
независимы. Теперь давайте свяжем эти таблицы. Делается это следующим обра- 
зом. Измените текст запроса в свойстве SQL вспомогательного компонента набора 
данных Query2 на 


Select * from Pers where (Dep=:Dep) 


В этом запросе вы указываете условие отбора: значение поля Dep должно быть 
равно параметру :Dep. В предыдущем разделе было рассказано, как вводить в за- 
прос и использовать параметры. Но в данном случае не надо определять этот пара- 
метр с помощью редактора параметров, вызываемого из свойства Params компо- 
нента Query2. Вместо этого в свойстве DataSource компонента Query2 надо со- 
слаться на DataSourcel — источник данных, связанный с таблицей Dep. Это ска- 
жет приложению, что оно должно взять значения параметра :Dep из текущей за- 
писи этого источника данных. А поскольку имя параметра совпадает с именем 
поля в источнике данных, то в качестве значения параметра будет взято текущее 
значение этого поля. Таким образом, вспомогательная таблица, запрашиваемая в 
Query2, оказывается связанной с головной таблицей, запрашиваемой в Queryl. 

После изменения содержимого свойства SQL свойство Active компонента 
Query2 сбросится в false. Установите его в true и запустите приложение. Вы уви- 
дите, что при перемещении по первой таблице во второй отображаются только те 
записи, которые относятся к отделу, указанному в текущей записи первой табли- 
цы. 


10.1.6.д Основные методы компонента Query 


К основным методам Query можно отнести методы открытия и закрытия со- 
единения с базой данных. 

Метод Close закрывает соединение с базой данных, переводя свойство Active в 
false. Этот метод надо выполнять перед изменением каких-то свойств, влияющих 
на выполнение запроса или на отображение данных. Например, при изменении па- 
раметров запроса в свойстве SQL надо сначала методом Close закрыть соединение, 
связанное с прежним запросом, а потом уже выполнять новый запрос. 

Метод Ореп открывает соединение с базой данных и выполняет запрос, содер- 
жащийся в свойстве SQL. Но этот метод применим только в том случае, если за- 
прос сводится к оператору Select. Если же запрос содержит другой оператор, на- 
пример, Update или Insert, то при выполнении Open будет генерироваться исклю- 
чение EDatabaseError. Для осуществления любого другого запроса, кроме Select, 
используется метод ExecSQL. Он подготавливает выполнение данного запроса, 
если подготовка не осуществлена заранее, и затем выполняет его. Подготовка вы- 
полнения требует определенных затрат времени. Поэтому для ускорения взаимо- 
действия с базой данных полезно перед первым выполнением запроса выполнить 
метод Ргераге. 

При изменении текста в свойстве SQL методы Close и Prepare вызываются ав- 
томатически. 

Наличие двух методов выполнения запроса — Open и ExecSQL ставит вопрос: 
«Как же поступить, если запрос сформирован пользователем или программой и его 
характер неизвестен?». Неизвестный запрос, сформированный в некоторой пере- 
менной ssql типа строки, можно выполнить с помощью следующего кода: 


try 

{ 
Queryl->SQL->Clear(); 
Queryl->SQL->Add(ssql); 
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Queryl->Open(); 
} 


catch (EDatabaseErroré&) 


{ 
Queryl->ExecSQL () ; 


} 


В блоке try (см. раздел 12.10.5 главы 12) осуществляется попытка выполнить 
запрос с помощью метода Ореп. А если эта попытка завершается генерацией ис- 
ключения, т.е. если запрос состоит из оператора, отличного от Select, то генериру- 
ется исключение EDatabaseError, которое перехватывается в разделе catch, и вы- 
полняется метод ExecSQ.. | 

В некоторых случаях приложению требуется получить список имен полей таб- 
лицы, связанной с Query. Это может быть сделано методом GetFieldNames, кото- 
рый загружает список имен полей в любую переменную типа TStrings, передавае- 
мую в него в качестве аргумента. Например, оператор 


Queryl->GetFieldNames (ComboBox1->Items) ; 


загружает в выпадающий список ComboBoxl имена полей таблицы, связанной с 
Queryl. В дальнейшем будет приведен пример использования этого метода. 


_ 10.1.6.5 Кэширование изменений, совместное применение Query 
и UpdateSQL 


Метод ExecSQL осуществляет немедленную модификацию таблицы. Однако 
нередко удобнее было бы кэшировать изменения (хранить их временно в памяти), 
а после того, как все изменения и проверки сделаны, переслать их в базу данных 
или, по решению пользователя, отменить все сделанные исправления. 

Это делается так же, как и для компонента Table (см. раздел 9.11.3 главы 9): 
устанавливается в true свойство CachedUpdates компонента Query и применяются 
методы ApplyUpdates для записи изменений в базу данных, метод CancelUpdates 
для отмены изменений и метод CommitUpdates для очистки буфера кэша. 

Но режим кэширования позволяет сделать большее — он позволяет подклю- 
чить в приложение компонент UpdateSQL. Этот компонент, расположенный на 
странице библиотеки Data Access, позволяет модифицировать наборы данных, от- 
крытые в режиме только для чтения. Это особенно важно для наборов данных, OT- 
крываемых Query с запросом Select, поскольку Select создает таблицу только для 
чтения. 

Давайте построим приложение, демонстрирующее режим кэширования и тож- 
дественное тому, которое рассматривалось в разделе 9.11.3 главы 9. Возьмите то 
же самое приложение (рис. 9.47), только замените в нем компонент Tablel на ком- 
понент Queryl и везде в тексте тоже проведите соответствующую замену Та е1 на 
Оцегу1. В свойстве SQL компонента Queryl запишите «Select * from Pers» и уста- 
новите свойство CachedUpdates в true. 

Запустите свое приложение, и вы увидите, что оно, увы, не работает. Отредак- 
тировать запись или вставить новую запись невозможно. А из кнопок навигатора 
доступны только кнопки навигации. Причина всего этого была указана ранее — 
Query с запросом Select создает таблицу только для чтения. 

Давайте исправим ваше приложение. Поместите на него компонент 
UpdateSQL со страницы библиотеки Data Access. Чтобы связать его с приложени- 
ем, установите в компоненте Queryl свойство UpdateObject равным имени введен- 
ного компонента UpdateSQL1. Это имя вы можете выбрать из выпадающего спи- 
ска в свойстве UpdateObject. 

Теперь можно задавать свойства компонента UpdateSQL1. Этих свойств, кро- 
ме Name и Tag, всего 3: DeleteSQL, InsertSQL и ModifySQL. Они содержат соот- 
ветственно запросы, которые должны выполняться при удалении, вставке или мо- 
дификации записи. Эти запросы можно записать обычным образом, вручную. А 
можно воспользоваться редактором UpdateSQL, который вызывается двойным 
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щелчком на UpdateSQL или при выделенном Орде ОТ, вызывается из всплы- 
вающего меню. Окно этого редактора имеет вид, представленный на рис. 10.4. 
Первая страница Options редактора UpdateSQL, представленная на рисунке, содер- 
жит два окна Key Fields и Update Fields. 


Form’ >UpdateSatt ssn >Queryt) | | ‚Хх. 


Рис. 10.2. 

Окно редактора UpdateSQL ре в 5 ss amas 
- 90 Generation ~ "os oe mn oe Se ei Bate on ape el 
| Table Name: о Е 


4] ia xf 


Get ве Fields: 3 | _ 


г Datars раз | 


т [- ое Koel’ 
Generate SQL | 
on Gute Fld Hanes a 


| Cancel” | eee | 


В левом окне Key Fields надо выделить поля, по которым программа будет pac- 
познавать модифицируемую или удаляемую запись. Можно выделить все поля, 
что гарантирует максимально возможную надежность распознавания, но можно 
ограничиться выбором нескольких наиболее важных полей. При работах с очень 
большими таблицами это сэкономит время выполнения запроса. Для выбора сово- 
купности полей можно нажать клавишу СИ и, не отпуская ее, выбрать курсором 
мыши нужные поля. | 

В правом окне Update Fields надо выделить поля, значения которых будут зада- 
ваться при модификации или вставке записи. Обычно целесообразно выделить в 
этом окне все поля, хотя, конечно, могут быть случаи, когда не все поля надо за- 
давать. В частности, нельзя задавать вычисляемые поля, если они имеются в таб- 
лице. 

После того, как вы выделили в этих окнах поля, нажмите кнопку Generate 
SQL. После этого вам будет показана вторая страница SQL редактора UpdateSQL, на 
которой вы можете просмотреть сгенерированные запросы для модификации 
(Modify), вставки (Insert) и удаления (Delete) записи. После щелчка Ha OK эти запро- 
сы перенесутся в свойства DeleteSQL, InsertSQL и ModifySQL, где вы их можете 
дополнительно отредактировать. | 

При всех выделенных полях запрос ModifySQL будет иметь вид: 


update Pers 


set 
Num = :Num, 
Dep = <:Dep, 
Fam = :Fam, 
Nam = :Nam, 
Par = :Рахг, 
Year .b =‘: Year bd, 

Us Se@mic= 3 Sex; 
Charact = :Charact, 
Photo = :Photo 

where 
Num = :OLD Num and 
Dep = :OLD Dep and 
Fam = :OLD Fam and 
Nam = :OLD_ Nam and 


Par = :OLD Par and 
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Year b = :OLD Year b and 
Sex = :OLD Sex and 

Charact = :OLD Charact and 
Photo = :OLD Photo 


В нем в разделе Set указана установка всех полей в значения, задаваемые со- 
ответствующими параметрами с именами, тождественными именам полей. В этот 
раздел включаются те поля, которые вы выделили в окне Update Fields редактора 
UpdateSQL. Заполнение этих параметров при выполнении соответствующих команд 
приложения вам не потребуется: все это сделают автоматически методы компонен- 
та UpdateSQL. В разделе Where содержатся условия, по которым идентифициру- 
ется модифицируемая запись. В этих условиях используются параметры с имена- 
ми, тождественными именам полей, но с префиксом OLD_. Эти параметры — 
прежние значения соответствующих полей, которые были получены компонентом 
до модификации записи. В условия Where включены те поля, которые вы выдели- 
ли в окне Key Fields редактора UpdateSQL. | 

Естественно, что в зависимости от приложения вы можете заменить эти авто- 
матически сгенерированные имена параметров на другие или вообще использовать 
запросы без параметров. Только имейте в виду, что значения автоматически сгене- 
рированных параметров в дальнейшем будут автоматически загружаться из объек- 
тов-полей, а если вы от них откажетесь, то и соответствующие значения должны 
будете задавать сами. 


Предупреждение ООО ОВ ОДНИ 


Если вы измените имена параметров в запросах SQL компонента UpdateSQL, вам придется 
программно задавать значения этих параметров. Если же вы оставите автоматически сгене- 
рированные имена, то в дальнейшем значения параметров будут автоматически загружать- 
ся из объектов-полей. Так что изменять имена параметров неразумно. 
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Для Toro, чтобы запросы компонента UpdateSQL срабатывали, все объекты 
полей, имена которых в них используются, должны быть или автоматически сге- 
нерированы (т.е. без применения в компоненте Query Редактора Полей), или вве- 
дены в Редакторе Полей. В противном случае при попытке выполнить запрос вам 
будет выдано сообщение: «Field ... is of an unknown type» (поле... неизвестного 
типа) и запрос не выполнится. 


Предупреждение nm 


В запросах компонента UpdateSQL должны фигурировать только те поля, которые введены 
вами в Редакторе Полей компонента Query, или вы не должны пользоваться в Query Редак- 
тором Полей. 
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Посмотрим Ha приведенный выше сгенерированный запрос ModifySQL с точ- 
ки зрения нашего приложения. Прежде всего очевидно, что из условия запроса 
where надо удалить поля Charact и Photo, так как сравнение полей такого типа 
бессмысленно. Вообще для нашей таблицы достаточно оставить сравнение только 
по полю Миш, поскольку это поле обеспечивает уникальность каждой записи. Кро- 
ме того из раздела set надо исключить поле Num, так как оно типа Autoincrement, 
а значения полей этого типа устанавливать нельзя: они автоматически нарастают с 
каждой новой записью. Имеет также смысл исключить поля Charact и Photo, так 
как они в нашем приложении не отображаются. Таким образом, запрос ModifySQL 
имеет смысл оставить в виде: 

update Pers 

set 

Dep = :Dep, 
Fam = :Fam, 
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Мам = :Мам, 
Par = :Par, 
Year Bb = :хеаг Ь, 
Sex = :Sex 

where 
Num = ;OLD Num 


Запрос в свойстве DeleteSQL строится по такому же принципу. Ero можно за- 
писать в виде | 
delete from Pers 


where 
Num = >OLD_ Num 


Запрос InsertSQL, построенный при выделении всех полей в окне рис. 10.2, 
имеет вид: 
insert into Pers | 
(Num, Dep, Fam, Nam, Par, Year b, Sex, Charact, Photo) 
values 
(:Num, :Dep, :Fam, :Nam, :Par, :Year b, :Sex, 
:Charact, :Photo) 


Ero, очевидно, тоже надо изменить, убрав задание поля Num, поскольку OHO 
увеличивается автоматически и не может изменяться приложением. Имеет смысл 
‚убрать также поля Charact и Photo, так как они не фигурируют в нашем приложе- 
нии. В итоге запрос приобретет следующий вид: 

insert into Pers 

(DEP, FAM, NAM, PAR, YEAR В, SEX) 
values 
(:DEP, :РАМ,. :NAM, . : PAR, > YEAR В, : SEX) 


Осталось несколько изменить по сравнению с приложением на основе Table 
обработчик события OnClick кнопки Фиксация. Он должен иметь вид: 

Queryl->ApplyUpdates (); 

Queryl->CommitUpdates (); 

Queryl->Close(); 

Queryl->Open (); 

modif = false; 


По сравнению с тем, что было раньше, в него добавлены операторы закрыва- 
ния (Close) и открывания (Open) соединения с базой данных компонента Queryl. 
Это желательно сдедать, чтобы в Queryl отобразилось новое сотояние базы данных 
после внесенных в нее изменений. Если не предусмотреть этого, то, например, бу- 
дет невозможно вставить в сеансе работы новую запись, подтвердить изменение, а 
затем удалить эту запись. Дело в том, что если мы не обновили данные в Queryl, то 
в этих данных отсутствует вставленная в данном сеансе работы запись. И, следова- 
тельно, ее не удастся удалить (можете проверить это в эксперименте). 

Запустите теперь приложение, и вы увидите, что оно стало работать так же, 
как работало ранее с компонентом Table. Можно редактировать записи, удалять, 
вставлять новые записи, управлять кэшированием. 

В данном случае все получилось так просто, поскольку соответствующие мето- 
ды работы с UpdateSQL автоматически выполняются компонентами DBNavigator 
и DBGrid. В некоторых других приложениях эти методы надо вызывать явно. По- 
этому коротко ознакомимся с ними. 

Метод 


Apply (Db::TUpdateKind UpdateKind) 


| 


обеспечивает загрузку значений всех необходимых параметров и выполнение од- 
ного из запросов компонента UpdateSQL. Какого именно — определяется парамет- 
ром UpdateKind, который может принимать значения ukModify, ukInsert или 
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ukDelete, что соответствует выполнению запроса, хранящегося в свойствах Modi- 
fySQL, InsertSQL и DeleteSQL. 
Например, оператор 


UpdateSQL1->Apply (ukModify) 


вызовет выполнение запроса, содержащегося в свойстве ModifySQL. 
Если нужный запрос SQL не содержит параметров, то эффективнее вызвать та- 
кой метод компонента UpdateSQL, как Ехес ОГ: 


ExecSQL(Db::TUpdateKind UpdateKind) 


который тоже обеспечивает выполнение указанного запроса, но без предваритель- 
ной загрузки значений параметров. Наконец, метод 


SetParams (Db: : ТОрдафеК1па UpdateKind) 


обеспечивает загрузку значений параметров указанного запроса SQL без ero вы- 
полнения. Таким образом, метод Apply — это просто последовательное выполне- 
ние методов SetParams и Ехес5 ОГ. 


10.1.7 Пример формирования произвольных запросов SQL 


Вы можете попробовать использовать компонент Query вместо Table в любом 
из приложений, рассмотренных в главе 9. Большое количество подобных приме- 
ров приложений с Query вы можете найти в книге [8]. Несколько примеров имеет- 
ся на прилагаемом к данной книге диске. Целесообразность замены Query на 
Table, как было сказано в разделе 10.1.6.1, зависит от того, работаете ли вы с ло- 
кальными базами данных, или с удаленным сервером. Но есть приложения, в ко- 
торых пользователю разрешается формировать любые запросы к базе данных. В 
таких приложениях без языка SQL и, соответственно, без компонентов Query не 
обойтись. Рассмотрим на чисто демонстрационном примере, как строить подобные 
приложения. 

Общий вид приложения, которое мы с вами попробуем построить, приведен на 
рис. 10.3. Вы можете найти его на приложенном к книге диске. 


Рис. 10.3. 

Пример приложения, позволяющего 
пользователю формировать 
произвольные запросы к базе данных 


> 1950 ORDER BY Уеаг_Ь 
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Приложение позволяет пользователю сформировать различные запросы 
Select к таблице Pers. Выпадающий список Поле (типа TComboBox, в программе 
назван CBFilds) заполнен именами полей, которые пользователь может выбирать 
из него при формировании запроса. Выпадающий список Операции, знаки (типа 
TComboBox, в программе назван СВОр) заполнен символами допустимых опера- 
ций, функций и знаков, которые пользователь также может выбирать при форми- 
ровании запроса. Окно, расположенное ниже кнопок, является компонентом типа 
TMemo (в программе названо MSQL). Это окно служит для отображения форми- 
руемого запроса SQL. Ниже расположена таблица DBGrid1 типа TDBGrid, которая 
через компонент DataSource связана с компонентом Query типа TQuery. Этот к KOM- 
понент и выполняет сформированные пользователем запросы. 

Кнопка Новый запрос начинает формирование запроса, посылая в MSQL текст 
«Select ». Затем пользователь может вводить имена полей или непосредственно в 
текст, или, чтобы не ошибиться, выбирая их имена из списка Поле. При вводе со- 
вокупных характеристик или вычисляемых полей пользователь может брать необ- 
ходимые символы и ключевые слова из списка Операции, знаки. При желании поль- 
зователь может щелкнуть на кнопке Условие (в запрос вводится элемент WHERE), 
на кнопке Порядок (в запрос вводится элемент ORDER ВУ) или кнопке Группировка 
(в запрос вводится элемент GROUP ВУ) и сформировать условия отбора, сортиров- 
ки, группирования. После того, как запрос сформирован, пользователь выполняет 
его щелчком на кнопке Выполнить и в окне отображаются результаты запроса. 

Ниже приведен полный текст данного приложения. 


// Перечислимый тип, определяющий режим работы 
// в каждый момент времени 


enum TRegim {RNone, RFields, RWhere, ROrder, REnd} Regim; 


а ао пои: 
void _ Еаз®са11 TForml::ADDS(String $) 
{ 
// Добавление в конец последней строки в Memo новой строки $5 
MSOL->Lines->Strings [MSQL->Lines->Count-1] = 
MSQOL->Lines->Strings [MSQL->Lines->Count-1] + $; 
} 


т бам “icc «ORCL a 

void _fastcall TForml::CBFieldsChange(TObject *Sender) 
{ 
if ((Regim == ВЕпа) | | (MSQL->Lines->Count < 1)) 

ShowMessage ( 
"Начните новый запрос или вводите оператор вручную"); 
else ADDS(" "+CBFields->Text) ; 

} 

a a звоньызанси 

void _ fastcall TForml::FormCreate(TObject *Sender) 
{ 

// Загрузка в выпадающий список имен полей таблицы 
Query->GetFieldNames (CBFields->Items) ; 
CBFields->Items->Insert (0,"*"); 
CBFields->ItemIndex = 0; 

CBOp->ItemIndex = 0; 
Regim = RNone; 

} 

дов aac mene 

void _fastcall TForml::BbeginClick(TObject *Sender) 

{ 

MSQOL->Clear(); 

MSOL->Lines->Add("Select "); 
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Regim = RFields; 
} 
LM peppers VIE TR TORRE Fs SE APE 
void _fastcall TForml::BexecClick(TObject *Sender) 
{ 
if (Regim == RNone) 
{ 
ShowMessage ("Вы не ввели запрос"); 
return; 
} 
if (Regim == RFields) 
ADDS (" FROM PERS") ; 
Regim = REnd; 
Query->SQL->Assign (MSQL->Lines) ; 
Query->Open () ; 
} 
BER TS aT 
void _fastcall TForml::BWhereClick(TObject *Sender) 
{ 
if (Regim == RFields) 
ADDS ("FROM PERS") ; 
ADDS (" WHERE") ; 
Regim = RWhere; 
} 
тие т ое ae УФ: 
void _fastcall TForml::CBOpChange(TObject *Sender) 
{ | 
if ((Regim == REnd) || (MSQL->Lines->Count < 1)) 
ShowMessage ("Начните новый запрос или вводите оператор вручную"); 
else ADDS(" "+CBOp->Text) ; 
} 
Ah RR Rr eee ree 
void _fastcall TForml::BOrderClick(TObject *Sender) 
{ 
if (Regim == RFields) 
ADDS (" FROM PERS"); 
ADDS (" ORDER ВУ"); 
Regim = ROrder; 
} 
И owrai EL ERP A P9 2959 BHAA 
void _ fastcall TForml::BGroupClick(TObject *Sender) 
{ 
if (Regim == RFields) 
ADDS (" FROM PERS") ; 
ADDS (" GROUP BY"); 
Regim = ROrder; 
} 
Сделаем некоторые комментарии к этому тексту. В начале вводится перемен- 
ная Regim перечислимого типа: 


enum TRegim {RNone, RFields, RWhere, ROrder, REnd} Ведут; 


возможные значения которой определяют, в каком режиме в данный момент нахо- 
дится приложение. В начале значение переменной Regim задается равным RNone. 
Обработчики щелчков всех кнопок проверяют значение переменной Regim и в за- 
висимости GT результатов этой проверки производят те или иные операции. Кроме 
того они изменяют значение этой переменной, сосбщая приложению, какие опера- 
ции выполняет пользователь. Например, обработчик щелчка кнопки Выполнить в 
процедуре BexecClick проверяет Regim и, если значение этой переменной оказыва- 
ется RNone, это означает, что пользователь, не нажав до этого ни одной кнопки, 
сразу щелкнул на кнопке Выполнить. В этом случае пользователю выдается замеча- 
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ние «Вы не ввели запрос» и обработка события прерывается. Соответствующие 
проверки режима вы можете увидеть и в других обработчиках событий. 

Далее в приложении вводится процедура ADDS, которая добавляет заданную 
текстовую строку в конец текста, содержащегося в MSQL. Это сделано просто во 
избежание повтора входящего в эту процедуру оператора во многих местах кода. 
Конечно, при этом в заголовочном файле модуля добавляется в описание класса со- 
ответствующее объявление этой процедуры: 


void _fastcall ADDS(String $); 


Процедура FormCreate является обработчиком события OnCreate формы. В 
этой процедуре производится загрузка списка CBFields значениями имен полей в 
таблице. Это очень легко делается методом GetFieldNames, который загружает 
список имен полей в любую переменную типа TStrings, передаваемую в него в ка- 
честве аргумента. 

Остальные процедуры приложения, вероятно, специальных комментариев не 
требуют. Просмотрите их, проверьте, как работает приложение, и все неясности 
paspemarca. 


10.2 Работа с базами данных в сети 


10.2.1 Транзакции и проблемы многопользовательского 
режима работы 


Все, что рассматривалось ранее, и все созданные вами приложения могут рабо- 
тать и с локальными базами данных, и в сети с базами с разделенными файлами (с 
одновременным доступом нескольких пользователей), и с удаленным сервером на 
платформе клиент/сервер. Однако, при работе в сети, когда к одной и той же базе 
данных одновременно может обращаться несколько пользователей, может возни- 
кать множество проблем. Например, вы прочитали какую-то запись из таблицы и 
редактируете ее. Но, пока вы редактируете, другой пользователь может изменить 
эту запись или вообще удалить ее. Что тогда будет при попытке сохранить ваши 
изменения в этой уже отредактированной или вообще удаленной записи? 

Эта и множество других аналогичных проблем разрешаются с помощью меха- 
низма транзакций (transaction). Транзакция — это групповая операция, связанная 
с передачей сообщения. С точки зрения приложения транзакция — это группа ло- 
гически связанных операторов SQL, причем только успешное выполнение всех 
операторов должно приводить к изменению данных сервером. Пока все операторы 
транзакции не выполнены, сохраняется возможность отменить их и не фиксиро- 
вать результаты в базе данных. Подобный механизм необходим для надежной ра- 
боты с удаленным сервером и в многопользовательском режиме. В тех приложени- 
ях, которые вы создавали до сих пор, транзакции тоже использовались, но неявно. 
Каждый вызов метода Post, каждое изменение таблицы автоматически начинало и 
заканчивало транзакцию. Но часто такой автоматизм недостаточен и не эффекти- 
вен. Обычно надо управлять транзакциями явно. Как это делается, мы рассмотрим 
ниже. Но сначала попробуем осмыслить проблемы, возникающие при совместном 
доступе пользователей к одной и той же таблице. Их можно систематизировать 
следующим образом: 


Ш Чтение незафиксированных изменений происходит, если одна транзакция 
прочла изменения, сделанные другой транзакцией, но еще не зафиксирован- 
ные в базе данных. Если эти изменения будут отменены вносившей их тран- 
закцией, то окажется, что прочитавшая их транзакция будет работать с оши- 
бочными данными. 
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Ш Неповторяемое чтение данных происходит, если в момент чтения данных од- 
ной транзакцией другая транзакция изменяет эти данные. В этом случае по- 
вторное чтение тех же данных невозможно. 


Ш Фантомные записи возникают, если одна транзакция прочла незафиксиро- 
ванные новые записи, созданные другой транзакцией (может быть эти записи 
и не будут вставлены в базу данных), или прочла записи, которые к моменту 
ее завершения уже удалены из таблицы другой транзакцией. В обоих случаях 
первая транзакция оперирует с фантомами, которых в таблице нет. 


Ш //отерянные изменения возникают, если одна транзакция модифицирует из- 
менения, сделанные другой транзакцией. 


ши Вторичные эффекты модификации могут происходить в базах данных, в KO- 
торых значения одних записей зависят от значений других записей. Тогда на- 
ложения результатов одновременной работы нескольких транзакций возмож- 
ны даже в случае, если транзакции оперируют с разными записями. 


10.2.2 Управление транзакциями, компонент Database 


Выше упоминалось о том, что даже без специального, целенаправленного 
управления транзакциями они в действительности автоматически осуществляют- 
ся при каждой модификации данных. Это производится компонентом типа 
TDatabase, который C++Builder включает автоматически в любое приложение, ра- 
ботающее с базами данных. Этот компонент решает следующие задачи: 


Ш Создание соединения с удаленным сервером 

Регистрация пользователя при первом обращении к серверу 
Создание локальных псевдонимов приложений 

Управление транзакциями 


Определение уровня изоляции транзакции (регулирование одновременных 
транзакций к одним и тем же таблицам) 


Если же вы хотите сознательно управлять транзакциями, вы должны явным 
образом включить компонент Database в свое приложение. Он расположен в биб- 
лиотеке на странице Data Access. 

Database связывается с компонентами наборов данных Table, Query и други- 
ми через имя базы данных, к которой он подключается. Это имя задается в свойст- 
ве DatabaseName. Может быть задан псевдоним базы данных или полный путь к 
ней. Если задается база данных, имеющая псевдоним ВПЕ, то свойства AliasName, 
DriverName и Params можно не задавать. В противном случае надо задать или 
свойство AliasName, или свойства DriverName и Params. 

Установку значений всех этих свойств можно проводить непосредственно в 
Инспекторе Объектов, но удобнее воспользоваться специальным редактором, кото- 
рый вызывается двойным щелчком на Database (рис. 10.4). Как уже говорилось, 
вы можете ограничиться заданием только имени базы данных (окно Мате). Но 
если ваша база данных имеет псевдоним, вы можете указать и его (окно Alias 
Мате). В этом случае можно щелкнуть на кнопке Defaults (умолчание) и в окне 
Parameter overrides появятся значения параметров по умолчанию. Вы можете внести 
в них какие-то изменения. Например, при работе с базой данных, защищенной па- 
ролем, вы можете указать в параметрах этот пароль (на рис. 10.4 указан пароль 
«1») и сбросить индикатор Login prompt — приглашение к соединению, которое за- 
прашивает пароль. Тогда при запуске вашего приложения не будет каждый раз за- 
прашиваться пароль. Это облегчит работу пользователей, но, конечно, снимет за- 
щиту вашей базы данных. 

Индикатор Keep inactive connection устанавливает свойство KeepConnection, о 
котором будет сказано ниже. 
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После всех установок в редакторе щелкните на ОК и введенные вами установ- 
ки заполнят значения свойств DatabaseName, AliasName, DriverName, Params и 
КеерСоппесй оп. 

Свойство Connected (соединение) совместно со свойством KeepConnection 
управляют процессом соединения компонентов с базой данных. Если 
KeepConnection равно true, то соединение с базой данных постоянное даже при от- 
сутствии открытых наборов данных. Если же KeepConnection равно false, то для 
регистрации на сервере надо устанавливать Connected в true при каждом откры- 
тии таблицы. 

Свойство TransIsolation определяет уровень изоляции транзакции. Это свой- 
ство может иметь значения: 


ен: а В о LES MESS о ай м с :. Я BRS: , Я 

tiDirtyRead Позволяет читать все текущие изменения, проводимые 
другими транзакциями до их фиксации 

tiReadCommit Позволяет читать только зафиксированные изменения, 


проводимые другими транзакциями. Это значение при- 
нято по умолчанию 


tiRepeatableRead После начала транзакции не позволяет читать даже под- 
твержденные изменения, проводимые другими транзак- 
циями в прочитанных данных. Следовательно, при по- 
вторном прочтении на протяжении данной транзакции. 
той же записи будут получены прежние результаты, 
даже если другие транзакции их уже изменили 


Если обратиться к сформулированным в предыдущем разделе проблемам, воз- 
никающим при совместной работе транзакций с одними и теми же данными, то 
можно заметить, что только значение tiRepeatableRead исключает проблемы чте- 
ния незафиксированных изменений, неповторяемого чтения данных и появления 
фантомных записей. Принятый по умолчанию уровень tiReadCommit исключает 
только проблему неповторяемого чтения данных. 

Указанные выше значения свойства TransIsolation могут не поддерживаться 
на конкретном сервере, с которым вы работаете. В этом случае сервер переходит на 
доступный ему более высокий, чем запрошенный, уровень изоляции. Ниже приве- 
дена таблица уровней для различных систем. a 
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# 


У ИХ ИИ BEE ИАН CASE IGE. АИ ИИ ИИД ИИА ОУ EARS RELIVE LABELER REET, 


TransIsolation InterBase Oracle Sybase & Microsoft 
tiDirtyRead Read commited Read commited Read 

commited 
tiReadCommit Read commited Read commited Read commited 


tiRepeatableRead Repeatable Read MRepeatable Read Error 
(READ ONLY) (He поддерживается) 


Начало транзакции осуществляется методом StartTransaction компонента 
Database. При этом начинающаяся транзакция использует текущее значение 
свойства TransIsolation для определения уровня изоляции. 

Завершается транзакция методом Commit, фиксирующим ее результаты в 
базе данных. Метод Rollback можно использовать для «отката» назад при неуда- 
че — этот метод отменяет все операции с базой данных, выполненные после по- 
следнего выполнения метода Commit. 

Таким образом, программа работы с данными должна строиться по следующей 
схеме: 


Databasel->StartTransaction(); 
Группа операторов изменения данных (ExecSQL и др.) 


Проверка результатов: Если успешно — Databasel->Commit (); 
Если неудача — Databasel->Rollback(); 


В случае выполнения Rollback все изменения, сделанные на протяжении 
транзакции отменяются. Таким образом, модификации данных, предусмотренные 
в транзакции, или будут выполнены все, или не будет выполнено ничего. 

Из общих рекомендаций по организации транзакций можно прежде всего от- 
метить рекомендацию по возможности сокращать число трансакций. Сокращение 
числа транзакций возможно за счет команд SQL групповой обработки записей. На- 
пример, при необходимости переименовать подразделение во всех записях табли- 


цы можно написать следующий Код (предполагается, что мы хотим переименовать 
«Цех 1» в «Цех 2» ): 


Tablel->First(); 
while (! Tablel->Eof) 
{ 
if (Tablel->FieldByName ("Dep") ->AsString == "Цех 2") 
{ 
Tablel->Edit (); 
Tablel->FieldByName ("Dep")->AsString = "Цех 1"; 
} 
Tablel->Next (); 


} 
Tablel->First(); 


Этот код предполагает осуществление стольких транзакций, в скольких запи- 
сях будут сделаны исправления. Для каждого исправления будет генерироваться 
своя команда Update. Если ваша база данных большая, то это может привести к 
значительным затратам времени и к проблемам на сервере при регистрации тран- 
закций. А если во время выполнения цикла возникли какие-то исключительные 
ситуации, то часть записей будет изменена, а часть — нет. Последнее можно ис- 
править, поместив перед циклом оператор StartTransaction. Но неэффективность 
выполнения останется. 


_ 598 ый LP Sy $ if ‘Глава 10 


Более удачным решением в данном случае является выполнение с помощью 
Query команды типа: 


UPDATE Pers SET Dep='Uex 1' WHERE Dep='Lex 2' 


Эта команда будет связана всего с одной транзакцией и гарантирует, что или 
все необходимые изменения будут сделаны, или не будет сделано ни одного, если в 
процессе выполнения возникнут какие-то проблемы. 

Число транзакций сокращается также за счет описанного ранее кэширования 
изменений, поскольку в этом случае все локально хранящиеся изменения заносят- 
ся в базу данных одной транзакцией. 

Наряду с сокращением числа транзакций желательно уменьшать длитель- 
ность каждой, поскольку слишком долго выполняемая транзакция может надолго 
заблокировать ресурсы для других приложений. Например, если таблица Pers, с 
которой вы работали в предыдущем примере, очень большая, то приведенную 
выше команду можно разбить на две, выполняемые в пределах отдельных тран- 
закций: 

UPDATE Pers SET ПБер='Цех 1! 

WHERE (Num BETWEEN 1 AND 10000) and(Dep='Lex 2') 


UPDATE Pers SET Бер='Цех 1' 
WHERE (Num > 10000) and(Dep='Lex 2') 


10.2.3 Работа с SQL Monitor 


Удобным инструментом для отладки программ, работающих с базами данных, 
является SQL Monitor, запускаемый командой главного меню Database | SQL 
Monitor. Окно SQL Monitor показано на рис. 10.5 а. Осуществляя постоянный мони- 
торинг обмена сообщениями с сервером, SQL Monitor позволяет просматривать ко- 
манды SQL, которые неявным для пользователя образом передаются через SQL 
Links удаленным серверам баз данных. Двойной щелчок на том или ином сообще- 
нии позволяет развернуть или свернуть его полный текст внизу окна. Командой 
меню Options | Always оп Тор можно установить опцию, обеспечивающую постоянное 
присутствие окна SQL Monitor на экране поверх всех других окон. 

Раздел меню Options | Trace Options открывает окно опций (рис. 10.5 6), содержа- 
щее следующие индикаторы, определяющие отображение тех или иных сообщений: 


а В В О А ELLE ALPE LES И SESE LER ELLIE GEN LE LES BELL TLE BE ESERIES 


Prepared Query Statements Команды, подготовленные к отправке. на сервер 

Executed Query Statements Команды, выполняемые Ha сервере 

Statement Operations Такие операции как ALLOCATE, PREPARE, 
ЕХЕСОТЕ, ЕЕТСН 

Connect / Disconnect Операции при соединении и отключении OT базы 
данных (распределение памяти и т.п.) 

Transactions Действия при обработке транзакций: BEGIN, 
COMMIT, ROLLBACK, ABORT 

BLOB ИО Действия над BLOB (бинарными) полями 

Miscellaneous Другие операции с базами данных, He перечис- 


ленные ранее 
Vendor Errors Сообщения об ошибках, возвращаемые сервером 


Vendor Calls Вызовы функций API сервера 


Создание приложений для работы с базами данных в сети 599 


Рис. 10.5. -Q) 
Окно программы 
SQL Monitor (a) и 
окно ее опций (6) 


SOL Prepare: INTRBASE - SELECT NUM ОЕР FAM МАК 
SOL Vendor INTRBASE - isc_dsql_allocate_ statement 
SQL Vendor: INTRBASE - isc_start_transaction 

т Vendor. INTRBASE - ioc oes prepwe 


[SQL Execute: — SELECT NUM oy FAM “go PAR YEAR В 
‘SEX СНАВАСТ PHOTO FROM PERS ORDER BY NUM ASC 


При начальной отладке приложения, вероятно, полезно установить только оп- 
ции Executed Query Statements и Transactions. Они позволяют увидеть логику работы. 
В дальнейшем для оптимизации работы с базой данных можно подключить и дру- 
гие опции. 


10.2.4 Управление доступом 


Системы управления доступом должны обеспечивать эффективное взаимодей- 
ствие приложений, работающих одновременно с базой данных. Исключить обсуж- 
давшиеся выше наложения результатов работы различных транзакций можно пу- 
тем блокировки ресурсов, необходимых выполняемой транзакции. Тогда другие 
транзакции, обращающиеся к тем же ресурсам, будут ждать, пока данная транзак- 
ция не завершится, после чего ресурсы будут освобождены. Правда, при этом воз- 
можна взаимная блокировка, когда одна транзакция заблокировала ресурсы, необ- 
ходимые другой, а эта другая заблокировала какие-то ресурсы, необходимые пер- 
вой. Это тупиковая ситуация, которую можно разрешить только извне. 

C++Builder реализует более оптимальное управление доступом. Оно предпола- 
гает, что большинство обращений к базе данных — это обращения для чтения. И 
очень невелика вероятность того, что два приложения одновременно будут изме- 
нять одну и ту же запись и одни и те же поля в ней. Такое редкое наложение изме- 
нений будет восприниматься как аварийная Coy A, приводящая к генерации 
исключения. 

Процесс работы приложения C++Builder с базой данных выглядит следую- 
щим образом. При выполнения приложения оно получает копию записи с сервера, 
позволяет что-то в ней изменить, а затем посылает изменения на сервер с помощью 
команды Update. Эта команда SQL имеет элемент Where, перечисляющий значе- 
ния полей, совпадение которых идентифицирует изменяемую запись. Эти значе- 
ния берутся из копии записи и, следовательно, не зависят от того, не изменились 
ли за это время поля реальной записи. 

В компонентах Table и Query имеется свойство UpdateMode — режим обнов- 
ления. Значения этого свойства и определяют, какие поля будут включены в эле- 
мент Where команды Update. Возможные значения: 


ЖАК ИИА ААА DEERE RR LOLOL ILE LL ED ILEELER BEEBE REE REL EBOBE SEE BEBE LLEGEDERBERE LEDERER LEA PEO АЛАТАУ ВАЛУА aR a a a 


up WhereAll Where включает все поля записи (принято по умолчанию) 


upWhereChanged Where включает ключевые поля и поля, которые были из- 
менены 


upWhereKeyOnly Where включает только ключевые поля 
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} 


Вариант upWhereAll наиболее надежен, поскольку распознает запись по зна- 
чениям всех ее полей. Но он и наиболее трудоемок, поскольку при большом коли- 
честве полей элемент Where получается очень большим. Вариант upWhere- 
Changed требует меньших затрат, но OH и менее надежен. Если, пока шло редакти- 
рование записи в данной транзакции, другая транзакция изменила в этой записи 
поля, отличные от измененных данной транзакцией, то фиксироваться результаты 
будут уже практически для другой записи. Еще менее надежен вариант 
upWhereKeyOnly, хотя он наиболее быстрый. Его можно рекомендовать только в 
случае, если есть уверенность, что данное приложение — единственное, модифи- 
цирующее таблицу на данном отрезке времени. 


10.3 InterBase — работа на платформе 
клиент/сервер 


10.3.1 Общие сведения 


Все рассмотренное выше по созданию сетевых приложений, работающих с ба- 
зами данных, относится и к платформе клиент/сервер. Но некоторые особенности 
этой платформы, в частности, создание обзоров — Views и использование храни- 
мых на сервере процедур, еще не обсуждались. Прежде, чем заняться этим, рас- 
смотрим в качестве примера работу с сервером InterBase. Это тем более оправдано, 
что в C++Builder имеется локальный сервер InterBase — Borland InterBase Server. 
Он является усеченной локальной версией Borland Workgroup сервера, который 
находит применение в больших реальных задачах. 

Borland InterBase Server позволяет в локальном варианте разрабатывать про- 
граммы, которые в дальнейшем будут работать на реальных системах. При этом во 
время разработки отпадает нужда в реальном отдельном сервере, можно не мани- 
пулировать реальными данными, рискуя их испортить, и не решать сложных сете- 
вых проблем. В этом и состоят преимущества локального сервера. 

В то же время приложение, отлаженное с использованием Borland InterBase 
Server, можно затем легко перенести на реальный сервер InterBase, а, учтя некото- 
рые особенности локальных диалектов SQL, можно перенести и на другие имеющие- 
ся на рынке системы, такие, как Informix, Microsoft SQL Server, Oracle, Sybase и др. 


10.3.2 Программа Server Manager 


Прежде, чем начинать работать с базами данных в Borland InterBase Server, 
ознакомимся с программой — диспетчером Server Manager. Она понадобится нам, 
в частности, чтобы зарегистрировать себя как пользователя. Это необходимо, так 
как создание и использование баз данных в InterBase потребует от нас указания 
пользователя, создавшего базу данных, и его пароля. 

Вызов Server Manager возможен из раздела главного меню C++Builder Tools, 
если раздел Server Manager туда включен, или непосредственным выполнением 
файла Ibmgr32.exe (он обычно расположен в каталоге ...\Program Files\IntrBase 
Согр\мегВазе\ВИМ или в ...\Program Files\Borland\|IntrBase\BIN). 

После вызова перед вами откроется окно, представленное на рис. 10.6 а. Точ- 
нее сначала панели этого окна будут пустыми. 

Прежде всего вам надо соединиться с сервером. Для этого. выполните команду 
File | ServerLogin. При этом вы увидите окно, представленное на рис. 10.6 6. В этом 
окне должен быть включен индикатор Local Engine — локальный сервер. В окнах pe- 
дактирования надо ввести имя пользователя (User Мате) и пароль (Password). Если 
вы хотите ввести нового пользователя (в данном случае — себя), то должны соеди- 
ниться под именем администратора баз данных. Это имя — SYSDBA. Пароль адми- 
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нистратора (если, конечно, он не изменен на вашем компьютере) — masterkey. Па- 
роль чувствителен к регистру, так что вводите этот пароль в нижнем регистре. 

Щелкните на ОК и окно Server Manager приобретет вид, показанный на 
рис. 10.6 а. 


Рис. 10.6. пели ие | ы 
rate “Ble Tasks Martenonce Window Heb Ea) [glee 


диспетчера 
Server Manager 
(a) и окно 

соединения с | | gta tite 
сервером (6). ae Es ae a Fe —_ 


_ “User Name. oo a 


Теперь попробуйте зарегистрировать себя как пользователя. Заодно, если вы 
собираетесь пользоваться базой данных InterBase — ib, которую вы можете найти 
на прилагаемом к книге диске, зарегистрируйте и меня: мое имя как пользовате- 
ля, на которое создана база данных — «А» (латинская буква), а пароль — «1». 
Кстати, поскольку в дальнейшем система не раз будет запрапгивать у вас имя и па- 
роль, то для учебных целей полезно имя делать предельно коротким, а пароль — 
тоже коротким и цифровым (это избавит вас от необходимости следить за тем, ка- 
кой язык в данный момент использует Windows — русский или английский). 

Чтобы зарегистрировать нового пользователя или изменить информацию о 3a- 
регистрированных пользователях, надо выполнить команду Tasks | User Security. Пе- 
ред вами откроется диалоговое окно, подобное представленному на рис. 10.7 a. 
Кнопки этого окна позволяют зарегистрировать нового пользователя (кнопка Add 
User), изменить информацию зарегистрированного пользователя, например, его па- 
роль (кнопка Modify User), удалить пользователя из списка (кнопка Delete User). 
Сейчас вы хотите ввести нового пользователя. Щелкните на кнопке Add User и в OT- 
крывшемся окне (рис 10.7 6) введите имя пользователя (User Мате), пароль 
(Password), его подтверждение (Confirm Password) — т.е. повторите его еще раз. В 
нижних окнах редактирования можете (но не обязательно) написать свои имя, от- 
чество и фамилию. Щелкните на ОК и в окне рис. 10.7 а должно появиться ваше 
имя как пользователя. 

Мы рассмотрели те операции с Server Manager, которые нам потребуются для 
дальнейшего. Остальные возможности Server Manager вам придется изучать само- 
стоятельно по встроенной в программу справке. 


10.3.3 Windows ISQL 


Программное средство Windows ISQL (Interactive SQL) представляет собой ин- 
терфейс для выполнения запросов SQL в интерактивном режиме или из специаль- 
ных файлов. 

В противоположность Paradox и dBase, которые.хранят таблицы в отдельных 
файлах, InterBase хранит все объекты базы данных в одном файле. Этот файл (а не 
каталог, как раньше) и является базой данных. 

Чтобы создать новый файл базы данных, надо сделать следующее: 

ш Вызовите WISQL — или из раздела меню Jools, если раздел WISQL туда вклю- 
чен, или непосредственно выполните файл Wisql32.exe для 32-разрядных вер- 
сий C++Builder (каталог ...\Program Files\InterBase Согр\тмегВазе\ВИМ)._ 
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Рис. 10.7. 
Окно данных о пользователях (а) и окно ввода 
информации о новом пользователе (6) 


© Modily User. | | 


ste Delete User | | 


Кстати, если вы намерены и дальше работать с WISQL, целесообразно вклю- 
чить его вызов в меню Jools (если его там нет). Для этого надо выполнить команду 
Tools | Configure Tools и указать в диалоговом окне место расположения выполняемо- 
го файла и имя соответствующего ему раздела меню (например, WISQL). 

После вызова WISQL перед вами откроется окно, показанное на рис. 10.8. Точ- 
нее, такой вид, как на рисунке, окно приобретет позднее, когда вы создадите базу 
данных и начнете с ней работать. 


Рис. 10.8. 


Окно WISQL 2 : Me 


Select Dep, Fam, Nam, Par, Year_b, Sex From Pers 


{Select Dep, Fam, Yam, . Year_b, Sex From Pi 


DEP NAM 


Бухгалтерия Maan 
Петр 
Cunop 
Ирима 
Николаев Николай 
Андрее Андрей 
Bopucon Борис 
Nasnons Павел 
AMTOMOEBSA AMTOMMNA 
MapurTronos xXapuTron 
Ивзмянымыкою Usanm 


Дальнейшие ваши действия должны сводиться к следующему. 


ш Выполните команду меню WISQL File | Create Database (вторая быстрая кнопка 
слева). 
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@ В диалоговом окне (рис. 10.9) напишите имя файла создаваемой базы данных 
(окно Database) с полным путем. Принятое расширение файлов баз данных в 
InterBase — .gdb. Введите также свое имя пользователя (окно User Мате) и па- 
роль (окно Password). 


@ Шелкните на ОК и база данных окажется созданной и соединенной с вами. 


Рис. 10.9. 
Окно создания новой базы данных InterBase 


Create Database 


Для созданной базы данных полезно установить псевдоним. Как это делать — 
рассмотрено в разделе 9.3 главы 9. Для базы данных, которую вы можете найти на 
диске, приложенном к книге, предусмотрен псевдоним №. 

После создания базы данных вы в последующие вызовы WISQL можете соеди- 
няться с ней с помощью команды File | Connect to Database (левая быстрая кнопка на 
рис. 10.8) В возникающем при этом диалоговом окне вы можете выбрать свою базу 
данных из выпадающего списка, который содержит сведения о нескольких послед- 
них контактах, или написать имя файла с путем заново, если его нет в выпадаю- 
щем списке. | 

Теперь перейдем к созданию таблицы. Она создается с помощью рассмотрен- 
ного ранее оператора SQL Create Table. Операторы SQL пишутся в верхней части 
диалогового окна WISQL (рис. 10.8). Например, упрощенный вариант таблиц базы 
данных 1, с которой мы в дальнейшем будем работать, может быть создан опера- 
торами: 


create table Pers ( 
Num smallint Not Null Primary Key, 
Dep char(15), 
Fam char(20) Not Null, 
Nam char(20) Not Null, 
Par char(20) Not Null, 
Year b smallint DEFAULT 1950, 
Sex char(1) DEFAULT 'mM', — 
Charact blob, 
Photo blob 
); 
\ 
create table Пер ( 
Dep char(15) Not Null Primary Key, 
Proisv char(l1) 
yee 


Обратите внимание, что в таблице Pers поле Sex (пол) имеет символьный тип 
размером в 1 символ, хотя для такого поля можно было бы использовать булев 
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тип. Нов InterBase нет булева типа, так что приходится пользоваться вместо него 
символьным. 

Более полный вариант создания таблиц базы данных № вы можете посмотреть 
на прилагаемом к книге диске. Подробное описание оператора Create Table, uc- 
пользуемого в этом полном варианте, вы можете найти в книге [8]. 

После того, как вы написали оператор создания таблицы, выполните команду 
Query | Execute (четвертая слева быстрая кнопка на рис. 10.8). Если в вашем опера- 
торе SQL нет ошибок, то в нижней части окна появятся результаты выполнения 
данного запроса. Если же в операторе обнаружились синтаксические ошибки, то 
появится окно с сообщением об ошибке (рис. 10.10). Оно, конечно, ничего вам не 
скажет кроме того, что была какая-то ошибка. Но не спешите щелкать на ОК и ис- 
кать сделанную ошибку. Щелкните лучше на кнопке Details (детали) и вы увидите 
окно, которое может выглядеть так, как показано на рис. 10.10 6. В данном случае 
в приведенном выше операторе была преднамеренно сделана ошибка: вместо 
«table» написано «tablet». Как видите, ошибка определена с точностью до символа: 
line 1, char 7 (строка 1, символ 7) и приведено нераспознанное слово — tablet. Так 
что просмотр детальных пояснений ошибок серьезно поможет вам в отладке. 


Рис. 10.10. <) ЕВЕ а 61 


Окна WISQL с [Statement faied SOLCODE = 104 
сообщением об о 
ошибке (a) и с 
детализацией 


ошибки (6) 


Если вы создали таблицу, можете попробовать ее заполнить с помощью опера- 
торов Insert Into языка SQL. Например: 
Insert Into PERS(Num, Dep, Fam, Nam, Par, Year b, Sex) 


Values(1l, "Бухгалтерия", "Иванов", "Иван", "Иванович", 
1950, "м") 


Выполнив этот оператор, вы создадите первую запись в таблице. Конечно, пи- 
сать для каждой записи такой длинный оператор — задача неблагодарная. К, сча- 
стью, этого делать не надо. Выполнив один оператор, выберите команду Query | 
Previous (пятая слева быстрая кнопка на рис. 10.8). Перед вами появится предыду- 
щий оператор и вам останется только заменить в нем содержание текстов в списке 
Values. | 

В подобном режиме вы можете выполнять любые запросы SQL: Select, Upda- 
te, Delete, Set transaction, Commit и др. 

При выполнении оператора выбора Select в нижнем окне вы увидите резуль- 
тат выполнения. Можете вычислять совокупные характеристики, использовать 
объединения и т.п. 

При расчетах можно устанавливать ряд опций оператором 


ЗЕТ <опция>; 


Отмена опции осуществляется оператором: “a 
SET <опция> OFF; 


Содержимое нижнего окна с результатами вы можете сохранить для после- 
дующего использования в текстовом файле, щелкнув для этого на кнопке Save 
Results и указав в диалоге имя файла. 

Когда вы завершаете работу с WISQL после каких-то изменений в базе дан- 
ных, программа задает вам вопрос: «Commit work for database?». Дело в том, что в 
процессе работы, если вы не использовали оператор Commit, все изменения прово- 
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дились во временной копии базы данных. И теперь вам задается вопрос: «Зафикси- 
ровать результаты в базе данных?». При положительном ответе данные будут за- 
фиксированы, а при отрицательном — нет. | 

Мы рассмотрели один из вариантов работы с WISQL — интерактивный, при 
котором в верхнем окне вводятся операторы SQL, кнопкой Execute query они выпол- 
няются, а в нижнем окне можно просмотреть результаты. Имеется и другой вари- 
ант — работа из файла запросов, который называется $сг1р%$-файлом. Это обычный 
текстовый файл с расширением .sql по умолчанию. Запуск выполнения запросов 
из файла осуществляется командой File | Run ап ISQL Script. 

Поскольку прежде всего надо связаться с интересующей вас базой данных (в 
интерактивном режиме вы выполняли для этого команду меню Не | Connect to 
Database), файл запросов обычно начинается с команды запроса соединения, KOTO- 
рая имеет следующий синтаксис: 


Connect <база данных> User <имя пользователя> Password <пароль>; 
Например: 
CONNECT "c:\test\ib.gdb" USER "А" PASSWORD "1"; 


Затем в файле могут размещаться любые запросы SQL. Можно вводить в текст 
комментарии в стиле С: /* <комментарий> */. 

Пример подобного файла вы можете найти на прилагаемом к книге диске. 
Этот файл createdb.sql создает базу данных ib.gdb, создает и заполняет ее табли- 
цы, создает в ней обзоры и хранимые процедуры (00 этих возможностях будет рас- 
сказано в следующих разделах). 

В заключение коротко остановимся на некоторых командах меню WISQL. 
Меню НЕ имеет раздел Drop Database, позволяющий уничтожить базу данных, с ко- 
торой в данный момент поддерживается связь. Раздел Save Result to а File позволяет 
сохранить в текстовом файле данные, полученные в окне результатов, а раз- 
дел Save Session to а File позволяет сохранить и сами запросы, и их результаты. 

Меню Session позволяет установить различные опции, определяющие состав и 
форму представления результатов в нижнем окне программы. Меню Metadata со- 
держит раздел Show — просмотра метаданных базы данных. Метаданные отобра- 
жают структуру компонентов, входящих в базу данных. Однако раздел Show позво- 
ляет только просмотреть список соответствующих таблиц, процедур и т.д. Более 
полезны разделы Extract Database, Extract Tables, Extract View, позволяющие извлекать 
метаданные — операторы SQL, с помощью которых была создана база данных или 
отдельные ее компоненты. 


10.3.4 Обзоры — Views 


Обзоры (views) — это дочерние образования таблицы, в которые помещается He- 
которое подмножество записей, содержащих все, или только указанные поля. Пусть, 
например, в некоторой организации имеется таблица персонала, подобная используе- 
мой нами таблице Pers. Из нее имеет смысл создать обзоры сотрудников, работающих 
в каждом подразделении, и раздать их руководителям подразделений. Тогда каждый 
руководитель будет иметь базу данных своих сотрудников, но не будет иметь доступа 
к сведениям о сотрудниках других отделов. А общая, базовая таблица имеется, на- 
пример, у руководства предприятия. При этом можно сохранять конфиденциаль- 
ность — в каждом отделе будут сведения только о своих сотрудниках, а какая-то кон- 
фиденциальная информация (какие-то поля) могут вообще не включаться в обзоры, а 
храниться только в общей таблице под паролем и быть доступными только избран- 
ным представителям администрации. Все обзоры и базовая таблица, на основе кото- 
рой они созданы, связаны друг с другом. Если в таблице или в каком-то обзоре прове- 
дены изменения (поступил на работу новый сотрудник, кто-то уволился, у кого-то из- 
менился адрес, телефон, семейное положение), все они тут же отразятся во всех обзо- 
pax, в которых есть соответствующие записи, и в базовой таблице. 
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Синтаксис оператор создания обзора следующий: 


CREATE VIEW <имя обзора> AS SELECT <список полей> 
FROM <таблица> WHERE <условие> 


В нашем примере этот оператор может иметь вид: 


CREATE VIEW DEP 1 AS SELECT Fam, Nam, Par, Year b, Sex 
FROM Pers WHERE Dep = 'Цех 1' 


Уничтожение ранее созданного обзора осуществляется оператором: 
DROP VIEW <имя обзора> 


Например, уничтожить обзор, созданный в приведенном выше примере, мож- 
но оператором: 


DROP VIEW Dep 1 


10.3.5 Хранимые Ha сервере процедуры 


10.3.5.1 Создание выполняемых процедур 


Клиенты, связанные с SQL сервером, могут обращаться к его мощностям для 
решения сложных задач. Это эффективнее, чем решать подобные задачи на более 
слабом компьютере клиента. К тому же, это позволяет минимизировать объемы 
информации, пересылаемой через сеть. Например, если пользователю нужно оты- 
скать только одну конкретную запись и просмотреть в ней некоторые поля, целесо- 
образно всю процедуру поиска выполнить на сервере, а пользователю переслать 
только интересующие его поля найденной записи. В идеале клиент должен полу- 
чать только тот минимум данных, которыми манипулирует пользователь. 

Многие серверы, в том числе InterBase, разрешают написание специальных 
процедур, хранимых и выполняемых на сервере. К сожалению, язык написания 
хранимых процедур различен в разных системах. И язык InterBase имеет мало об- 
щего с языком Sybase или Microsoft SQL сервера. 

InterBase поддерживает 2 вида хранимых процедур: выполняемые (Execute), 
которые могут передавать параметры и которые манипулируют данными, и проце- 
дуры выбора (Select), которые представляют собой таблицы только для чтения, HO 
которые воспринимают параметры, определяющие возвращаемые результаты. 

Рассмотрим сначала процесс создания выполняемых хранимых процедур. Про- 
стейший путь для этого — написание соответствующих $с:г1рё-файлов и их выполне- 
ние с помощью WISQL. Следует подчеркнуть, что использование интерактивного 
режима работы с WISQL для создания хранимых процедур не допускается. 

Структура соответствующего файла может иметь вид: 

CONNECT <база данных> USER <имя пользователя» 

PASSWORD <пароль>; 


SET AUTODLL OFF; 
SET TERM ^ $ 


CREATE PROCEDURE <имя процедуры> AS 
BEGIN 


SET. ‘TERM. ;^ 
° COMMIT; 

Первая команда Connect связывается с базой данных. Вторая команда Set от- 
ключает опцию AUTODDL. Это предотвращает процедуру от преждевременного 
создания. Следующая команда Set Term заменяет символ окончания «;» на «>. 
Зачем это надо? Операторы InterBase и операторы SQL, используемые при написа- 
нии текста процедуры, имеют одинаковые символы окончания — ‹;». Поэтому 
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транслятор не сможет разобраться, где операторы InterBase, а где операторы про- 
цедуры. Чтобы не возникало этой путаницы, команда Set временно заменяет сим- 
вол окончания операторов InterBase на «^». В результате транслятор будет знать, 
что если встретится оператор, кончающийся символом «“^» — это будет оператор 
InterBase. А символы окончания операторов процедуры остались прежними — ‹;». 

После рассмотренных подготовительных операторов следует оператор созда- 
ния процедуры Create Procedure, в котором указывается имя процедуры. После 
ключевого слова AS следуют операторы самой процедуры, начинающиеся с begin 
и кончающаяся end’. После этого оператора транслятор начинает обрабатывать 
дальнейшее как операторы InterBase. Следующий оператор Set Term переключает 
символ окончания на традиционный — ‹;», а оператор Commit фиксирует резуль- 
тат создания процедуры в базе данных. 

Файл может содержать операторы создания нескольких процедур. Каждая из 
них компилируется отдельно. Те, которые откомпилировались без синтаксических 
ошибок, будут записаны в базу данных. 

После того, как процедура создана, ee можно тестировать в WISQL в интерак- 
тивном режиме. Для вызова процедуры достаточно выполнить оператор 


EXECUTE PROCEDURE <имя>; 


Процедуры могут выполняться любым путем: интерактивно в WISQL, из при- 
ложения, могут вызываться из других процедур и даже из самих себя — т.е. пре- 
дусмотрена возможность рекурсии. 

Удалить из базы данных процедуру, которая оказалась ошибочной, можно 
оператором 


DROP PROCEDURE <имя>; 


Рассмотренная выше структура процедуры — простейшая. Она соответствует 
процедуре, в которую не передается никаких параметров и которая ничего не воз- 
вращает, а просто, например, изменяет базу данных. Рассмотрим теперь пример 
более сложной процедуры с параметрами. В эту процедуру с именем GetInf переда- 
ются фамилия, имя и отчество сотрудника. Процедура возвращает информацию о 
сотруднике: год рождения, подразделение, в котором сотрудник работает, и пол. 
Если запись сотрудника в базе данных не обнаружена, то в.качестве года рождения 
возвращается 0, что может являться для приложения, вызвавшего процедуру, сиг- 
налом отсутствия затребованной записи. 

Без учета стандартных начальных и конечных операторов создание такой про- 
цедуры осуществляется следующим кодом: 

CREATE PROCEDURE GetInf 

(pFam char(20), pNam char(20), pPar char(20) ) 

RETURNS (pYear integer, pDep char(15),pSex char(1)) 
AS 

BEGIN 

pYear=0; 

SELECT Year р, Dep, Sex From Pers 

WHERE (Fam=:pFam) and (Nam=:pNam) and (Par=:pPar) 

INTO pYear, pDep, pSex; 
END; ^ 


Просмотрев данный текст, вы можете увидеть, что передаваемые в процедуру 
параметры определяются через прискобочную запись, следующую за именем про- 
цедуры, причем для каждого параметра указывается его тип. Это очень похоже на 
объявление процедуры в любом алгоритмическом языке. Возвращаемые парамет- 
ры указываются аналогичным образом после ключевого слова RETURNS. В при- 
веденной процедуре все имена начинаются с символа «р», но это, конечно, не обя- 
зательно. Просто подобное обозначение позволяет легче читать текст процедуры и 
не путать параметры с именами полей. 
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Тело процедуры состоит всего из двух операторов. Первый из них задает значе- 
ние возвращаемого параметра рУеаг, равное нулю. Второй оператор Select ищет за- 
пись, в которой значения полей Fam, Мат и Par совпадают соответственно с задан- 
ными значениями фамилии, имени и отчества (параметрами pFam, pNam и рРаг). 
Если такая запись нашлась, то в параметры pYear, pDep и pSex (указаны после клю- 
чевого слова Into) передаются значения полей Year_b, Dep и Sex, указанных после 
ключевого слова Select. Таким образом конструкция Select ... Into позволяет зано- 
сить результаты отбора в параметры. Если искомая запись отсутствует в базе данных, 
оператор Select ничего в параметры не заносит. Следовательно, в возвращаемом пара- 
метре рУеаг останется 0, присвоенный предыдущим оператором. Это будет сигналом 
для программы, вызвавшей данную процедуру, об отсутствии записи. 

Вызов такой процедуры из WISQL может осуществляться оператором вида: 


EXECUTE PROCEDURE СЕТТМЕ ("Иванов", "Иван", "Иванович") 


Приведенная процедура иллюстрирует некоторые возможности описания вы- 
полняемых хранимых процедур. В процедурах можно использовать циклы, опера- 
торы условной передачи информации и многое другое. В подробностях это все 
можно посмотреть во встроенной в WISQL справке. 

В процедурах можно вводить внутренние локальные переменные. Они вводят- 
ся конструкцией вида 


DECLARE VARIABLE <список переменных и их типов> 


помещаемой после ключевого слова as. 


10.3.5.2 Вызов выполняемых хранимых процедур из приложения 


Для вызова выполняемых хранимых на сервере процедур в библиотеке 
C++Builder на странице Data Access имеется компонент StoredProc. Он позволяет 
передавать информацию в хранимые процедуры и воспринимать возвращаемую 
информацию с помощью параметров. 

Перенеся на форму компонент StoredProc, надо прежде всего установить его 
свойство DatabaseName, выбрав из списка псевдоним базы данных, с которой вы 
хотите работать. Затем можно установить свойство StoredProcName. В выпадаю- 
щем списке этого свойства перечислены хранимые SPOOKY Pes определенные в 
базе данных. 

Входные параметры процедуры заносятся в процессе работы в свойство 
Params. Имена параметров, содержащихся в этом свойстве, вы можете узнать, по- 
смотрев это свойство с помощью Инспектора Объектов. При этом вы увидите то же 
окно установки атрибутов параметров, которое ранее было рассмотрено в компо- 
ненте Query (рис. 10.1). Остановимся только на одном свойстве, которое ранее не 
рассматривалось — ParamType. Это свойство — тип параметра, указывающий на 
способ его использования, может принимать значения: 


И НК вы HAR OSLER ILLS LLLP ОА АИ Я ОР BELGE PESESELAPILBEARBERBE ARIEL BAGG EI: 


“ptUnknown Tun неизвестен или “He определен. В этом случае перед. выпол- 
нением процедуры необходимо установить этому параметру 
другой, определенный тип 


р при Входной параметр, передаваемый в процедуру 
ptOutput Выходной параметр, возвращаемый из процедуры 
ptInputOutput Параметр может использоваться и как входной, и как выходной. 


ptResult Параметр используется как возвращаемая величина. Обычно 
применяется для возвращения сообщений об ошибках или о 
режиме завершения. Хранимая процедура может иметь толь- 
ко один параметр такого типа 
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Если вы связываете компонент StoredProc с конкретной процедурой во время 
проектирования, то свойства РагатТуре всех параметров устанавливаются авто- 
матически в соответствии с описанием процедуры. Так что вам не приходится их 
устанавливать вручную. 

Перед вызовом процедуры приложение должно занести в Params значения па- 
раметров. Свойство ParamBindMode компонента StoredProc задает способ про- 
граммного доступа к параметрам. Это свойство может принимать значения: 
pbByName — доступ по имени и pbByNumber — доступ по индексу. Как правило, 
используется доступ по имени методом РагатВуМаше. Например, Stored- 
Ргос1->РагатВуМате("РЕАМ") — значение параметра PFAM. В редких случаях, 
когда имена параметров неизвестны, можно использовать доступ по индексу. По- 
следовательность параметров в свойстве Params определяется последовательно- 
стью их определения в объявлении процедуры. Например, StoredProcl-> 
Params->Items[0] — значение первого параметра. 

Вызов процедуры осуществляется методом ExecProc. Возвращаемые процеду- 
рой значения ее выходных параметров могут быть взяты из свойства Params. Они 
располагаются там после входных параметров. При получении результатов может 
быть использован метод ParamByName или доступ по индексу. 

Постройте пример, использующий рассмотренную ранее процедуру GetInf. 
Введите в приложение окна редактирования FamEdit, NamEdit и ParEdit, в кото- 
рых пользователь может задавать фамилию, имя и отчество сотрудника, информа- 
ция о котором его интересует. Введите также метки LDep, LYear и LSex, в кото- 
рых будет отображаться возвращаемая процедурой информация. И введите кноп- 
ку Выполнить, при щелчке на которой должен выполняться код: 

StoredProcl->ParamByName ("PFAM")->AsString = FamEdit->Text; 

StoredProcl->ParamByName ("PNAM")->AsString = NamEdit->Text; 

StoredProcl->ParamByName ("PPAR") ->AsString = ParEdit->Text; 

StoredProcl->ExecProc(); 

if (StoredProci->ParamByName ("PYEAR")->AsInteger == 0) 


Application->MessageBox("B базе данных запись отсутствует", 
` "Ошибка", МВ ОК); 


else 


{ 
LDep->Caption = StoredProcl->ParamByName ("PDEP")->AsString; 
LYear->Caption = StoredProcl->ParamByName ("РУЕАВ") ->AsString; 
LSex->Caption = StoredProcl->ParamByName ("PSEX") ->AsString; 

} 


Приведенный код, вероятно, в дополнительных комментариях не нуждается. 
Запустите ваше приложение и попробуйте с его помощью получить информацию о 
сотруднике, о котором в базе данных имеется запись, и о сотруднике, отсутствую- 
щем в базе данных. Для контроля полезно добавить к приложению контрольную 
таблицу, которая отображала бы содержимое базы данных. 

На диске вы можете найти более развернутый пример, работающий с процеду- 
рами базы данных ib. 


10.3.5.3 Хранимые процедуры выбора 


Рассмотренные ранее выполняемые процедуры возвращали параметры. В от- 
личие от них процедуры выбора возвращают множество результатов, таблицы. 
Как пример, рассмотрим процедуру выбора с именем Selectd, возвращающую 
информацию о сотрудниках, работающих в указанном отделе. 
CREATE PROCEDURE Selectd (pDep срах (15) ) 
RETURNS (pFam char(20), pNam char(20), 
pPar char(20), pYear integer, PSex char(1)) 


AS 
BEGIN 


20 зак. 322 
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FOR SELECT, Fam, Nam, Par, Year b, Sex From Pers 
WHERE (Dep=:pDep) 
INTO pFam, pNam, pPar, pYear, pSex 
DO 
SUSPEND; 
END; ^ 

Заголовок оператора Create Procedure выглядит Tak же, как и для выполняе- 
мой процедуры. В нем определяется передаваемый параметр (в данном случае 
pDep) и возвращаемые параметры, перечисляемые в списке после ключевого слова 
Returns. Так же, как в выполняемой процедуре, используется блок begin...end, 
хотя в процедурах выбора в нем обычно имеется только один оператор For Select. 
Этот оператор осуществляет выбор, как и оператор Select ... Into в выполняемых 
процедурах, но отличается от него следующими особенностями. Он обрабатывает 
не сразу всю таблицу, а по одной записи за раз, причем имеется блок Во, обрабаты- 
вающий каждую возвращенную запись. В данном примере (и обычно) этот блок ис- 
пользует ключевое слово SUSPEND, означающее возвращение записи в предложе- 
‚ ние SQL, вызвавшее данную процедуру. 

Для использования хранимой на сервере процедуры выбора не требуется ника- 
кой специальной команды, как для выполняемых процедур. Вызов осуществляет- 
ся обычной командой Select, в которой имя процедуры выбора фигурирует как 
обычная таблица. Только в данном случае для этой таблицы могут указываться па- 
раметры. Например, из WISQL вызов приведенной процедуры имеет вид: 


Select * from Selectd ("Бухгалтерия") 


В этот оператор Select можно включать вычисления совокупных характери- 
стик и вообще работать с процедурой выбора как с обычной таблицей. 

Из приложения C++Builder процедуру выбора можно вызывать элементом 
Query, не используя StoredProc, с помощью аналогичного оператора Select. Впро- 
чем, можно использовать и StoredProc. Это, однако, менее удобно, так как при 
этом нельзя включать результат в предложения SQL. 


10.4 Доступ к базам данных через 
Microsoft ActiveX Data Objects (ADO) 


10.4.1 Соотношение между компонентами BDE и ADO 


В C++Builder 5 появилась возможность работы с базами данных посредством 
разработанной в Microsoft технологии ActiveX Data Objects (ADO). ADO — это 
пользовательский интерфейс к любым типам данных, включая реляционные и не 
реляционные базы данных, электронную почту, системные, текстовые и графиче- 
ские файлы. Связь с данными осуществляется посредством так называемой техно- 
логии OLE DB. 

Использование ADO является альтернативой Borland Database Engine (BDE), 
обеспечивающей более эффективную работу с данными. Для использования этой 
возможности на вашем компьютере должна быть установлена система ADO 2.1 или 
более старшая версия. Кроме того должна быть установлена клиентская система 
доступа к данным, например, Microsoft SQL Server, а в ODBC должен иметься 
драйвер OLE DB для того типа баз данных, с которым вы работаете. 

Для работы с ADO в C++Builder 5 предусмотрены компоненты, расположен- 
ные на новой странице библиотеки — ADO. Они инкапсулируют такие объекты 
ADO, как Connection, Command и Recordset. Это обеспечивается соответственно 
новыми компонентами C++Builder ADOConnection, ADOCommand и ADOData- 
Set. 
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_ Связь с базой данных в технологии ADO осуществляется обычной цепочкой: 
набор данных => источник данных (компонент DataSource) => компоненты управ- 
ления и отображения данных (DBGrid, DBEdit и др.). Отличие заключается только 
в первом звене этой цепочки, в котором вместо компонентов, расположенных на 
странице Data Access библиотеки используются компоненты, расположенные на 
странице ADO. 

Большинство компонентов, предназначенных для работы с ADO, аналогичны 
прежним компонентам, работающим с BDE: 


| Компонент ADO Компонент BDE 


| 
| ADOTable 


| ADOQuery | Query 


| ADOStoredProc StoredProc 
ADOConnection Database.) oui ead 
_ADODataSet Table, Query, StoredProc 


| ADOCommand 


| RDSConnection Roar een 


Ниже приведена краткая характеристика основных компонентов ADO. 


ДА $ LEA ROS IPE ROL GBA LIE IIE ELIE LOLE IE BOLI IGS LE ELLE SEN, LIEBER РАО АЛАНИИ IID LLIN ELLE ESEELEE BEER LAIEERLPBIE REEL CEE GED PGI ДРАКА Я АКА И SERGE BE Я oe eth Bb Beaty 


ADOConnection Используется для связи с набором д ‘данных x ADO. "Может pa- 
ботать с несколькими компонентами наборов данных как 
диспетчер выполнение их команд 


ADODataSet Универсальный компонент связи с наборами данных, KOTO- 
рый может работать в различных режимах, заменяя свя- 
занные с BDE компоненты Table, Query, StoredProc. Mo- 
жет связываться с одной или множеством таблиц. Связь 
осуществляется непосредственно, или через ADOConnection 


ADOTable Используется для работы с одной таблицей. Может связы- 
ваться с ней непосредственно, или через ADOConnection 


ADOQuery _ Используется для работы.с набором данных с помощью 3a- 
просов SQL, включая такие запросы языка DDL (data defi- 
nition language), как CREATE TABLE. Может связываться 
с набором данных непосредственно, или через ADOConnec- 
tion 


ADOStoredProc Используется для выполнения процедур, хранимых Ha сер- 
вере. Может связываться с набором данных непосредствен- 
но, или через ADOConnection 


ADOCommand — Используется в основном для выполнения команд SQL, не 
возвращающих множество результатов. Может также со- 
вместно с другими компонентами использоваться для рабо- 
ты с таблицами. Может связываться с набором данных не- 

‚ посредственно, или через ADOConnection 


В качестве общей характеристики можно сказать, что в некоторых отношени- 
ях компоненты ADO мощнее компонентов ВПЕ, но в то же время ряд возможно- 
стей компонентов ВПЕ в них не реализован. Например, они не могут использовать 
словари свойств, что приводит к лишней работе при создании приложений. Не все 
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источники данных ADO могут работать со всеми типами полей. Например, источ- 
ник данных Paradox ADO не работает с графикой. Так что надо серьезно рассмат- 
ривать все за и против, прежде чем переходить от BDE к ADO. 


10.4.2 Задание соединения компонентов ADO с базой данных 


В отличие от компонентов BDE — Table, Query и других, в компонентах ADO 
нет свойства DatabaseName, указывающего базу данных. Доступ к базе данных 
осуществляется или с помощью строки соединения — свойства ConnectionString, 
или с помощью отдельного компонента ADOConnection, имя которого задается в 
свойстве Connection других компонентов. 

Рассмотрим соединение с базой данных с помощью свойства ConnectionString 
на примере компонента ADOTable. Свойство ConnectionString представляет собой 
строку, содержащую параметры соединения. Отдельные параметры отделяются 
друг от друга точками с запятой. В C++Builder предусмотрено специальное диало- 
говое окно, облегчающее работу по формированию строки соединения. 

Перенесите на форму компонент ADOTable и в Инспекторе Объектов нажмите 
кнопку с многоточием около свойства ConnectionString. Перед вами откроется 
окно, показанное на рис. 10.11. Верхняя радиокнопка Use Data Link File позволяет ис- 
пользовать файл связи .udl. На этих файлах, используемых в Windows, мы останав- 
ливаться не будем. Вы можете найти материал о них в книгах [7] и [8]. Нижняя ра- 
диокнопка Use Connection String позволяет сформировать строку соединения в режиме 
диалога. Включите эту радиокнопку и нажмите кнопку Build (Сформировать). 


Рис. 10.11. 
Первое диалоговое окно задания 
строки соединения 


Перед вами откроется многостраничное окно задания свойств соединения. На 
странице Provider вы должны указать провайдер OLE DB, который собираетесь ис- 
пользовать для доступа к данным. Во многих случаях вас устроит выбор Microsoft 
OLE DB Provider for ODBC Drivers. Однако, например, для работы с Microsoft SQL 
Server или Oracle надо выбрать другие разделы списка. 

Выбрав провайдер, вы должны перейти на страницу Connection (рис. 10.12). 
Впрочем, если вы на странице Provider нажмете кнопку Next, то этот переход свер- 
шится автоматически. 

На странице Connection вы должны указать, как вы будете соединяться с 
ODBC. Выбрав кнопку Use data source name, вы можете задать из выпадающего спи- 
ска имя источника данных (data source name — DSN), зарегистрированного в 
ODBC. Кнопка Use connection string позволяет вам задать строку соединения само- 
стоятельно, не прибегая к зарегистрированным DSN. 

Выберите кнопку Use connection string и нажмите Build. Перед вами откроется 
окно, представленное на рис. 10.13. В нем вы можете выбрать один из зарегистри- 
рованных в ODBC файлов источников данных. Если нужного вам файла источника 
нет в списке, вы можете добавить его, используя кнопку New. Например, первона- 
чально на вашем компьютере может не быть источников данных ib, Intehbase, 
Paradox, показанных на рис. 10.13. Тогда, чтобы создать новый файл источника, 
нажмите кнопку New. 
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=. Data Link Properties x 


_ Provider | Connection advanced м 


Рис. 10.12. 
Страница Connection основного окна задания 
свойств соединения 


"Speci the f ie © Girne. lo ODet dala 
ae бресёу the source of data: ее 
Г. вены И. 


6 ‘Use cgnnection sting 
^ Donnection. sting 


ото ineace esc Div ‚вы. af 


(gee information to, log on wo the se server a sh oe ater a : 


Г а name: a 


5 “Ente th the il swab louse: 
—_ [aNdatabase\cbibase — 


Рис 10 13 Select Data Source 
Выбор источника данных НОЯ 
Lookin [Das Sources es 


; dBASE Files inot гр an | ~ Interbase. den 
+ dbP.dsn $ MS Access 97 Database (по! s: | 


; Excel Files (not sharable). dsn $ Paradox.dsn 
FoxPro Files (not sharable). dsn F Text Files (not sharable). dsn 
b ib.dsn 


Перед вами пройдет череда диалоговых окон, в которых вы должны указать 
характеристики создаваемого источника данных. Если вы создаете источник дан- 
ных InterBase, вам надо указать в них драйвер INTERSWOLYV InterBase ODBC Driver 
(*.gdb). При создании источника данных Paradox выберите драйвер Microsoft Paradox 
Driver (*.dbf). После этого вам надо задать произвольное имя нового источника дан- 
ных. Далее вам потребуется указать базу данных, для которой вы создаете источ- 
ник, и такие характеристики, как имя пользователя, пароль и т.п. После всего 
этого вы опять увидите окно рис. 10.13, но в нем уже будет созданный вами источ- 
ник данных. 

После того, как в окне рис. 10.13 вы выбрали существовавший ранее или соз- 
данный новый файл источника данных, вы вернетесь в основное окно задания 
свойств соединения на страницу Connection (рис. 10.12). Если вы щелкнете на ОК, 
то вернетесь в окно рис. 10.11, в котором в нижнем окошке будет записана сфор- 
мированная вами строка соединения. Дл InterBase она может иметь вид: 

Provider=MSDASQL.1;Password=1;Persist Security Info=True; 


User ID=a;Mode=Read|Write;Connect Timeout=15;Extended 
Properties="DRIVER={INTERSOLV InterBase ODBC Driver 
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(*.gdb) } ; UID=A; DB=D: \Database\dbIbase\Ib.gdb; PWD=1"; Locale 
Identifier=1049; Initial Catalog=D:\Database\dbIbase 


Для Paradox сформированная строка соединения может иметь вид 


Provider=MSDASQL.1; Persist Security Info=False; Extended 
Properties="CollatingSequence=ASCII; DBQ=D:\DATABASE\DBPAR; 
DefaultDir=D:\DATABASE\DBPAR; Driver={Microsoft Paradox Driver 

(*.db )}; DriverId=538; FiL=Paradox 5.X; FILEDSN=C:\Program 
Files\Common Files\ODBC\Data Sources\Paradox.dsn; MaxBufferSize=2048; 
MaxScanRows=8; PageTimeout=5; ParadoxNetPath=C: \WINDOWS\SYSTEM; 
ParadoxNetStyle=3.x; ParadoxUserName=admin; SafeTransactions=0; 
Threads=3; UID=admin; UserCommitSync=Yes;" 


Как видите, в результате не слишком сложного диалога сформировались стро- 
ки, которые иным способом записать было бы весьма трудно. 

В окне рис. 10.12 вы можете также занести дополнительную информацию: 
имя пользователя (User name), пароль доступа (Password), ввести начальный ката- 
лог (Enter the initial catalog to use). Введенное вами имя пользователя занесется в стро- 
ку соединения в виде параметра (см. приведенные выше текст для ib), например: 


User 1Р=а; 


В дальнейшем это имя (в данном примере — «a») будет отображаться в окне 
запроса пароля при соединении с базой данных. Но пароль сам по себе в строку со- 
единения не занесется, если только вы не включите индикатор Allow saving 
password. Тогда в строку соединения занесется соответствующий параметр, напри- 
мер: 

Password=1; 


В этом случае в дальнейшем при соединениях пароль может не запрашивать- 
ся, аесли и будет запрошен, то пользователь сможет его не вводить. Но учтите, что 
тем самым вы рассекретите свой пароль для пользователя, который имеет доступ к 
вашим исходным файлам C++Builder. 

Включение индикатора Blank password также разрешит пользователю при за- 
просе пароля во время соединения с базой данных не вводить пароль. Но при этом, 
если пароль не запомнен в строке соединения, то с базой данных, защищенной 
этим паролем, соединение установить не удастся. 

Кнопка Test Connection позволяет вам проверить правильность всей информа- 
ции. При нажатии на эту кнопку происходит соединение с базой данных. Если все 
нормально, будет показано окно с надписью: «Test connection succeeded», свиде- 
тельствующей о нормально произведенном тестировании соединения. Если в сфор- 
мированной строке соединения что-то неправильно, вам будут выданы сообщения 
об ошибках. 

После завершения формирования строки соединения, вы можете перейти в 
окне рис. 10.12 на страницу Advanced и задать режимы работы с сетью. Страница 
All сообщает итоговую информацию о соединении и позволяет ее отредактировать. 

После того, как вы завершили все операции по формированию строки соедине- 
ния, нажмите ОК и сформированная строка появится в свойстве ConnectionString 
компонента. 

Описанные выше операции формирования строки соединения достаточно гро- 
моздки. Хотелось бы, проведя их один раз, запомнить и в дальнейшем использо- 
вать при задании соединения других компонентов. K тому же, при смене каталога, 
в котором расположена база данных, хотелось бы не повторять опять корректиров- 
‚ ку строки соединения всех приложений, использующих эти данные. Подобное об- 
легчение своей последующей работы можно сделать двумя способами: создать тре- 
буемый вам источник данных или создать файл соединения. 

Но эти возможности из-за ограничения объема книги вам придется изучить са- 
мостоятельно по встроенной справке C++Builder 5 или посмотреть в книгах [7] и [8]. 
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10.4.3 Соединение с помощью компонента ADOConnection, 
управление транзакциями 


Соединение компонентов с базами данных можно осуществлять не только че- 
рез свойство ConnectionString, как описано в предыдущем разделе, но и через 
свойство Connection, связывающее данный компонент с компонентом ADOConnec- 
tion. В этом компоненте ADOConnection, осуществляющем диспетчеризацию ра- 
боты с набором данных, соединение задается свойством ConnectionString. А во 
всех прочих компонентах наборов данных достаточно установить в свойстве 
Connection имя компонента ADOConnection. 

Соединение с базой данных компонентов наборов данных, связанных с 
ADOConnection, происходит, даже если в самом ADOConnection He предпринима- 
ется никаких действий для открытия базы данных. Достаточно в компоненте набо- 
ра данных установить свойство Active = true, и он свяжется с набором данных. 
При этом свойство Connected компонента ADOConnection, показывающее наличие 
соединения, автоматически установится в true. Тогда встает вопрос: «Зачем же ну- 
жен компонент ADOConnection?>». 

Компонент ADOConnection позволяет управлять атрибутами и условиями со- 
единения подключенных к нему компонентов наборов данных. Свойства ADO- 
Connection дают возможность задавать схему блокировки записей, тип курсора, 
уровень изоляции и многое другое. Методы ADOConnection обеспечивают управ- 
ление транзакциями. Именно из-за этих особенностей и используется ADO- 
Connection. 

Во время выполнения соединение ADOConnection с базой данных осуществля- 
ется методом Ореп: 


HIDESBASE void __fastcall Open(const WideString UserID, 
const WideString Password); 


Например: 
ADOConnectionl->Open("A","1"); 


Параметры UserID — идентификатор пользователя и Password — пароль He 
обязательны. Они, как было описано в разделе 10.4.2, могут быть заданы в строке 
соединения — свойстве ConnectionString. Эту информацию приложение может по- 
черпнуть также из диалогового окна, предъявляемого пользователю при соедине- 
нии с базой данных. Это окно отображается, если установить свойство Login- 
Prompt компонента ADOConnection в true. Если используется это значение Login- 
Prompt, то имя пользователя и пароль можно не задавать ни в строке соединения, 
ни в вызове Ореп. 

Закрывается соединение с базой данных методом Close. Свойство KeepCon- 
nection определяет, сохраняется ли соединение с базой данных, даже если база 
данных не открыта. Установка KeepConnection в true (по умолчанию) сокращает 
затраты времени и загрузку сети при соединениях с базой данных, но увеличивает 
затраты ресурсов компьютера. 

Существует также метод CloseDataSets, закрывающий соединение всех ком- 
понентов наборов данных, соединенных с данным компонентом ADOConnection, 
HO не закрывающий соединение самого ADOConnection. 

Альтернативным способом установления и разрыва соединения с базой данных 
является установка соответственно в true или false свойства Connected. Это свойст- 
во можно также использовать для проверки успешности соединения. Если значение 
Connected равно true, значит соединение активно. Если значение Connected равно 
false и KeepConnection также равно false, то соединение неактивно. 

Свойство Connected компонента ADOConnection связано со свойствами Active 
компонентов наборов данных, подключенных к данному ADOConnection. Если 
Connected = false, а в одном из подключенных компонентов набора данных свойст- 
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Bo Active переключается в true, то Connected автоматически устанавливается в 
true. Если же ADOConnection разрывает соединение методом Close или установ- 
кой Connected в false, то свойства Active всех подсоединенных компонентов сбра- 
сывается в false. Этим и ограничивается связь свойств Connected и Active. Если 
после разрыва соединения компонент ADOConnection снова устанавливает соеди- 
нение методом Open или заданием Connected = true, то свойства Active подсоеди- 
ненных компонентов остаются равными false. Следовательно эти компоненты не 
подключаются к базе данных. В этом случае надо принять специальные меры для 
их подключения. 

Для этого можно воспользоваться свойством DataSets компонента ADO-. 
Connection, которое является массивом всех компонентов наборов данных, подсое- 
диненных к данному компоненту ADOConnection. Количество таких объектов оп- 
ределяется свойством DataSetCount. Эти свойства можно использовать, чтобы 
управлять всеми подсоединенными компонентами наборов данных. Например, 
код: 

for(int i = 0; i < ADOConnectionl->DataSetCount; i++) 

ADOConnectionl->DataSets[i]->Active = true; 


обеспечивает активацию соединения с базой данных всех компонентов наборов | 
данных. 

Свойство CursorLocation определяет, какую библиотеку использует курсор 
при соединении с базой данных: клиентскую или сервера. Значение clUserClient 
(по умолчанию) обеспечивает большую гибкость. Все данные располагаются на 
компьютере — клиенте и тут же обрабатываются. При этом возможны операции 
сортировки и другие, которые могут не поддерживаться сервером. Впрочем, пред- 
ложения SQL и в этом случае выполняются на сервере и на компьютер клиента пе- 
редаются уже отобранные данные, соответствующие условию WHERE предложе- 
ния SQL. 

Значение свойства CursorLocation, равное clUseServer, желательно использо- 
вать в командах, возвращающих большой объем данных. В подобных случаях ис- 
пользование клиентского курсора может потребовать недопустимых затрат диско- 
вого пространства клиента. | 

Теперь рассмотрим управление транзакциями. Транзакция начинается мето- 
дом BeginTrans, который возвращает целое число, показывающее уровень вло- 
женности данной транзакции. Успешное выполнение BeginTrans приводит к гене- 
рации события OnBeginTransComplete и установке свойства InTransaction в true. 
По значению этого свойства можно определить, находится ли компонент в состоя- 
нии формирования транзакции. А обработчик события OnBeginTransComplete 
можно использовать для выполнения каких-то действий перед началом транзак- 
ции. 

Метод CommitTrans завершает транзакцию и сохраняет ее результаты в базе 
данных. При успешном выполнении CommitTrans генерируется событие ОпСот- 
mitTransComplete и свойство InTransaction устанавливается в false. 

Метод RollbackTrans осуществляет откат: отменяет все изменения, сделанные 
на протяжении транзакции. При успешном выполнении RollbackTrans генериру- 
ется событие OnRollbackTransComplete и свойство шТгапзас Йоп устанавливается 
в true. 

Свойство Attributes описывает, как при соединении обрабатываются транзак- 
ции, оставшиеся незавершенными. Свойство является множеством, которое может 
быть пустым, или содержать одно или два значения: xaCommitRetaining и ха- 
AbortRetaining. 

Значение xaCommitRetaining приводит к тому, что при соединении незавер- 
шенные транзакции завершаются (срабатывает метод CommitTrans). Завершение 
транзакции автоматически вызывает начало новой транзакции. 
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Значение xaAbortRetaining приводит к тому, что при соединении незавер- 
шенные транзакции отменяются с откатом назад (срабатывает метод Rollback- 
Trans). Отмена транзакции автоматически вызывает начало новой транзакции. 

Свойство IsolationLevel устанавливает уровень изоляции транзакции. Основ- 
ные уровни: 


в а а а а о а Я О а ES AAS LIVES OLE SERED аа вай 


ilReadUncommit- Видимы незафиксированные изменения, сделанные 
ted, ilBrowse другими транзакциями 


IlReadCommitted, Видимы только зафиксированные изменения, сделан- 
ilCursorStability ные другими транзакциями 


ilRepeatableRead — Изменения, сделанные другими транзакциями, не вид- 
ны, но повторный запрос может выдать новые данные 


IlSerializable, Полная изоляция OT других транзакций 
ilIsolated 


10.4.4 Обзор компонентов наборов данных 


Рассмотрим сначала особенности компонентов наборов данных ADO на приме- 
pe ADOTable. Этот компонент может использоваться в приложениях вместо ком- 
понента Table, выполняющего аналогичные функции. Он вступает в контакт с 
указанной таблицей базы данных. База данных задается свойствами Connection- 
String или Connection, как описано в разделе 10.4.2. Для управления таблицей в 
приложение вводится, помимо компонента ADOTable, обычный компонент источ- 
ника данных DataSource, в свойстве DataSet которого задается имя компонента in 
ADOTable. Далее к этому источнику данных DataSource подключаются любые 
компоненты отображения данных. 

Имя таблицы, как и в компоненте Table, задается свойством TableName. Од- 
нако, не все провайдеры поддерживают непосредственный доступ к таблице по ее 
имени. Они могут требовать доступ с помощью оператора SQL SELECT. Какой 
именно вариант доступа: прямой или через оператор SELECT будет использовать- 
ся, определяется свойством TableDirect. По умолчанию TableDirect = false, что 03- 
начает автоматическое создание компонентом ADOTable соответствующего опера- 
тора SELECT. 

Соединение с базой данных осуществляется так же, как и в компонентах BDE, 
методом Open или установкой в true свойства Active. Но при этом, если связь с ба- 
зой данных осуществляется через компонент АБОСоппес оп, надо учитывать 
описанную в разделе 10.4.3 взаимосвязь свойства Active компонента ADOTable и 
свойства Connected компонента ADOConnection. 

В компоненте ADOTable имеется два свойства, характеризующих курсор, ис- 
пользуемый при навигации по таблице. Одно из них — CursorLocation описано в 
разделе 10.4.3. Другое — CursorType описывает другие характеристики курсора. 
Это свойство может иметь значения: 


ЗИ ВИК ВНЕ ВЕРОНЕ ОРЛЕ РЗ ПРИЛЕТ ИИ НИНЕ ЗАННИ РУПИЯ АРА ИИ ЧИ GRRE: 


ctUnspecified Tum курсора He определен 


ctOpenForwardOnly Курсор может перемещаться, по таблице только впе- 
ред. Этот тип курсора повышает производительность 
приложения 
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ctKeyset При этом типе курсора записи, добавленные другими 
пользователями, невидимы, а записи, удаленные дру- 
гими пользователями, недоступны. Этот тип использу- 
ется по умолчанию 


ctDynamic Этот тип динамического курсора обеспечивает види- 
мость всех изменений, сделанных другими пользова- 
телями: модификаций, удалений, вставок. Курсор мо- 
жет перемещаться по таблице вперед и назад 


ctStatic Этот тип статического курсора обеспечивает копирова- 
ние записей. Изменения данных, сделанные другими 
пользователями, невидимы 


Свойство CacheSize указывает, сколько записей заносится в локальный буфер 
оперативной памяти. По умолчанию CacheSize = 1. Если задать, например, Cache- 
Size = 10, то при открытии базы данных в буфер загрузятся первые 10 записей. 
Пока будет идти работа с этими записями, все операции будут проводится в опера- 
тивной памяти без обращения к базе данных. Если указатель таблицы вышел за 
пределы 10, то в память загрузятся следующие 10 записей и т.д. Естественно, что 
буферизация записей повышает, эффективность работы. 

Основные способы работы с ADOTable не отличаются от способов, работы & 
компонентом Table. Точно так же, как в компонентах Table и Query, двойной щел- 
чок на компоненте вызывает редактор полей, в котором можно задать свойства от- 
дельных полей, ничем не отличающиеся от полей компонентов BDE. Впрочем, 
одно печальное отличие есть: в компонентах ADO невозможно работать со словаря- 
ми. Так что в каждом компоненте свойства полей приходится задавать вручную. 
Кроме того надо иметь в виду, что не все драйверы ADO могут работать с любыми 
типами полей. Например, драйвер Paradox ADO не работает с полями изображе- 
ний. Так что в таблице Pers базы данных dbP, частично используемой в данной 
книге, не будет доступно поле Photo — фотографии сотрудников. Для драйвера 
InterBase (в наших примерах для базы данных ib) такого ограничения нет. 

Из редактора полей так же, как в компонентах BDE, можно перетаскивать 
поля. мышью на форму. При этом на форме автоматически будут создаваться соот- 
ветствующие компоненты отображения данных. 

Программный доступ к полям осуществляется так же, как в компонентах 
Table и Query: по индексу через свойство Fields[i:integer], по имени поля с помо- 
щью метода FieldByName("<uma>"), по имени объекта поля. 

Ограничения на вводимые значения в компоненте ADOTable можно обеспечи- 
вать только на уровне полей (см. раздел 9.5.3). Свойства, аналогичного Constraints 
в компонентах Table и Query, в ADOTable нет. 

Упорядочивание отображаемых записей производится установкой свойства 
IndexFieldNames. В этом свойстве можно задавать любое сочетание имен полей, по 
которым вы хотите упорядочить отображение, разделяя их точками с запятой. На- 
пример, строка «Dep» упорядочит записи в таблице Pers по значению поля Dep — 
отдел. Строка «Dep;Fam;Nam;Par» упорядочит записи по значению поля Dep — or- 
дел, а внутри каждого отдела упорядочит по фамилии, имени и отчеству сотрудни- 
ков. В отличие от свойства IndexFieldNames компонентов BDE, в компонентах 
ADO можно задавать любые сочетания полей, независимо от того, была ли индек- 
сирована таблица при ее создании по этим полям. В этом проявляется дополни- 
тельная гибкость компонентов ADO. 

Фильтрация отображаемых данных может осуществляться так же, как в ком- 
понентах ADO, с помощью свойства Filter, в котором записываются условия отбо- 
ра (см. раздел 9.5.5). Отличие от компонентов BDE заключается в том, что в ком- 
понентах ADO в строке Filter имена полей обязательно должны отделяться пробе- 
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лами от операций отношения. Также пробелами должны окружаться логические 
операции and и ог. Например, если в компонентах BDE фильтр может быть запи- 
сан в виде: 


(Year b<=1960)and(Year b>=1940) 
то в компонентах ADO эта строка должна иметь вид: 

(Year b <= 1960) and (Year Ю >= 1940) 

Свойство Filter работает, если свойство Filtered = true. 

Можно также использовать для фильтрации обработчик событий OnFilter- 
Record (см. раздел 9.5.5). Дополнительные возможности фильтрации обеспечивает 
свойство только времени выполнения FilterGroup. Этот параметр позволяет 


фильтровать записи, которые изменены, или должны были быть изменены, или 
удалены. Свойство может иметь следующие значения: 


О О О о О В ОР вать 


fg Unassigned Не оказывает влияния на фильтрацию. Значение по 
умолчанию 
fgNone Отменяет текущую фильтрацию и делает видимыми 


все записи 


fgPendingRecords Отфильтровываются записи, которые были измене- 
ны, HO еще не занесены в таблицу методом Update- 
Batch или прерваны методом CancelBatch 


fgAffectedRecords Отфильтровываются последние измененные записи 

fgFetchedRecords Отфильтровываются записи, которые были измене- 
ны при последней очистке кэша 

fgPredicate Отфильтровываются только что удаленные записи 

fgConflictingRecords Отфильтровываются записи, которые должны были 


быть изменены, но это не получилось из-за ошибок 


Методы, используемые при программировании работы с базой данных, в ADO- 
Table в основном те же, что в Table и Query. Навигация по таблице осуществляет- 
ся методами First, Next, Last и Prior. При редактировании данных используются 
также методы, характерные для Table: Insert, Edit, Post и другие. Из методов no- 
иска в ADO реализованы только методы Locate и Lookup. Их использование не от- 
личается от описанного в разделе 9.11.6. 

Из методов, отсутствующих в компонентах BDE, интересными представляют- 
ся методы сохранения набора данных в файле и чтения его из файла. Сохранение в 
файле осуществляется методом SaveToFile: 


void _fastcall SaveToFile(const WideString FileName, 
TPersistFormat Format) ; 


Параметр FileName указывает имя файла, в котором сохраняется набор дан- 
ных. Параметр Format определяет формат файла. Этот параметр может принимать 
одно из двух значений: pfADTG — формат ADTG (Advanced Data Tablegram), или 
pfXML — формат XML (для версий ADO 2.1 и выше). Например: 


ADOTablel->SaveToFile("Test.adt", pfADTG) ; 
Чтение данных из файла осуществляется процедурой LoadFromFile: 
void _fastcall LoadFromFile(const WideString FileName) ; 


rye FileName — имя файла. Загружать файл в набор данных можно даже при 3a- 
крытом соединении с базой данных. В момент загрузки соединение автоматически 
откроется. 


620 Глава 10 


Методы SaveToFile и LoadFromFile удобно использовать для получения как 
бы мгновенного портрета данных на какой-то момент времени. Это может требо- 
ваться, например, для того, чтобы можно было восстановить запомненное, а затем 
из-за каких-то ошибок испорченное состояние базы данных. 

Связь друг с другом компонентов ADOTable, работающих с разными таблица- 
ми, одна из которых главная, а другая — вспомогательная, осуществляется так 
же, как в компонентах Table, с помощью свойств MasterSource и MasterFields 
(см. раздел 9.10.1). 


Теперь остановимся коротко на компоненте ADOQuery — аналоге компонента 
Query, используемого при работе с BDE. Этот компонент используется для выпол- 
нения произвольных запросов SQL. Его основное свойство SQL, содержащее за- 
прос, и методы выполнения этого запроса ничем не отличаются от компонента 
Query. А соединение с базой данных, свойства и методы фильтрации и поиска ана- 
логичны рассмотренным выше для компонента ADOTable. 

Отличие от компонента Query заключается в методике работы с параметрами 
при динамических запросах. Если в запросе SQL указаны параметры, то в компо- 
ненте Query объекты типа TParams, соответствующие этим параметрам, располо- 
жены в подсвойтстве Items свойства Params. Это массив параметров, причем дос- 
туп к значениям отдельных параметров во время выполнения может осуществ- 
ляться или по индексу свойства Items, или по'имени с помощью метода Рагат- 
ByName, или еще несколькими способами (см. раздел 10.1.6.2). Например, воз- 
можны следующие операторы: 

// значение параметра типа string 

Queryl->Params->Items[0]->Value = Editl->Text; 

Queryl->Params->Items[0]->AsString = Editl->Text; 

Queryl->ParamByName ("Dep") ->AsString = Editl->Text; 


// значение параметра типа integr 
Queryl->Params->Items[1]->Value = Edit2->Text; 
Queryl->Params->Items[1l1]->AsString = Edit2->Text; 
Queryl->ParamByName ("PYear")->Value = Edit2->Text; 
Queryl->Params->FindParam("PYear")->Value = Edit2->Text; 
Queryl->Params->ParamValues["PYear"] = Edit2->Text; 


В компоненте ADOQuery объекты, соответствующие параметрам, указанным 
в свойстве SQL, расположены в свойстве Parameters типа TParameters. Это тоже 
массив параметров, но его свойства и методы отличаются от свойств и методов 
TParams. Доступ к отдельным параметрам во время выполнения может осуществ- 
ляться по индексу подсвойтства Items, но при этом значение определяется только 
функцией Value, а методы AsString, AsInteger и т.п. отсутствуют. Доступ к от- 
дельным параметрам может осуществляться по имени с помощью методов Рагат- 
ByName, FindParam, GetParamList, ParamValues свойства Parameters, которые 
не отличаются от аналогичных методов свойства Params в Query. Например, воз- 
можны следующие операторы: 

// значение параметра типа string 

ADOQueryl->Parameters->Items[0]->Value = Editl->Text; 


ADOQueryl1->Parameters->ParamByName ("EDep")->Value = Editl->Text; 
ADOQuery1l->Parameters->ParamValues["EDep"] = Editl->Text; 


// знчение параметра Tuna integr 
ADOQueryl->Parameters->Items[1]->Value = Edit2->Text; 
ADOQueryl->Parameters->ParamByName ("PYear")->Value = Edit2->Text; 
ADOQuery1->Parameters->FindParam("PYear")->Value = Edit2->Text; 
ADOQueryl->Parameters->ParamValues["PYear"] = Edit2->Text; 


Еще одно различие параметров в компонентах ADOQuery и Query заключает- 
ся в том, что во время проектирования компонент Query содержит только те пара- 
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метры, которые указаны в запросе SQL. А в ADOQuery предусмотрена возмож- 
ность вводить параметры во время проектирования. Для этого надо нажать кнопку 
с многоточием около свойства Parameters в окне Инспектора Объектов, затем в 
появившемся окне редактора параметров щелкнуть правой кнопкой мыши и вы- 
брать в контекстном меню раздел Ада (вместо этого можно нажать соответствую- 
щую быструю кнопку). 

Свойства параметров, которые вы можете устанавливать в окне Инспектора 
Объектов, если выделите какой-то из параметров в окне редактора параметров, не- 
сколько отличны OT тех, которые свойственны параметрам компонента Query. 
Свойства DataType, Name, Value аналогичны свойствам Query. Свойство Direc- 
tion в ADOQuery аналогично свойству РагатТуре в Query. Дополнительно для 
строковых параметров имеется свойство Size — число символов, а для числовых 
параметров имеются свойства Precision и NumericScale — общее максимальное 
число цифр и максимальное число цифр после десятичной запятой. Имеется также 
свойство Attributes — множество, которое может содержать значения PSSigned — 
число может быть со знаком, pSNullable — значение может быть нулевым, 
psLong — длинное двоичное значение. 


Компонент ADOStoredProc является аналогом компонента StoredProc, ис- 
пользуемого при работе с ВПЕ. Этот компонент используется для выполнения хра- 
нимых на сервере процедур. В целом он работает так же, как его аналог Stored- 
Ргос (см. раздел 10.3.5.2). 

Свойство, в котором задается имя выполняемой процедуры, называется Ргосе- 
dureName, а не StoredProcName, как в StoredProc. После того, как вы зададите 
имя процедуры, в свойстве Parameters, аналогичном рассмотренному выше для 
компонента ADOQuery, появятся входные параметры процедуры. Выходные пара- 
метры представляются объектами полей компонента ADOStoredProc. Вы можете 
увидеть их и изменить их свойства, если сделаете двойной щелчок на компоненте 
ADOStoredProc, в появившемся окне Редактора Полей сделаете щелчок правой 
кнопкой мыши и выберете раздел Add all fields. В окне появятся поля, соответст- 
вующие всем выходным параметрам процедуры. 

Таким образом, при работе с хранимыми процедурами вы сначала должны за- 
дать значения входных параметров, затем выполнить вызов процедуры операто- 
ром вида: 

ADOStoredProcl->ExecProc() ; 


а к возвращенным парамётрам обращаться как к объектам полей компонента 
ADOStoredProc. 

Мы рассмотрели, конечно, не все свойства и методы и не все компоненты ADO. 
Впрочем, надеюсь этого достаточно, чтобы ввести эти компоненты в любое из раз- 
работанных ранее приложений и на практике ознакомиться с их работой. Более 
подробные сведения и примеры вы можете найти в книгах [7] и[8]. 


10.5 Доступ к InterBase через 
InterBase Express (IBX) 


10.5.1 Технология InterBase Express (IBX) 


В библиотеке компонентов C++Builder 5 появилась страница InterBase, содер- 
жащая компоненты для работы с InterBase напрямую, минуя ВПЕ. Эти компонен- 
ты обеспечивают повышенную производительность и позволяют использовать но- 
вые возможности сервера InterBase, недоступные обычным компонентам ВПЕ. 


622 Глава 10 


Технология IBX обеспечивается следующими компонентами, расположенны- 
ми на странице InterBase библиотеки: 


BaF BORA IRER GREE BEC PRES BEDI LOGIE ER BG OSE LES А Ими SIEBER EEE BRECON ELIS BREE EBERT: разр RRR oe MBE ee 


IBTable > Компонент, ‘используемый E вместо ‘Table | для доступа к одной. А 
таблице набора данных 

IBQuery Компонент, аналогичный Query 

IBStoredProc Компонент для выполнения процедур, хранимых на сервере 

IBDatabase Обеспечивает соединение с базой данных InterBase 


IBTransaction — Обеспечивает доступ ко всем богатым возможностям тран- 
закций InterBase. Благодаря использования транзакций с 
опциями, наиболее подходящими к той или иной ситуации, 
повышается эффективность работы. Поддерживаются рас- 
пределенные транзакции со множеством баз данных 


IBUpdateSQL Используется для изменений в таблицах только для чтения 
’ и для кэширования изменений. Позволяет проектировать’ 
нормализованные базы данных, не ограничивая возможно- 
стей приложения по изменению сложных наборов данных 


IBSQL Выполняет запросы SQL, минимизируя затраты буфериза- 
ции и обмена данными с компонентами C++Builder. Обеспе- 
чивает наиболее эффективный доступ к данным InterBase 


IBDataSet Обеспечивает выполнение команды SELECT и выполняет 
команды SQL по вставке, удалению и изменению записей. 
Обеспечивает, как и IBSQL, эффективный доступ к данным 


IBDatabaselInfo Позволяет приложению затребовать информацию о базе дан- 
ных и сервере InterBase, включая сведения о свойствах базы 
данных, производительности системы, о пользователях, сое- 
диненных с базой данных, ит.п. 


IBSQLMonitor Позволяет осуществлять отладку коммуникаций для ускоре- 
ния работы проектов клиент/сервер и проектов с параллель- 
ными потоками 


IBEvents Обеспечивает асинхронную обработку событий сервера Inter- 
Вазе 


Подробное рассмотрение всех этих компонентов в рамках данной книги невоз- 
можно, так как требует детального знакомства с еаве, Но некоторые основные 
моменты мы рассмотрим. 

Для построения приложения на основе компонентов 1ВХ на форме или в моду- 
ле данных должны быть прежде всего размещены компоненты IBDatabase и 
IBTransaction. Компоненты В)аёафа$е обеспечивают соединение с базой данных, 
а компоненты 1ВТгапзас оп управляют трансакциями. К эти компонентам под- 
ключаются компоненты наборов данных: IBTable, IBQuery, IBStoredProc, IB- 
DataSet, IBSQL, и др. Все эти компоненты подключаются заданием в них соответ- 
ствующих значений свойства Database — имени компонента IBDatabase, и Trans- 
action — имени компонента [BTransaction. А далее к компонентам наборов дан- 
ных могут подключаться обычные компоненты источников данных DataSource, к 
которым в свою очередь подключаются обычные компоненты отображения и 
управления данными. 
°_. Эти связи поясняются приведенной на рис. 10.14 диаграммой модуля данных, 
построенного на компонентах IBX. Около связей указаны имена полей, которыми 
обеспечивается соответствующая связь. 
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10.5.2 Компоненты IBDatabase и IBTransaction 


Соединение компонентов IBX с базой данных, как было сказано в разде- 
ле 10.5.1, осуществляется через компонент I[BDatabase. Он выполняет для компо- 
нентов 1ВХ функции, во многом аналогичные тем, которые выполняются компо- 
нентом ADOConnection для компонентов ADO (см. раздел 10.4.3). База данных, с 
которой осуществляется соединение, задается свойством DatabaseName. Для ло- 
кального набора данных InterBase задается имя файла базы данных. Например: 


D: \DataBase\dbIbase\Ib.gdb 


При нажатии кнопки с многоточием около этого свойства в окне Инспектора 
Объектов вызывается обычный диалог открытия файлов, который позволяет вы- 
брать файл базы данных. 

Для соединения с базой данных InterBase на удаленном сервере, использую- 
mem протокол TCP/IP, значение DatabaseName задается в виде: 


<имя сервера>:<имя файла> 


Для соединения с базой данных InterBase на удаленном сервере, использую- 
щем протокол NetBEUI, значение DatabaseName задается в виде: 


\\<имя сервера>\<имя файла> 


Для соединения с базой данных InterBase на удаленном сервере, использую- 
щем протокол SPX, значение DatabaseName задается в виде: 


<имя сервера>@<имя файла> 


Возможен и другой способ задания базы данных — двойной щелчок на компо- 
ненте IBDatabase. В результате открывается окно, показанное на рис. 10.15. В нем 
вы можете не только задать в окошке Database имя базы данных (в этом может по- 
мочь кнопка поиска файла Browse), но и установить ряд свойств: в частности, имя 
пользователя (User Мате) и пароль (Password). Результаты установок автоматиче- 
ски занесутся в окно Seltings. Индикатор Login Prompt определяет появление или OT- 
сутствие окна запроса имени пользователя и пароля при каждом запуске приложе- 
ния. Если вы укажете имя пользователя, пароль и снимете флажок индикатора 
Login Prompt, то запрос производиться не будет. 

Свойство SQLDialect задает диалект SQL, используемый клиентом. Свойство 
LoginPrompt определяет появление диалога, запрашивающего имя пользователя и 
пароль при соединении с базой данных. 

Свойство Connected открывает и закрывает соединение с базой данных. Соеди- 
нение может управляться этим свойством или методами Ореп — открыть соедине- 
ние, и Close — закрыть соединение. Эти методы переключают значение Connected 
соответственно в true и в false. 


624 д аа Глава 10 


Рис. 10.15. tabase Component Edit 
Окно задания базы данных и ее свойств 


Существует также метод CloseDataSets, закрывающий соединение всех KOM- 
понентов наборов данных, соединенных с данным компонентом IBDatabase, но He 
закрывающий соединение самого IBDatabase. 

Свойство Connected компонента IBDatabase связано со свойствами Active 
компонентов наборов данных, подключенных к данному IBDatabase. Это односто- 
ронняя связь, аналогичная описанной в разделе 10.4.3 для компонента ADOCon- 
nection. 


Теперь рассмотрим компонент IBTransaction, который позволяет организовы- 
вать транзакции. Выполнение транзакции начинается методом StartTransaction. 
Перед вызовом этого метода полезно проверить значение свойства шТгапзас® оп. 
Если оно равно true, это значит, что не закончена предыдущая транзакция. В этом 
случае вызов новой транзакции без завершения предыдущей методами Commit 
или Rollback приведет к генерации исключения. 

После вызова StartTransaction сервер хранит все изменения, вставки, удале- 
ния записей, пока не будет выполнен метод Commit или метод Rollback. Метод 
Commit завершает транзакцию, запоминая все сделанные на протяжении ее изме- 
нения в базе данных. Метод Rollback производит откат, т.е. отменяет все измене- 
ния данных, произведенные на протяжении текущей транзакции, и завершает эту 
транзакцию. 

Таким образом, организация транзакции осуществляется по следующей схе- 
ме: 

IBDatabasel->Open (); 


DataModule2->IBTransactionl->StartTransaction(); 
операторы изменения данных, удаления и вставки записей 


if (<проверка правильности изменений, запрос пользователю на фиксацию 
изменений и т.п.>) 

IBTransactionl->Commit (); 
else IBTransactionl->Rollback(); 


Например: 
IBTransactionl->StartTransaction(); 
IBDatabasel->Open () ; 


if (Application->MessageBox ( 
"Действительно хотите изменить сохранить изменения?", 
"Подтвердите сохранение изменений", 
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MB YESNOCANCEL+MB ICONQUESTION) == IDYES) 
IBTransactionl->Commit(); 
else IBTransactionl->Rollback(); 


Завершение транзакции методами Commit и Rollback сбрасывает свойство 
Active компонента 1ВТгапзас оп в false. Между этим свойством 1ВТгапзас оп и 
аналогичными свойствами подключенных к IBTransaction компонентов такое же 
взаимодействие, которое описано выше для IBDatabase. Поэтому для последую- 
щей активизации подключенных компонентов надо принимать те же меры, кото- 
рые были описаны для ТВШ,афаазе. 

Теперь рассмотрим некоторые свойства компонента. DefaultDatabase — зада- 
ет компонент IBDatabase, используемый по умолчанию при выполнении транзак- 
ции. 

Свойство IdleTimer задает отрезок времени в секундах, через который, если 
транзакция не завершена, совершается действие по умолчанию. Это действие зада- 
ется свойством DefaultAction, которое может принимать значения: 


: ИЯ: ККС ЕЛ ООО О ИИ ИИ EPPS, 


taRollback Откат транзакции 


taCommit Фиксация результатов транзакции в базе данных 


taRollbackRetaining Откат транзакции с сохранением ее контекста. Доступ- 
но только начиная с InterBase 6 


taCommitRetaining Фиксация результатов транзакции в базе данных и CO- 
хранение контекста текущей транзакции 


В момент окончания отведенного отрезка времени генерируется событие Оп- 
IdleTimer, обработчик которого можно использовать для каких-то дополнитель- 
ных действий, например, для запроса пользователя о дальнейших действиях. 

Свойства только для чтения DatabaseCount и Databases задают соответствен- 
но число компонентов IBDatabase, вовлеченных в текущую транзакцию, и индек- 
сированный список этих компонентов. 


10.5.3 Компоненты наборов данных IBTable, IBQuery, 
IBStoredProc 


Все компоненты наборов данных подключаются к компонентам IBDatabase и 
IBTransaction через свои свойства Database и Transaction, как было указано в 
разделе 10.5.1. 

Компонент IBTable является эквивалентом обычного компонента Table, ис- 
пользуемого при работе с ВПЕ, и у него практически нет свойств, которых бы не 
было в Table. Пожалуй, имеет смысл отметить только свойство UniDirectional, ука- 
зывающее, возможно ли применение для данной таблицы двунаправленного курсо- 
ра. Надо также сказать, что, к сожалению, в компоненте IBTable невозможно ис- 
пользовать словари полей. Так что свойства полей приходится устанавливать вруч- 
ную, пользуясь Редактором Полей, вызываемом двойным щелчком на компоненте. 

Методы компонента IBTable тоже в основном совпадают с Table. Однако, из 
методов поиска реализованы только методы Locate и Lookup. Их использование не 
отличается от описанного в разделе 9.11.6. 

Компонент [BQuery является аналогом обы`‹ного компонента Query, исполь- 
зуемого при работе с ВПЕ. Он позволяет общаться с базой данных на языке SQL. 
Свойства и методы [BQuery подобны свойствам и методам Query. 

Компонент IBStoredProc является аналогом компонента StoredProc, исполь- 
зуемого при работе с BDE. Этот компонент используется для выполнения храни- 
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мых на сервере процедур. В целом он работает так же, как его аналог StoredProc 
(см. раздел 10.3.5.2). 

Имя выполняемой процедуры задается свойством StoredProcName, как ив 
StoredProc. После того, как вы зададите имя процедуры, в свойстве Params поя- 
вятся выходные и входные параметры процедуры. Отличие от аналогичного свой- 
ства компонента StoredProc заключается в последовательности размещения пара- 
метров. В StoredProc сначала располагаются входные параметры, а затем выход- 
ные. А в IBStoredProc сначала расположены выходные параметры, а затем вход- 
ные. Впрочем, это не имеет значения, если для доступа к параметрам используют- 
ся метод РагатВуМате. 

Таким образом, практически в любом приложении можно просто заменить 
компоненты StoredProc на IBStoredProc, добавив, конечно, в приложение компо- 
ненты IBDatabase и 1ВТгапзасй оп. 


Обработка 
и документирование данных 


11.1 Многомерный анализ данных — компоненты 
Decision Cube 


11.1.1 Настройка компонентов приложения 


Для анализа многофакторной информации, получаемой из базы данных, в 
C++Builder имеются специальные компоненты, размещенные на странице библио- 
теки Decision Cube. При анализе данные представляются в виде так называемого 
многомерного куба (метакуба) или куба решений. Каждое измерение этого куба со- 
ответствует одному полю. Например, данные по сотрудникам организации, содер- 
жащиеся в таблице Pers, могут анализироваться по подразделениям, по признаку 
пола, по году рождения, по тому, работают ли они в управлении или в производст- 
венном отделе. Таким образом возникает четырехмерный куб. При анализе может 
возникнуть желание узнать, сколько человек работают в управлении и в производ- 
стве, сколько всего в организации мужчин и женщин, как распределяются мужчи- 
ны и женщины в управлении и на производстве, распределение сотрудников по го- 
дам рождения и т.п. 

Таких вопросов может быть великое множество и в приложении невозможно 
предусмотреть какие-то меню, кнопки и иные управляющие элементы, которые 
бы охватывали все, что может захотеться знать пользователю, принимающему ре- 
шения на основе сведений, почерпнутых из базы данных. Желательно иметь инст- 
румент, с помощью которого пользователь мог бы сам наглядно формулировать 
любые запросы, получая на них ответы в удобной табличной или графической фор- 
ме. Именно таким инструментом и является система Decision Cube. 

Эта система включает следующие компоненты: 


ЛХ ; 9 OE LE ORIEL SEE И САИ GEER ELE EIT а LED EELE LEP LOEB ERLE LIES В BIBER EVLA CC 


DecisionCube Реализует многомерный куб данных 


DecisionGraph Отображает графики, соответствующие выбору, сделанному 
пользователем в многомерном кубе 


DecisionGrid Отображает в табличном виде данные, соответствующие вы- 
бору, сделанному пользователем в многомерном кубе | 


DecisionPivot Дает возможность пользователю закрывать и открывать отде- 
льные измерения куба 


DecisionQuery Определяет набор данных, используемый для построения 
куба. Аналог компонента Query, приспособленный для задач 
Decision Cube 


DecisionSource Источник данных, аналогичный DataSource, но приспособ- 
‚ ленный для задач Decision Cube 


Рассмотрим применение всех этих компонентов на примере работы ‘с базой 
данных ib, использовавшейся в главе 10. 
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Начнем с простого приложения, работающего с таблицей Pers. Начните новое 
приложение и перенесите на форму компоненты DecisionQuery, DecisionCube, 
DecisionSource и DecisionGrid. Компоненты DecisionQuery, DecisionCube и Deci- 
sionSource — невизуальные. Так что разместить их можно в любом месте формы. 
А компонент отображения данных DecisionGrid -— визуальный. Задайте в ero 
свойстве Align значение alClient, чтобы он заполнил всю поверхность формы. 

Свяжите размещенные компоненты друг с другом цепочкой ссылок, похожей 
на ту, которая связывает обычные компоненты, работающие с базами данных. В 
компонент отображения данных DecisionGridl надо в его свойстве DecisionSource 
ввести ссылку на компонент источника данных DecisionSourcel. В источник дан- 
ных DecisionSourcel надо в его свойстве DecisionCube ввести ссылку на метакуб 
DecisionCubel. А в метакубе DecisionCubel надо в свойстве DataSet сослаться Ha 
набор данных DecisionQueryl. Таким образом создается цепочка: набор данных 
(DecisionQuery) => метакуб (DecisionCube) => источник данных (DecisionSourcel) 
= отображение данных (DecisionGrid). От привычной цепочки, используемой при 
работе с базами данных, эта цепь отличается только одним звеном — наличием ме- 
такуба между набором и источником данных. 

Начать проектирование следует с настройки набора данных DecisionQueryl. 
Сделайте на этом компоненте двойной щелчок. Перед вами откроется окно редак- 
тора запроса Decision Cube, показанное на рис. 11.1. 


Рис. 11.1. 
Окно редактора запроса Decision Cube 


В окошке Database вы должны выбрать из выпадающего списка базу данных, с 
которой собираетесь работать, а в окошке Table — таблицу этой базы данных. По- 
сле этого в списке всех доступных полей (List Of Available Fields) вы увидите список 
полей таблицы. Отберите из них те, которые вы хотите анализировать. Для отбора 
надо выделить соответствующее поле в списке List Of Available Fields и нажать кноп- 
ку со стрелкой вправо между этим списком и списком Dimensions — измерения. Тем 
самым вы создаете измерение метакуба, соответствующее выбранному полю. 

Последовательность занесения полей в список Dimensions не безразлична. Дело 
в том, что первое измерение будет в дальнейшем соответствовать столбцам табли- 
цы, а остальные — строкам. Причем доступ пользователя к строкам будет тем про- 
ще, чем выше расположено поле в списке Dimensions. Так что в нашем примере же- 
лательно сформировать список в той последовательности, которая указана на 
рис. 11.1. 

В список Summaries следует добавить те суммарные характеристики, которые 
будут отображаться в ячейках таблицы или нужны для расчета характеристик, 
отображаемых в ячейках. Пусть мы хотим отображать в таблице число сотрудни- 
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ков по отделам, полу, возрасту, и, кроме того, хотим иметь возможность отобра- 
жать средний год рождения. При расчете среднего года рождения автоматически 
будет рассчитываться сумма годов рождения и количество содержащихся в каж- 
дом разделе годов рождения, т.е. число сотрудников. Так что нам достаточно обес- 
печить расчет среднего года рождения Year_b, а число сотрудников рассчитается 
автоматически. Выделите в списке поле Уеаг_Ъ и нажмите кнопку со стрелкой 
вправо около окна Summaries. Перед вами возникнет выпадающее меню с тремя 
разделами: sum — сумма, count — количество и average — среднее. Выберите aver- 
age. Однако в окно Summaries при этом занесется не АУС(УЕАК В), а SUM(YEAR_B) и 
COUNT( YEAR_B ). Это занеслись промежуточные величины, необходимые для под- 
счета среднего значения. 

На странице SQL Query (рис. 11. 2) вы можете увидеть запрос SQL, который 
сформировался в результате ваших действий. В нашем случае он будет иметь вид: 

SELECT DEP, SEX, YEAR В, SUM( YEAR В ), COUNT( YEAR В ) 

FROM PERS 

GROUP ВУ DEP, SEX, YEAR В 


В этом запросе после ключевого слова SELECT указаны поля измерений (Dep, 
бех, Уеаг _Ъ), затем указаны суммарные характеристики. В конце оператора ука- 
зана группировка — GROUP BY. Тут обязательно должны быть повторены все 
поля, соответствующие измерениям, и в той же последовательности, в которой они 
фигурировали в списке SELECT. Вы можете при желании отредактировать этот за- 
прос, нажав предварительно кнопку Edit Query, или просто начав вводить какие-то 
символы. При этом надпись на кнопке Edit Query изменится Ha Edit Done. После за- 
вершения редактирования нажмите на эту кнопку, и введенные вами изменения 
зафиксируются, или вам будет выдано сообщение об ошибке, если вы что-то напи- 
сали неправильно. Кнопка Edit Cancel позволяет прервать редактирование. 

Первая из суммарных характеристик, указанных в запросе SQL, появится в 
ячейках таблицы при первом предъявлении ее пользователю. В приведенном выше 
запросе SQL первой указана сумма годов рождения — вспомогательная величина, 
абсолютно бессмысленная для пользователя. Поэтому желательно отредактиро- 
вать запрос, переставив величину COUNT( YEAR_B) перед SUM( YEAR_B). Если 
вы после этого вернетесь на страницу Dimention/Summaries, то увидите, что последо- 
вательность этих величин в окне Summaries изменилась (см. рис. 11.1). 

Внизу окна на рис. 11.1 и 11.2 вы видите кнопку SQL Builder. Она позволяет вы- 
звать визуальный построитель запросов SQL, в котором вы можете сформировать 
запрос. Его результаты автоматически отобразятся на страницах окна редактора 
запроса Decision Cube. 


Puc. 11.2. 
Страница SQL Query окна редактора 
запроса Decision Cube 


SELECT DEP. SEX, YEAR_B. ЗОМГУЕАВ В } СООМТ(УЕАВ В ) 
FROM PERS 
GROUP BY DEP, SEX, YEAR_B 
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Завершив всю работу в окне редактора запроса, нажмите ОК. Вы вернетесь в 
проектируемое вами приложение, а имя ‘базы данных и запрос SQL автоматически 
занесутся в свойства Database и SQL компонента DecisionQuery. 

Итак, основной компонент — DecisionQuery мы настроили. Теперь можете его 
активизировать. Измените значение его свойства Active Ha true. При этом прямо в 
процессе проектирования в компоненте DecisionGridl отобразятся данные 
(рис. 11.3). 


Рис. 11.3. ет — ен 
Форма простого приложения й И kts 


Позднее мы разберемся, как работать с этими данными. А пока давайте на- 
строим форму их отображения. Прежде всего хотелось бы иметь в заголовках рус- 
ские надписи. Сделайте двойной щелчок на компоненте DecisionCubel, или на- 
жмите кнопку с многоточием в окне Инспектора Объектов около свойства Dimen- 
tionMap этого компонента, или щелкните на компоненте правой кнопкой мыши и 
выберите в контекстном меню раздел Decision Cube Editor. Во всех этих вариантах 
вы попадете в окно, представленное на рис. 11.4. 

Ha странице Decision Settings этого окна вы можете, выбирая каждое поле в спи- 
ске Available Fields, задать для него в окошке Display Name имя, которое будет фигу- 
рировать в заголовках компонентов отображения данных. Окошко Туре указывает 
тип выделенного в списке Available Fields элемента: является ли он измерением куба 
или суммарной характеристикой. Значение в этом окошке изменять невозможно. 
Выпадающий список Active Туре определяет, когда загружается соответствующая 
информация: As Needed — когда требуется ее отображать, Active — всегда, |пас- 
tive — никогда. В большинстве случаев следует выбирать значение As Needed. 

Окошко Format позволяет задать строку форматирования отображения. Выпа- 
дающий список Grouping дает возможность выбрать отображение всех значений 
(None), или только лежащих в определенных границах: Year — год, Quarter — квар- 
tan, Month — месяц, Single Value — одномерное отображение. Все это относится к дан- 
ным, распределенным во времени, и в нашем примере использоваться не может. 


Рис. 11.4. 
Страница Decision Settings 
редактора куба решений 
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Страница Memory Control окна редактора куба решений особого интереса не 
представляет. Если вы откроете ее, то имеет смысл обратить внимание только на 
опцию Designer Data Options, которая указывает, что именно должно отображаться 
в процессе проектирования. На отображение данных в процессе выполнения при- 
ложения эта опция не влияет. 

Редактор куба решений позволяет вам задать описанным выше способом на- 
стройку (в частности, Display Мате — отображаемые русские названия) сразу для 
всех компонентов отображения данных, если их несколько в вашем приложении. 
Но каждый компонент отображения данных позволяет произвести дополнитель- 
ную индивидуальную настройку отображения. Обратите внимание в компоненте 
DecisionGrid на свойство Dimensions. Нажав кнопку с многоточием около него вы 
попадете в редактор списка измерений, подобный тем, с которыми вы уже не раз 
встречались на протяжении чтения этой книги. В нем вы можете для каждого из- 
мерения задать отображаемое имя (DisplayName), формат и в свойстве Subtotal 
указать, надо ли для данного измерения отображать промежуточные суммарные 
данные: например, число сотрудников по каждому отделу, по полу, по каждому 
году рождения. Последнее, видимо, не надо, так что для поля года рождения сле- 
дует задать Subtotal = false. А для среднего года рождения полезно задать формат 
«###0.#Н». Он означает, что отображение будет проводиться до первого знака по- 
сле запятой и что, если какой-то категории сотрудников нет и, следовательно, их 
средний год рождения 0, то этот 0 будет отображаться в ячейке таблицы. 

Из свойств DecisionGrid обратите также внимание на ОеГаи Со Width — ши- 
рина колонки таблицы по умолчанию. Это свойство задает ширину по умолчанию. 
В процессе выполнения приложения пользователь сможет по своему усмотрению 
изменять ширину колонок. | 

Свойства LabelColor и LabelSumColor позволяют задавать цвета соответствен- 
но основных ячеек таблицы и строк и столбцов сумм. Последние, наверное, непло- 
хо выделить цветом, отличным от основных ячеек. 


11.1.2 Управление выполняющимся приложением 


Теперь настройка приложения закончена и вы можете выполнить его 
(рис. 11.5). Вы видите, что в каждом измерении имеется индикатор с символом 
«+» — развернуть, или «-» — свернуть. Строки можно полностью свернуть 
(рис. 11.5.а), и тогда отображается только число сотрудников ‘по отделам. Впро- 
чем, свертывание можно продолжить, свернув и первое измерение — отделы. В 
этом случае таблица отобразит всего одну ячейку — число сотрудников в учрежде- 
нии. А можно развернуть второе измерение (рис. 11.5 6) и информация станет дву- 
мерной, классифицируя число сотрудников по отделам и по полу. Если ввести еще 
одно измерение (рис. 11.5 6), то информация сортируется по отделам, по полу и по 
годам рождения. 

Пользователь может в процессе выполнения приложения управлять отображе- 
нием промежуточных сумм по отдельным измерениям и всех суммарных данных. 
Если вы щелкнете правой кнопкой мыши на пустом заголовке таблицы или на пус- 
том месте таблицы, то всплывет меню, состоящее из одного раздела — Subtotal 
on/off. Это переключатель, позволяющий включать и выключать отображение всех 
суммарных данных. Иное контекстное меню всплывет при щелчке правой кноп- 
кой мыши на одном из заголовков измерений. Оно включает два раздела: раз- 
дел Display Data and SubTotal — отображение и данных, и промежуточных сумм по 
данному измерению, и раздел Display Data Only — уничтожение промежуточных 
сумм данного измерения и отображению только данных. 

Щелкнув правой кнопкой мыши на заголовке какого-то подраздела, вы увиди- 
те меню всего с одним разделом — Drill in to this value. Выбор этого раздела равноце- 
нен удалению из таблицы соответствующего измерения. 
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Таковы возможности пользователя, если в процессе проектирования вы вы- 
ключили в компоненте DecisionGrid в свойстве Options опцию cgPivotable. Попро- 
буйте включить эту опцию. Вы увидите, что возможности пользователя много- 
кратно увеличились. Щелкните теперь в выполняющемся приложении правой 
кнопкой мыши на пустом месте заголовка или на пустом месте таблицы. Перед 
вами всплывет меню, показанное на рис. 11.6 a. В нем вы можете отметить те из- 
мерения, которые хотите наблюдать, и таблица перестроится соответствующим об- 
разом. Отметив раздел среднего года рождения, вы перейдете от отображения чис- 
ла сотрудников к отображению среднего года рождения. 


Рис. 11.6. 
Контекстные меню приложения 


Верхний раздел меню на рис. 11.6 позволяет включать и отключать 
отображение сумм, как промежуточных, так и полных. 


Обработка и документирование данных 633 


Если вы щелкнете правой кнопкой мыши на заголовке какого-то измерения, 
перед вами всплывет меню, показанное на рис. 11.6 6. Раздел Display Data and Sub- 
Total обеспечивает отображение и данных, и промежуточных сумм по данному 
измерению, а раздел Display Data Only приводит к уничтожению промежуточных 
сумм данного измерения и отображению только данных. Таким образом, с 
помощью меню рис. 11.6 вы можете убирать или отображать как промежуточные 
суммы по отдельным измерениям, так и все суммы. 

Пользователь может не только манипулировать видимостью отдельных изме- 
рений. Он может перетащить мышью заголовок какого-то раздела и поменять та- 
ким образом последовательность измерений. Он может даже перетаскивать изме- 
рения из строк в столбцы и обратно, полностью меняя структуру таблицы. Мне 
представляется, что подобная свобода в руках не очень опытного пользователя мо- 
жет полностью его запутать. Впрочем, все эти возможности можно отменить, вы- 
ключив в компоненте DecisionGrid опцию cgPivotable в свойстве Options. 

Выше было рассказано об управлении приложением с помощью всплывающих 
меню. Но возможности пользователя можно еще расширить, если установить в 
true свойство ShowCubeEditor компонента DecisionGrid. В этом случае пользова- 
телю при щелчке правой кнопкой мыши вместо списка видимых измерений (см. 
рис. 11.6) будет предлагаться вызов редактора измерений, т.е. диалогового окна, 
показанного ранее на рис. 11.4. Там он может менять тексты заголовков, форматы 
представления данных и т.п. Правда, мне нелегко представить квалификацию 
пользователя, которому это могло бы быть полезно. 

В целом, думается, что приложение, использующее описанные выше возмож- 
ности Decision Cube, должно быть снабжено хорошей встроенной справочной сис- 
темой, которая помогала бы пользователю. 


11.1.3 Компонент DecisionPivot 


Компонент DecisionPivot обеспечивает значительно более удобное управление 
измерениями, чем описано выше. Добавьте на форму вашего приложения этот 
компонент, установите его свойство Align в alTop и укажите в свойстве Deci- 
sionSource источник данных DecisionSourcel. И это все! Правда, поскольку те- 
перь управлять измерениями будет компонент DecisionPivot, то, вероятно, имеет 
смысл выключить опцию cgOutliner в свойстве Options компонента DecisionGrid. 
При этом из таблицы исчезнут кнопки со знаками «+» и «-», которые вы можете 
видеть на рис. 11.5 и которые ранее позволяли пользователю сворачивать и разво- 
рачивать измерения. В том же свойстве Options имеет смысл выключить также оп- 
цию cgPivotable, о которой говорилось в предыдущем разделе. 

Запустите приложение и посмотрите, как оно теперь работает (рис. 11.7). 

Панель компонента DecisionPivot имеет три группы кнопок. Слева располо- 
жена кнопка, показывающая величину, отображаемую в ячейках таблицы. Эта 
кнопка снабжена выпадающим списком, позволяющим менять отображаемую ве- 
личину (в нашем примере — число сотрудников или средний год рождения). Сле- 
дующая группа кнопок соответствует измерениям, которые размещены в строках 
таблицы (в нашем примере Пол и r.p.). Правая группа конок соответствует измере- 
ниям, размещенным в столбцах таблицы (Отдел). Нажатие той или иной кнопки 
включает или выключает показ соответствующего измерения. 

Кнопки можно перетаскивать мышью, меняя последовательность измерений 
или перемещая измерения из строк в столбцы и обратно. Такое перемещение из 
строк в столбца или обратно можно также осуществлять, щелкнув правой кнопкой 
мыши на кнопке панели и выбрав из контекстного меню соответствующий раздел. 

Компонент DecisionPivot предоставляет интересную возможность фиксации 
значения измерения. Если вы щелкнете правой кнопкой мыши на какой-то кноп- 
ки панели и выберете из всплывшего меню раздел Drilled in, то надпись на кнопке 
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изменится (см. рис. 11.7 6). По данному измерению будут отражаться суммарные 
данные. Но если после этого вы нажмете на эту кнопку, то появится меню, содер- 
жащее разделы Open Dimention — открыть измерение (т.е. вернуться к обычной 
форме отображения), All Values — отображать суммарные данные, а также в этом 
меню будет список всех значений данного измерения. Вы можете выбрать какое-то 
значение (рис. 11.7 в) и отобразятся только данные, относящиеся к этому значе- 
нию. Конечно, в нашем примере это не очень нужно. Но если бы мы работали, на- 
пример, с базой данных каких-то товаров или услуг, то это позволило бы нам изби- 
рательно получить информацию по какому-то конкретному товару или услуге. 


11.1.4 Компонент DecisionGraph 


В заключение краткого рассмотрения компонентов Decision Cube остановимся 
на компоненте DecisionGraph. Этот компонент позволяет вводить в приложение 
диаграммы и графики. Перенесите в свое приложение компонент DecisionGraph 
(рис. 11.8) и установите его свойство DecisionSource равным DecisionSourcel. 
Компонент можно разместить в нижней части таблицы DecisionGrid и установить 
в нем свойство Align равным а! Во вот. Запустите свое приложение. Вы увидите, 
что теперь данные отображаются не только в таблице, но и графически. Причем 
переменные, откладываемые по осям, и вид диаграмм автоматически изменяются 
при переключении пользователем измерений. 

Основные свойства компонента DecisionGraph во многом аналогичны свойст- 
вам компонента Chart (см. раздел 3.4.6 главы 3). При настройке вы увидите, что 
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серии заносятся в компонент автоматически, так что вам остается только устано- 
вить элементы оформления. 

В заключение рассмотрения многомерного анализа данных с помощью Decision 
Cube надо отметить, что в рассмотренных примерах мы не написали ни одного опе- 
ратора. Конечно, это возможно только в чисто демонстрационном приложении. 
- Управлять компонентами системы Decision Cube можно программно, задавая BO 
время выполнения значения свойств компонентов, используя их методы и обработ- 
чики событий. Особых сложностей в этом нет, но подробное рассмотрение приемов 
программирования работы с компонентами Decision Cube выходит за рамки данной 
книги (увы, объем ее надо ограничивать). Так что посмотрите немногие методы и со- 
бытия компонентов Decision Cube во встроенной справке C++Builder. 


11.2 Создание отчетов 


Для создания отчетов в C++Builder включена система QuickReport. Компонен- 
ты этой системы размещены на странице ОКерой палитры компонентов. 

QuickReport использует генератор отчетов, состоящих из множества полос. 
Полоса (band) — это область отчета или раздел, содержащий некоторый текст, изо- 
бражения, графики, диаграммы и т.п. Полоса является контейнером для других 
компонентов, вносящих в отчет информацию или графику. 

Если полоса и размещенные на ней компоненты связаны с базой данных, то 
содержание этой полосы печатается столько раз, сколько соответствующих запи- 
сей имеется в источнике данных. Таким образом, достаточно расположить компо- 
ненты, связанные с данными, на полосе, а печатаемые значения и их количество 
будут автоматически управляться базой данных. 

Как в компонентах, связанных с данными, вы можете задавать головную и 
вспомогательную таблицы, так и между полосами можно задавать аналогичные 
связи. Таким образом, все возможности, реализуемые в приложениях, реализуют- 
ся с тем же успехом и в отчетах. 

Давайте зададимся задачей построить отчет по уже многократно использован- 
ной нами в главе 9 базе данных dbP, первая страница которого показана на 
рис. 11.9. Отчет, озаглавленный «КАДРОВЫЙ СОСТАВ ПРЕДПРИЯТИЯ ПО 
СОСТОЯНИЮ НА ...» должен включать в себя следующие разделы: 
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Заголовок раздела |Информация, распечатываемая в разделе | 
ОТДЕЛЫ Список всех отделов 


СПИСОЧНЫЙ Состоит из ряда подразделов, каждый из которых имеет 
СОСТАВ ОТДЕЛОВ |свой подзаголовок «СОТРУДНИКИ ОТДЕЛА ...», после 
которого следует список фамилий сотрудников 


ЛИЧНЫЕ ДЕЛА Состоит из ряда подразделов, каждый из которых имеет 
свой подзаголовок «СОТРУДНИКИ ОТДЕЛА...», после ко- 
торого следует информация о фамилии, имени, отчестве 
сотрудника, его пол, год рождения, фотография сотрудни- 
ка и его характеристика 


| ВЫВОДЫ Содержит произвольный текст, вводимый пользователем 


| 
| 
| 
| 
| 
| 


В разделе «ЛИЧНЫЕ ДЕЛА» каждый подраздел «СОТРУДНИКИ ОТДЕЛА...» 
должен начинаться с новой страницы. С новой страницы должен также начинать- 
ся раздел «Выводы». Все страницы должны иметь нижний колонтитул, в котором 
слева печатается надпись «Кадровый состав», а справа — номер страницы. 


Рис. 11.9. 
Первая страница КАДРОВЫЙ СОСТАВ ПРЕД ПР AAT AA 
разрабатываемого отчета По COCTORHAK НА 20.04.00 
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Строя этот отчет, мы по ходу дела рассмотрим необходимые нам свойства раз- 
личных компонентов. 

Основным компонентом, на котором строится весь отчет, является QuickRep. 
Он предоставляет ряд возможностей по управлению создаваемым отчетом, вклю- 
чая формирование заголовка, полос, шрифтов, установок принтера и др. Этот ком- 
понент является визуальным и после его соединения с базой данных может ис- 
пользоваться как контейнер полос, составляющих отчет. 

Компонент QuickRep имеет ряд свойств, определяющих характеристики печа- 
ти отчета: 


аа 


OILERS LE LEE LL AES 


я 


О АИ SEES EEL LCRLERLESE SEES АИ НИНЕ 


PrinterSetting `Вадает число копий отчета и диапазон печатаемых страниц 


Page Задает размер страницы PaperSize (можно установить заказ- 
ной размер — Custom и определить длину и ширину страни- 
цы свойствами Length и Width), ее ориентацию и поля 


Options Определяет, надо ли печатать верхний колонтитул первой 
страницы (FirstPageHeader) и нижний колонтитул послед- 
ней (LastPageFooter) 


Units Задает единицу измерения размеров страницы, полей ит.п.: 
миллиметры, дюймы, пиксели и т.д. 

Zoom Масштаб печати в процентах 

ReportTitle Заголовок окна предварительного просмотра 


Свойство DataSet определяет набор данных, к которому подключается отчет. 
Этим набором может являться компонент типа TTable, TQuery и т.п. 

Компонент QuickRep имеет два основных метода: Preview — предваритель- 
ный просмотр, и Print — печать. Предварительный просмотр и даже печать отчета 
можно осуществлять и в процессе проектирования. Для этого надо щелкнуть пра- 
вой кнопкой мыши на компоненте QuickRep и из всплывшего меню выбрать ко- 
манду Preview. Перед вами откроется окно предварительного просмотра, в котором, 
в частности, имеется кнопка печати. 

Компоненты QRLabel, QRMemo, QRRichText, QRShape, QRImage, размещае- 
мые Ha полосах отчета, являются аналогами обычных компонентов — Label, Me- 
mo, RichEdit, Shape, Image. Основной особенностью соответствующих компонен- 
тов QuickReport является их способность печататься в тех полосах отчета, в KOTO- 
рых они размещены. Компоненты имеют два свойства, отсутствующих в обычных 
компонентах: Frame и Size. 

‚ Свойство Frame имеет ряд подсвойств, определяющих рамку вокруг компо- 
нента: Color — цвет, Style — стиль, Width — ширина, DrawBottom, DrawLeft, 
DrawRight, DrawTop — определяют наличие рамки соответственно внизу, слева, 
справа и вверху компонента. 

Свойство Size имеет подсвойства, определяющие размер и место размещения 
компонента при печати. Все определяется в единицах измерения, заданных свой- 
ством Units компонента QuickRep. 

Некоторые компоненты имеют свойство AlignToBand — выравнивание в поло- 
се. Если это свойство установить в true, то компонент будет выровнен по краю по- 
лосы, заданному свойством Alignment: taLeftJustify — влево, taCenter — по цен- 
тру, taRightJustify — вправо. 

Давайте начнем построение нашего отчета. Перенесите на форму компонент 
QuickRep. Поместите на форме компонент Table, назовите ero TDep и свяжите с 
таблицей Dep базы данных dbP. Перенесите на форму компонент DataSource, на- 
зовите его DSDep и свяжите с TDep. Перенесите на форму еще один компонент 
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Table, назовите его ТРег$ и свяжите с таблицей Pers базы данных dbP. Установите 
между двумя таблицами обычную связь, чтобы TDep была головной таблицей, a 
TPers связывалась с ней по полю Dep (задайте в TPers соответствующие значения 
свойств IndexName, MasterSource, MasterFields — см. раздел 9.10.1). Установите 
свойства Active компонентов Table в true. 

Установите в свойстве DataSet компонента QuickRep имя компонента TDep, 
связав его тем самым с головной таблицей. Теперь рассмотрим одно из основных 
свойств компонента QuickRep — Bands. Оно имеет ряд подсвойств: 


а В а о а О ERLE ROR уе мое 


HasTitle Имеется полоса заголовка отчета, которая печатается ДИН 
раз в начале отчета 


HasDetail Имеется полоса детализации, которая печатается столько 
раз, сколько записей в нее передается 


HasPageHeader Имеется верхний колонтитул (заголовок) на каждой стра- 
нице отчета 


HasPageFooter Имеется нижний колонтитул на каждой странице отчета 


HasColumnHeader Имеется заголовок печатаемой таблицы 


Для построения нашего отчета надо установить в true подсвойства HasTitle и 
HasPageFooter — полосы заголовка и нижнего колонтитула. На компоненте 
QuickRep появятся слабо видимые полосы с соответствующими надписями. На 
них и будут размещаться компоненты, которые отображают ту или иную информа- 
цию. 

Разместите на полосе заголовка метку QRLabel и B ee свойстве Caption запи- 
шите первую часть заголовка отчета «КАДРОВЫЙ СОСТАВ ПРЕДПРИЯТИЯ». 
Выровняйте эту метку по центру полосы, установив ее свойство AlignToBand в 
true, а свойство Alignment в taCenter. Выберите увеличенный размер шрифта 3a- 
головка (например, 14). Установите жирный шрифт. 

Ниже поместите компонент QRSysData. Этот компонент позволяет отобра- 
жать в отчете системные данные. Его основное свойство Data, которое может при- 
нимать следующие значения: 


Я 


НИЧЕМУ ИИ Ари О В ML ELI о а О В в аи 


qrsDate текущая дата 

qrsDateTime текущие дата и время 
qrsDetailCount число записей в базе данных 
qrsDetailNo текущий номер записи в базе данных 
qrsPageNumber номер текущей страницы 
qrsReportTitle заголовок отчета 

qrsTime текущее время 


Свойство Text компонента QRSysData определяет текст, предшествующий 
отображаемой величине. 

В нашем случае свойство Data установите равным qrsDate, а свойство Text 3a- 
дайте равным «ПО СОСТОЯНИЮ НА ›. Это обеспечит внесение в заголовок теку- 
щей даты. Выровняйте QRSysData по центру так же, как делали это для метки 
QRLabel, и так же установите шрифт. 

На полосе нижнего колонтитула разместите метку QRLabel, выровненную 
влево, с надписью «Кадровый состав», которая должна появляться в колонтитуле. 
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Установите в ее свойстве Егате подсвойство ОгамТор в true. Это обеспечит появ- 
ление линии, отделяющей колонтитул от текста. 

Разместите на той же полосе нижнего колонтитула компонент QRSysData, 3a- 
дав его свойство Data равным qrsPageNumber и выровняв вправо. Этот компонент 
будет отображать номер страницы. 

Можете щелкнуть правой кнопкой мыши на компоненте QuickRep и, выбрав 
из всплывшего меню команду Preview, полюбоваться достигнутым результатом. Те- 
перь займемся собственно текстом отчета. Для этого надо разместить на компонен- 
те QuickRep дополнительные полосы. Мы будем это делать, перенося на него соот- 
ветствующие компоненты полос со страницы ОКерой палитры компонентов. 

Для первого раздела нашего отчета — «ОТДЕЛЫ» нам надо организовать пе- 
чать заголовка раздела и далее циклическую печать названий отделов. Это может 
сделать полоса детализации в виде компонента QRSubDetail. Перенесите ее на 
QuickRep и давайте рассмотрим некоторые ее свойства. 

Свойство DataSet определяет набор данных, к которому должна подключать- 
‚ ся полоса. Поскольку в данном случае она должна обеспечивать просмотр всех за- 
писей таблицы Dep, в свойстве DataSet надо указать таблицу TDep. Этого доста- 
точно, чтобы обеспечить циклическую печать полосы. 

Свойство полосы Bands имеет два подсвойства: HasFooter определяет полосу, 
которая будет напечатана после окончания циклов, и HasHeader определяет поло- 
су заголовка, которая будет напечатана перед началом циклической печати. Нам 
требуется установить в true только HasHeader. В появившейся полосе Group 
Header поместите метку QRLabel с заголовком раздела «Отделы» и соответствую- 
щими установками шрифта, а в самой полосе детализации поместите компонент 
QRDBText — метку, связанную с данными. В ней, как и в других компонентах, 
связанных с данными, надо задать набор данных DataSet и его поле DataField, ко- 
торое должно отображаться. В данном случае DataSet = TDep и DataField = Dep. 

Можете опять осуществить предварительный просмотр отчета и убедиться, 
что первый раздел отчета печатается правильно. 

Во втором разделе — «СПИСОЧНЫЙ СОСТАВ ОТДЕЛОВ» нам надо организо- 
вать два вложенных цикла печати: внешний по отделам и внутренний по сотруд- 
никам очередного отдела. Для внешнего цикла повторяете все операции, которые 
делали для предыдущего раздела: переносите в отчет компонент QRSubDetail, 
связываете его с таблицей TDep, устанавливаете в true подсвойство HasHeader 
свойства Bands. На полосе заголовка раздела помещаете метку QRLabel с заголов- 
ком «СПИСОЧНЫЙ СОСТАВ ОТДЕЛОВ». На полосе детализации размещаете мет- 
ку QRLabel с текстом «СОТРУДНИКИ ОТДЕЛА», и рядом с ней — метку QRDB- 
Text, настроив ee на поле Dep таблицы TDep. 

Теперь нам надо организовать вложенный цикл, чтобы для каждого отдела 
пробегать по относящимся к нему записям таблицы Pers. Для задания таких вло- 
женных циклов в компоненте QRSubDetail предусмотрено свойство Master. Оно 
определяет головную полосу для данной полосы. Это аналогично тому, как задает- 
ся головная таблица для вспомогательной. Свойство Master позволяет организовы- 
вать внутренние циклы печати для каждого напечатанного значения головной по- 
лосы. Свойство PrintBefore определяет в этом случае, печатаются ли значения 
внутреннего цикла до (при PrintBefore = true) или после печати очередного значе- 
ния внешнего цикла. 

Чтобы все это реализовать, поместите в отчет еще один компонент QRSub- 
Detail и свяжите его с таблицей ТРег$. Его свойство Master установите в QRSub- 
Detail2 — имя второй полосы QRSubDetail, являющейся головной во втором раз- 
деле. Свойство PrintBefore установите в false. На эту новую полосу поместите мет- 
ки QRDBText, настроив их на поля Fam, Nam и Par таблицы TPers. 

Запустите предварительный просмотр отчета и убедитесь, что все работает как 
надо. 


=. 
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Теперь третий раздел отчета «ЛИЧНЫЕ ДЕЛА» не представит для Bac слож- 
ности. В нем точно так же надо организовать внешний цикл печати по отделам и 
внутренний — по сотрудникам отдела. В этом втором цикле для отображения фо- 
тографий надо использовать компонент QRDBImage, а для печати характери- 
стик — компонент QRDBRichText. Оба эти компонента должны быть настроены 
на соответствующие поля таблицы TPers. Осталось выполнить одно требование за- 
дания — каждый подраздел раздела «ЛИЧНЫЕ ДЕЛА», относящийся к новому 
подразделению, должен начинаться с новой страницы. Это можно сделать, вос- 
пользовавшись свойством полосы детализации ForceNewPage — форсировать пе- 
реход на новую страницу. В полосе внешнего цикла установите это свойство в true. 
Тогда по окончании каждого внешнего цикла будет осуществляться переход на HO- 
вую страницу. 

Последний раздел вашего отчета — «ВЫВОДЫ». Перенесите в отчет новую по- 
лосу QRSubDetail, разместите метку QRLabel с текстом «ВЫВОДЫ» и поместите 
компонент QRRichText, в котором пользователь сможет отображать написанный 
им текст. 

Форма, которую вы сделали — вспомогательная. Пользователь не будет ее ви- 
деть. А теперь надо сделать главную форму приложения, с которой будет работать 
пользователь. В ней должно быть меню (или кнопки), которое позволит осуществ- 
лять предварительный просмотр и печать отчета. Кроме того на этой форме долж- 
но быть окно редактирования, в котором пользователь может написать выводы. 
Этот текст и должен отображаться в отчете на последней странице. 

Если вы посмотрите в окне Инспектора Объектов свойства компонента 
QRRichText, то увидите свойство ParentRichEdit. В этом свойстве можно указать 
обычный компонент RichEdit, текст которого автоматически будет переноситься в 
текст компонента ParentRichEdit. Именно этот родительский компонент RichkEdit 
и надо разместить на главной форме. 

Давайте займемся проектированием главной формы. Прежде всего убедитесь, 
что форма вашего отчета невидима (свойство Visible равно false). Назовите эту 
форму ЕКер. Сохраните модуль вашего отчета, задав его имя, например, URep. 
Это имя, как и имя формы, потребуется вам в дальнейшем для ссылок. 

Добавьте в приложение новую форму (команда File | New Form). Назовите форму 
ЕМат. Сохраните ее модуль, дав ему, например, имя ОМаш. Эти имена нам по- 
требуются в дальнейшем для ссылок. 

Выполните команду Project | Options, в открывшемся окне Опций проекта пе- 
рейдите на страницу Forms и в списке Мат Form выберите главной текущую форму 
ЕМат. Форма ЕКер должна быть вспомогательной. 

Перенесите на новую форму компоненты главное меню MainMenu, FontDia- 
log, RichEdit и метку. В меню введите раздел Отчет с подразделами Просмотр и Пе- 
чать, и раздел Шрифт. Расположите все примерно так, как показано на рис. 11.10, 
на котором форма изображена во время выполнения приложения. 


Г Подготовка отчета 


me Pan errs 


Puc. 11.10. 
Главная форма приложения генерации отчетов 


управления. 
Особенно, женский. 


Теперь осталось связать друг с другом две формы и написать небольшие ко- 
манды управления. 
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Для связи модуля формы отчета URep с модулем ОМаш включите в модуль 
URep соответствующую директиву препроцессора #include. Это можно сделать не- 
посредственно, или с помощью вызова из 9 Вер команды главного меню File | Include 
Unit Ног. 

В компоненте QRRichText формы FRep раскройте выпадающий список в 
свойстве ParentRichEdit. В этом списке должна появится ссылка на компонент 
RichEdit формы FMain. Установите это свойство, чтобы связать окна редактирова- 
ния друг с другом. 

Перейдите в модуль главной формы и той же командой File | Include Unit Hdr свя- 
жите его с модулем URep. 

В обработчик команды меню Просмотр вставьте оператор 


FRep->QuickRep1l->Preview (); 

В обработчик команды меню Печоть вставьте оператор 
FRep->QuickRep1l->Print (); 

В обработчик команды меню Шрифт вставьте операторы 


if (FontDialogl->Execute ()) 
RichEdit1l->SelAttributes->Assign (FontDialogl->Font) ; 
RichEdit1l->SetFocus () ; 


Эти операторы обеспечат некоторые минимальные возможности форматирова- 
ние в окне RichEdit1. Конечно, в настоящей программе этого мало и надо бы дей- 
ствительно использовать богатые возможности компонента RichEdit (см. раз- 
дел 3.2.4). 

На этом разработка приложения для подготовки отчета закончена. Можете за- 
пускать свое приложение в эксплуатацию. С его помощью в любой момент можно 
распечатать полный отчет о текущем состоянии базы данных. При выборе раздела 
меню Просмотр пользователю будет предъявляться окно предварительного про- 
смотра, показанное на рис. 11.11. В этом окне с помощью быстрых кнопок, распо- 
ложенных вверху на инструментальной панели, пользователь сможет изменять 
масштаб отображения страницы (три левые кнопки), перемещаться по страницам 


Рис. 11.11. 
Окно предварительного просмотра отчета 
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(кнопки навигатора), осуществлять установку принтера и печать, сохранять отчет 
или открывать файл какого-то из прошлых отчетов. Кнопка Close закрывает окно 
предварительного просмотра, после чего можно в окне редактирования главной 
формы написать текст в раздел «Выводы» и напечатать отчет. 


11.3 Использование серверов СОМ 


для документирования данных 


При составлении отчетов, содержащих сведения, черпаемые из баз данных, 
можно использовать компоненты системы QuickReport, описанные в разделе 11.2. 
Однако, QuickReport накладывает на форму отчетов достаточно жесткие ограниче- 
ния. На основе QuickReport можно разработать приложения для некоторых стан- 
дартных отчетов с часто обновляемыми данными. Но нередко хотелось бы иметь 
значительно большую свободу при компоновке и написании отчетов, хотелось бы 
иметь возможность вставлять данные в некий произвольный текст и в произволь- 
ной форме. Такую свободу дает программа Windows Word, широко используемая 
каждым, имеющим дело с персональными компьютерами. Поэтому представляет 
интерес рассмотреть методику совместного использования Word и приложений 
C++Builder при обработке и документировании информации, содержащейся в ба- 
зах данных. В данном разделе мы проиллюстрируем некоторые способы управле- 
ния программой Word из приложений C++Builder. 

Взаимодействие с Word, Excel и многими другими распространенными про- 
граммами, входящими в стандартную установку Word и Microsoft Office, может 
осуществляться из приложений C++Builder 5 с помощью компонентов, размещен- 
ных в библиотеке на странице Servers. Эти компоненты, отображающие множество 
импортируемых серверов СОМ, рассмотрены в разделе 6.4.4 главы 6. А в данном 
разделе мы рассмотрим демонстрационный пример приложения, использующий 
сервер Word при работе с базами данных. 

Пример такого приложения приведен на рис. 11.12. Попробуйте сделать ана- 
логичное и испытать на нем описанные методы работа с серверами СОМ. Соответ- 
ствующий пример приведен на диске, приложенном к книге. 

Приложение позволяет просматривать таблицу Pers базы данных № и заносить 
в активный документ Word, начиная с текущей позиции курсора, сведения о со- 
труднике из выбранной пользователем записи или заносить информацию о всех за- 
писях таблицы. При этом пользователь может отбирать, какая именно информа- 
ция будет заноситься в документ. Фамилия, имя и отчество сотрудника заносятся 
в любом случае. Наименование подразделения, в котором работает сотрудник, за- 
носится в виде «Сотрудник подразделения ...» или «Сотрудница подразделения 
...» ТОЛЬКО в сЛУЧае, если пользователем нажата соответствующая кнопка на инст- 
рументальной панели (ее имя в приведенном далее коде — TBDep). Занесение в до- 
кумент года рождения, характеристики и фотографии также определяется тем, на- 
жаты или не нажаты соответственно кнопки ТВУеаг, TBCharact, TBPhoto на ин- 
струментальной панели. На рис. 11.12 6 все эти кнопки изображены в нажатом со- 
стоянии в середине панели. Фрагмент документа Word, подготовленного приложе- 
нием, приведен на рис. 11.13. 

Внесенный в документ текст может быть автоматически отформатирован. 
Стиль шрифта при форматировании определяется нажатием кнопок инструменталь- 
ной панели TBBold — жирный, TBItalic — курсив, TBUnderline — подчеркнутый. 
Выравнивание введенного текста определяется тем, какая из кнопок TBLeft (влево), 
TBCenter (по центру) или TBRight (вправо) нажата. На рис. 11.12 6 эти кнопки 
крайние правые на инструментальной панели. 
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Рис. 11.12. 9} | : i 
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Приложение может управлять сервером Word, выполняя такие стандартные 
действия, как создание нового документа, открытие файла, сохранение документа 
в файле, предварительный просмотр, печать. 

Работа с Word может протекать невидимо для пользователя (кроме, конечно, 
стандартных диалогов открытия файла и т.п.). Но пользователь может, нажав со- 
ответствующую кнопку на инструментальной панели, сделать окно Word види- 
мым, перейти в него, отредактировать текст, написать дополнительный текст, т.е. 
может нормальным образом работать с Word. 

Теперь перейдем к описанию построения приложения. Оно включает в себя 
следующие компоненты. Связь с базой данных № осуществляет компонент Queryl, 
в свойстве SQL которого записан оператор 


Select * from Pers Order by Fam, Nam, Par 


Источником данных, связанным с Queryl, является DataSourcel. С ним свя- 
заны компоненты отображения данных DBEditl — DBEdit7, отображающие тек- 
стовые поля записи, компонент DBRichEdit1, отображающий характеристику, и 
компонент DBImagel, отображающий фотографию. 
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На форме расположен компонент ActionListl, в котором описаны основные 
действия, выполняемые в приложении: 


Обработчик 
ТРоги1-> ААПЕхесше 
TForm1->AExitExecute 


TForm1->ANewExecute 


TForm1->AOpenExecute 


TForm1->APreviewExecute 


Сделать Word видимым 


ad 


Компонент ActionListl связан с компонентом типа TImageList, содержащим 
пиктограммы для быстрых кнопок и разделов меню. 

В верхней части формы расположена инструментальная панель — компонент 
Тоо]Ваг1 с множеством быстрых кнопок. Имена некоторых из них, которые исполь- 
зуются в коде приложения, были приведены выше при описании функционирова- 
ния приложения. Меню, как всегда, создано с помощью компонента MainMenu. 

Внизу формы расположена полоса состояния, в которой отображаются под- 
сказки кнопок инструментальной панели и разделов меню. Для отображения под- 
сказок в приложение введен компонент ApplicationEventsl, обработчик события 
OnHint которого обеспечивает отображение свойств Hint кнопок и разделов меню 
в полосе состояния. 


Рис. 11.13. Иванов Иван Иванович 
Фрагмент документа, подготовленного 


демонстрационным приложением 1950 года рождения 
Сотрудник подразделения 'Бухгалтерия‘ 


Характеристика 

Иванова Ивана Ивановича, 
1950 r.p., 

сотрудника бухгалтерии 


И.И. Иванов отличный работник. 


Начальник ОК ИИ. Иванов 
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Диаграмма, отображающая ход формирования документа при занесении в 
него всех записей, реализована компонентом ProgressBarl (см. раздел 3.4.3). Его 
свойство Visible установлено в false, чтобы компонент не был виден. Его изобра- 
жение появляется на форме только во время формирования документа. 

На форме размещены серверы СОМ: компоненты WordApplication1, Word- 
Documentl1, УогаЕоп{1 и WordParagraphFormatl. Их свойства AutoConnect yc- 
тановлены в false. Свойство ConnectKind в компоненте WordApplication1 уста- 
новлено равным ckRunningOrNew, а в остальных серверах равно ckAttachTo- 
Interface. 

Ниже приведен текст кода приложения с некоторыми не имеющими значения 
купюрами. 

Заголовочный файл: 


class TForml : public TForm 


{ 


__ published: // IDE-managed Components 

private: // User declarations 
void _fastcall aininanemearakivesds) 

public: // User declarations 


__fastcall TForml (TComponent* Owner) ; 
}; 


Файл реализации: 
#include <Clipbrd.hpp¥r-se-_. 


void _fastcall TForml: : DocumentSearch (void) 
{ 
//Проверка наличия открытого документа 
if (WordApplicationl->Documents->Count == 0) 
{ 
Application->MessageBox("B Word нет открытого документа", 
"Команда не выполнена", 
MB OK + МВ ТСОМЕХСЬАМАТТОМ); 
Abort (); 
} 
WordDocument1->ConnectTo (WordApplicationl->ActiveDocument) ; 
} 
Ё——ы—ы—ыыы—ы—ы=—- 
void _fastcall TForml::FormCreate(TObject *Sender) 
{ ь 
Оцегу1->Ореп (); 
/* Выключение проверок синтаксиса и грамматики, 
чтобы не замедлять работу Winword*/ 
WordApplicationl->Options->CheckSpellingAsYouType = false; 
WordApplicationl->Options->CheckGrammarAsYouType = false; 
if (WordApplicationl->Documents->Count == 0) 
{ 
ASave->Enabled = false; 
APreview->Enabled = false; 
APrint->Enabled = false; 
ARecord->Enabled = false; 
AA11->Enabled = false; 
} 
} ч 
LE RRM WRN Asem See NA 
void _fastcall TForml::ANewExecute(TObject *Sender) 
{ 
//Открытие нового документа 
WordApplicationl->Documents->Add(EmptyParam, EmptyParam) ; 
ASave->Enabled = true; 


Зы 
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APreview->Enabled = true; 
APrint->Enabled = true; 
ARecord->Enabled = true; 
AA11->Enabled = true; 

} 

ан 

void _ fastcall TForml::AAl11Execute(TObject *Sender) 

{ 

//Перенос в документ всех записей 
TBookmark SavePlace; 

//Закладка на текущей записи в 
SavePlace = Queryl->GetBookmark () ; 

Queryl->First(); 

//Сообщение в строке состояния 
StatusBarl->SimpleText = "Идет формирование документа"; 

//Настройка диаграммы 
ProgressBarl->Max = Queryl->RecordCount; 
ProgressBarl->Position = 0; 

ProgressBarl->Visible = true; 
//Цикл по записям 
while (! Queryl->Eof) 
{ 
ARecordExecute (Sender) ; 
ProgressBarl->Position = ProgressBarl->Position + 1; 
Queryl->Next (); ' 
} 

//Возвращение Ha текущую запись 
Query1l->GotoBookmark (SavePlace) ; 

//Очистка закладки, полосы состояния и диаграммы 
Queryl->FreeBookmark (SavePlace) ; 
StatusBarl->SimpleText = ""; 

ProgressBarl->Visible = false; 

} 

ВИН ЧАР 

void _fastcall TForml::ARecordExecute(TObject *Sender) 
{ 

TVariant snew = "\n"; 

//Перенос в документ одной записи 
DocumentSearch (); 
WordApplicationl->Selection->InsertAfter(snew) ; 
WordApplicationl->Selection->InsertAfter ( 

TVariant (QuerylFAM->AsString + ' ' + 
QuerylNAM->AsString + ' ' + 
QuerylPAR->AsString + '\n')); 

WordApplicationl->Selection->InsertAfter (snew) ; 

if (TBYear->Down) 
{ 
WordApplicationl->Selection->InsertAfter ( 
TVariant (Оцегу1УЕАВ B->AsString + " года рождения \п")); 
WordApplicationl->Selection->InsertAfter (snew) ; 
} 
if (TBDep->Down) 
{ | 
if (Query1SEX->AsString == !м') . 
WordApplicationl->Selection->InsertAfter ( 
TVariant ("Сотрудник подразделения '"+ 
Queryl1DEP->AsString + "'\n")); 
else WordApplicationl->Selection->InsertAfter ( 
TVariant ("Сотрудница подразделения '"+ 
QuerylDEP->AsString + "'\n")); 
} 
if (TBCharact->Down) 
{ 
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WordApplicationl->Selection->InsertAfter (snew) ; 
WordApplicationl->Selection->InsertAfter ( 
TVariant (DBRichEdit1->Text) ); 
WordApplicationl->Selection->InsertAfter (snew) ; 
} 

//Форматирование шрифта введенного текста 
WordFont1->ConnectTo (WordApplicationl->Selection->Font) ; 
if (TBUnderline->Down) 

WordFontl->Underline = wdUnderlineSingle; 
else WordFontl->Underline = wdUnderlineNone; 
if (TBBold->Down) 

WordFontl->Bold = 1; 
else WordFont1l->Bold = 0; 
if (TBItalic->Down) 

WordFontl->Italic = 1; 
else WordFontl->Italic = 0; 

//Форматирование абзацев введенного текста 
WordParagraphFormat1l->ConnectTo ( 

WordApplicationl->Selection->ParagraphFormat) ; 
if (TBLeft->Down) 


WordParagraphFormatl->Alignment = wdAlignParagraphLeft; 
if (TBCenter->Down) 
WordParagraphFormatl->Alignment = wdAlignParagraphCenter; 


if (TBRight->Down) 
WordParagraphFormat1->Alignment 
TVariant Direction = wdCollapseEnd; 
WordApplicationl->Selection->Collapse (&Direction) ; 
//Перенос в документ фотографии 
if (TBPhoto->Down) 
{ 
* Clipboard()->Assign(DBImagel->Picture) ; 
WordApplicationl->Selection->Paste(); 
WordApplicationl->Selection->InsertAfter (snew) ; 


wdAlignParagraphRight; 


} 

} 

an a. eee ee ame 

void _fastcall TForml::ASaveExecute(TObject *Sender) 

{ 
DocumentSearch (); 
WordApplicationl->Dialogs->Item(wdDialogFileSaveAs) -> 

Show (EmptyParam) ; 

} 

|  _— emer a olin 

void _fastcall TForml::AWordExecute(TObject *Sender) 

{ 

//Открытие и соединение с Word, - 

//если пользователь случайно закрыл его 
WordApplicationl->Connect (); 

//Включение видимости сервера 
WordApplicationl->Visible = true; 

} 

ILE aT 

void _fastcall TForml::ApplicationEventslHint (TObject *Sender) 

{ 

//Отображение подсказок в строке состояния 
StatusBarl->SimpleText = Application->Hint; 

} 

ьм————————=——: 

void _fastcall TForml::FormDestroy(TObject *Sender) 

{ 

/*Разрыв соединения с базой данных при завешении приложения*/ 
Queryl->Close(); 

} 


``“. 
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а ион 
void _fastcall ТРогм1: : АРг1пеЕхесисе (ТОр]есе *Sender) 


{ 
//Печать 
DocumentSearch (); 
WordApplicationl->Visible = true; 
WordApplicationl->Dialogs->Item(wdDialogFilePrint) -> 
Show (EmptyParam) ; 
} 
Хр re BRAUER aR RC RGU CATa 


void  fastcall TForml: :APreviewExecute(TObject *Sender) 
{ 

//Предварительный просмотр документа 

DocumentSearch() ; 

WordDocument1->PrintPreview() ; 
WordApplicationl->Visible = true; 

} ’ 

ионы и нд 
void _fastcall TFarml: :AExitExecute(TObject *Sender) 


{ 
//Выход 


С1о$е (); 
} 


тн 
“Woid __fastcall TForml: :AOpenExecute(TObject *Sender) 
4,4 { rs 
//Открытие файла 
WordApplicationl->Visible = true; 
if (WordApplicationl->Dialogs->Item(wdDialogFileOpen) -> ^ 
Show(EmptyParam) == -1) 
| 
ASave->Enabled = false; 
APreview->Enabled = false; 
APrint->Enabled = false; 
ARecord->Enabled = false; 
АА11->Епаб1еа = false; 
} 
} 


Приведенный код содержит подробные комментарии. К, тому же, многие фраг- 
менты этого кода уже были подробно разобраны при обсуждении свойств и методов 
серверов в разделе 6.4.4. Так что ограничимся только краткими дополнительными 
пояснениями. 

Поскольку в тексте приложения в процедуре ТЕогт1->АКесог4Ехесще ис- 
пользуется объект буфера обмена Clipboard, через который осуществляется пере- 
сылка в документ фотографии, то в оператор включена директива компилятора, 
подключающая модуль Clipbrd. Без ссылки Ha этот модуль компилятор не понял 
бы идентификатора Clipboard. 

Основные процедуры, связанные с серверами, прокомментированы в тексте и 
вряд ли нуждаются в дополнительных пояснениях. Имеет смысл только обратить 
внимание на то, что процедура ТЕогт1->ААПЕхесще, соответствующая переносу 
в документ информации о всех записях таблицы, только организует цикл по запи- 
сям, но сама перенос информации в документ не делает, обращаясь для этого к 
процедуре TForm1->ARecordExecute, которая переносит в документ текущую за- 
пись. Чтобы цикл не сбивал текущую запись, установленную ранее пользователем, 
перед началом цикла с помощью метода GetBookmark создается закладка Save- 
Place типа TBookmark, соответствующая текущей записи. После завершения цик- 
ла методом GotoBookmark происходит возврат на эту закладку, после чего она 
уничтожается методом FreeBookmark. 
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Перед началом цикла настраивается и делается видимой диаграмма Progress- 
Ваг1. Ее свойство Position изменяется на каждом цикле. После завершения цикла 
ProgressBarl опять делается невидимой. 

Процедура DocumentSearch, которая объявлена в заголовочном модуле как 
функция-элемент класса, обеспечивает проверку наличия в Word хотя бы одного 
открытого документа. Это необходимо делать при выполнении таких операций, 
как сохранение файла, его печать ит.п., которые бессмысленны в отсутствие доку- 
мента. Поэтому в начале подобных процедур вызывается DocumentSearch. 

На этом мы закончим рассмотрение данного примера. Сделайте сами подоб- 
ный пример и поэкспериментируйте с ним. Учтите, что компиляция и вообще все 
операции с приложением, использующим серверы, могут выполняться заметно 
медленнее обычного. Но это только во время отладки. Если вы выполните сделан- 
ное приложение не из среды C++Builder, то никаких задержек выполнения не бу- 
дет. 

Конечно, данный пример чисто демонстрационный, но его можно было бы лег- 
ко развить. Можно добавить в него рассмотренные в предыдущих главах способы 
фильтрации данных, быстрого поиска нужной информации и т.п. Вы можете ис- 
пользовать все возможности, предоставляемые C++Builder для создания приложе- 
ний, работающих с базами данных. А сервер Word дополнит ваше приложение воз- 
можностями включения информации в любые отчеты, обзоры, аналитические за- 
писки, в которых должна фигурировать информация из баз данных. 
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Справочные данные 
по языку С++ 


В настоящей главе приводятся основные справочные сведения по той версии 
языка С++, которая используется в C++Builder. Впрочем, некоторые конструк- 
ции, применяемые в C++Builder, характерны скорее для языка С, а не C++. A He- 
которые особенности языка, связанные с библиотечными компонентами, относят- 
ся к языку Object Pascal. Так что сведения, приводимые в этой и последующих 
главах, относятся ко всем языкам, используемым в C++Builder. Впрочем, в случа- 
ях, когда возможно применить несколько альтернативных подходов, предпочте- 
ние все-таки отдается С++. 


12.1 Синтаксис языка 


Основные синтаксические правила записи программ на языке С++ сводятся к 
следующему: 

Ш Прописные и строчные буквы считаются разными символами. Поэтому, на- 
пример, идентификаторы DATABASE, DataBase, Database и database отно- 
сятся к совершенно разным переменным, константам или объектам. При за- 
писи идентификаторов могут использоваться латинские буквы, цифры, сим- 
вол подчеркивания «_». Идентификатор не может начинаться с цифры и не 
может содержать пробельных символов. Длина идентификатора не ограниче- 
на, но ради удобства чтения программы надо стремиться использовать корот- 
кие и осмысленные идентификаторы. 


Ш Пробельные символы (пробелы, знаки табуляции, символ новой строки, ком- 
ментарий) могут размещаться в любом месте текста, но не внутри идентифика- 
тора. 

Ш Комментарии в тексте заключаются в скобки вида /* текст комментария */. Ta- 
кие комментарии могут вводится в любом месте текста, в частности, внутри 
операторов, и занимать любое количество строк. Вложенные комментарии 
обычно не допускаются. Считается, что комментарий закончился, как только 
в тексте встретились первые символы «*/». Впрочем, в C++Builder 5 можно 
обеспечить использование вложенных комментариев. Для этого надо вклю- 
чить опцию Nested Comments на страница Advanced Compiler окна опций проек- 
та. Однако, в стандарте С вложенные комментарии не допускаются, так что их 
использование делает код непереносимым на другие платформы. Именно поэ- 
тому данная опция по умолчанию выключена. Еще один способ введение ком- 
ментария — размещение его после двух символов слеш «//». Этот коммента- 
рий должен занимать конец строки, в которой он введен, и не может перехо- 
дить на следующую строку. Любой текст в строке, помещенный после симво- 
лов «//», воспринимается как комментарий. 


Ш Каждое предложение языка кончается символом точка с запятой «;». Немно- 
гие исключения из этого правила будут оговорены особо. 


Ш В строке может размещаться несколько операторов. Однако, с точки зрения 
простоты чтения текста этим не надо злоупотреблять. Вообще, надо писать 
программу так, чтобы ее было легко читать и вам, и постороннему человеку, 
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которому, может быть, придется ее сопровождать. Надо выделять объединен- 
ные смыслом операторы в группы, широко используя для этого отступы и 
комментарии. 


Ш Фигурные скобки { } выделяют составной оператор. Все операторы, помещен- 
ные между ними, воспринимаются синтаксически как один оператор. 


Ш Все используемые типы, константы, переменные, функции должны быть объ- 
явлены или описаны до их первого использования. Объявления могут встреча- 
ться в любом месте текста. 


Структуру программы на языке С++ и отдельных ее модулей см. в главе 1 в 
разделах 1.5.3 и 1.5.4. 


12.2 Директивы препроцессора 


Обработка программы препроцессором происходит перед ее компиляцией. На 
этом этапе предварительной обработки вы можете выполнить следующие дейст- 
вия: включить в компилируемый файл другие файлы, определить символические 
константы и макросы, задать режим условной компиляции программного кода и 
условного выполнения директив препроцессора. Все директивы препроцессора на- 
чинаются с символа «#»› и до начала директивы в‘строке могут находиться только 
символы пробела. Любая строка, начинающаяся с символа «#», воспринимается 
как директива препроцессора. 
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12.2.1 Директива #include 


Директива #include применяется для включения копии указанного в дирек- 
тиве файла в то месте, где находится эта директива. Существуют три формы дирек- 
тивы #Hinclude: 

#include <имя_файла> 


#include "имя файла" 
#include идентификатор макроса 


Последняя форма предполагает, что первый значащий символ после слова 
include не равен ни '<', Hu”. Предполагается, что макрос, идентификатор кото- 
рого используется в этой форме директивы, предварительно определен и использу- 
ет одну из первых двух форм директивы #include. 

Различие между первыми двумя формами директивы заключается в методе 
поиска препроцессором включаемого файла. Если имя файла заключено в угловые 
скобки (<и >), как это делается для включения заголовочных файлов стандартной 
библиотеки, то последовательность поиска препроцессором заданного файла в ка- 
талогах определяется заданными каталогами включения (include directories). Если 
_ же имя файла заключено в кавычки, препроцессор ищет файл, просматривая ката- 
логи в следующей последовательности: 


Ш каталог того файла, который содержит директиву #include 

каталоги файлов, которые включили в данный файл директивой #include 
текущий каталог 

каталоги, указанные опцией компилятора /I 

каталоги, заданные переменной окружения INCLUDE 
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Впрочем, этот поиск производится только в случае, если имя файла указано 
без пути к нему. Если же файл в директиве указан с путем, то никакие другие ка- 
талоги не просматриваются. 

Обработка директивы #ще4е препроцессором сводится к тому, что директи- 
ва убирается из текста и на ее место заносится копия указанного файла. 

Директива #include обычно используется для включения стандартных заголо- 
вочных файлов библиотек и для включения заголовочных файлов в файлы их pea- 
лизации. Директива #include используется также при работе с программами, со- 
стоящими из нескольких исходных файлов, которые должны компилироваться 
вместе. В C++Builder это соответствует файлам с несколькими формами. 

Рассмотрим примеры директив. 

Следующая директива включает файл vel.h, который ищется в стандартном 
каталоге включаемых файлов: 


#include <vcl.h> 


Следующая директива включает файл Unitl.h, который ищется прежде всего 
в каталоге, в котором расположен файл, содержащий данную директиву: 


#include “Unitl.h" 


Следующие директивы включают файл C:\Test\My.h, который ищется только 
в каталоге C:\Test: 


#define myincl "C:\Test\My.h" 
#include myincl 


12.2.2 Директивы препроцессора #define и #undef 


12.2.2.1 Символические константы 


Директивы препроцессора #define создают символические константы или 
макросы без параметров, обозначаемые идентификаторами, и макросы — опера- 
ции, обозначаемые символьными строками. Формат директивы препроцессора 
#define при объявлении символической константы: 


#define идентификатор константы замещающий текст 


Если замещающий текст длинный, его можно перенести на следующую стро- 
ку, введя символ обратного слеша «\». 

Приведенная форма директивы создает макрос без параметров, называемый 
обычно символической константой. После появления этой строки в файле все 
встретившиеся далее в тексте программы имена, совпавшие с элементом директи- 
вы идентификатор_константы, будут автоматически заменены на указанный в дирек- 
тиве замещающий_текст прежде, чем начнется компиляция программы. Например, 
после задания директивы 


#define РТ 3.14159 


все последующие вхождения в текст программы символической константы PI будут 
заменены на численную константу 3.14159. Замена идентификатора константы не 
производится в комментариях и строках символов. Если замещающий текст в ди- 
рективе не задан, то во всем тексте идентификаторы константы просто стираются. 
После замены текста этот текст опять просматривается препроцессором в по- 
исках необходимости новых замен. Таким образом, можно использовать вложен- 
ные определения символических констант. | 
Символические константы дают возможность программисту присвоить кон- 
станте имя и использовать его далее в программе. Если возникнет необходимость из- 
менить значение константы во всей программе, для этого достаточно будет внести 
только одно изменение в директиву препроцессора #define и перекомпилировать 
программу; значение константы будет изменено по всей программе автоматически. 


656 Глава 12 


п Р е ду yt р ежд е be и е ИЕ О И А ИИ ELE CREEL РИ ААА В LEGER E ОАО СОНИ О ЯВ ИИ Хр AE, 


Учтите, что все, что находится справа от идентификатора символической константы, является 
замещающим ее текстом. Например, после выполнения директивы #define Р! =3.14159 пре- 
процессор заменит всё имена Р! на текст «=3.14159». 

В C++ отдается предпочтение использованию именованных переменных типа 
const, а не символических констант. Константные переменные являются данными 
определенного типа и их имена видны отладчику. А если используется символиче- 
ская константа, то после того, как символическая константа была заменена на со- 
ответствующий текст, только этот текст и будет виден отладчику. Правда, недос- 
татком переменных типа const является то, что им требуется память в объеме, со- 
ответствующем их типу, для хранения своего значения, тогда как для символиче- 
ских констант не требуется никакой дополнительной памяти. 

Ниже приведены примеры определения с помощью директивы #4ейте симво- 
лических констант: 


// определение строки текста: 
#define Anyk "Нажмите любую клавишу" 


// идентификатор Delete в тексте просто удалится: 
#define Delete 


// определение директивы #include: 
#define GETSTD #include <stdio.h> 


12.2.2.2 Макросы с параметрами 
Формат директивы #define, определяющей макрос с параметрами: 


#define идентификатор макроса (аргументы) замещающий текст 


Между идентификатором макроса и открывающейся скобкой не должно быть 
пробела, 
Вызов макроса осуществляется выражением: 


идентификатор макроса (аргументы) 


Макрос, определяемый директивой препроцессора #4ей те, это символическое 
имя некоторых операций. Как и в случае символических констант, идентификатор 
макроса заменяется на замещающий текст до начала компиляции программы. Но 
сначала в замещающий текст подставляются значения параметров, а затем уже 
этот расширенный макрос подставляется в текст вместо идентификатора макроса 
и списка его параметров. 

Например, следующий макрос с одним параметром определяет площадь кру- 
га, воспринимая передаваемый в него параметр как радиус: 


#define CIRC(x) (3.14159 * (x) * (x)) 
Везде в тексте файла, где появится идентификатор CIRC (А), значение apry- 
мента А будет использовано для замены х в замещающем тексте и этот расширен- 


ный текст макроса будет использован для замещения. Например, оператор с мак- 
росом в тексте программы 


$ = С1БС (4); 
примет вид: 
В=-12.20159 * (4). = (4})3 
Поскольку это выражение состоит только из констант, его значение будет вы- 


числено во время компиляции и полученный результат будет присвоен перемен- 
ной S во время выполнения программы. 


’ 
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Если вызов имеет вид 
5`=`СТАСДа’ +. BF 

то после расширения макроса текст будет иметь вид: 
6::= {3.291359 “а ). “ба: 41d) )s 


В данном случае аргумент макроса является выражением, содержащим пере- 
менные а и Ъ. Поэтому вычисления будет осуществляться не во время компиля- 
ции, а во время выполнения программы. 

Обратите внимание на круглые скобки вокруг каждого включения параметра 
х в тексте рассмотренного макроса и вокруг всего выражения. При вызове типа 
CIRC(4) они кажутся излишними. Но во втором примере вызова при отсутствии 
скобок расширение привело бы к оператору: 


Se: 3. 14189 *" ae: Bb ев 


Тогда в соответствии CO старшинством операций (см. раздел 12.7.15) сначала 
выполнилось бы умножение 3.14159 * a, затем b * a, а затем результаты этих ум- 
ножений сложились бы друг с другом и с b. Конечно, результат вычислений был 
бы неверным. | 


Хороший стиль программирования -------- ео ии 
При объявлении макроса заключайте в скобки параметры в замещающем тексте и сам за- 
мещающий текст. Это избавит от возможных неприятностей, связанных с неверной последо- 
вательностью вычислений при расширении макроса. 

Приведем еще один пример: макрос, определяющий площадь эллипса через 
значения его полуосей, может быть объявлен директивой 
#define Ell(x,y) (3.14159 * (x) * (y)) 


Вызов этого макроса может иметь вид: 
$ = Ell(R1, R2); 


С точки зрения получаемых результатов вычислений макросы эквивалентны 
функциям. Например, вычисление площади круга можно было бы оформить 
функцией: 


double circ(double x) 


{ 
return .3. 2315259: eit ey 


} 
и вызывать ее оператором: 
$ = circ(a + b); 


Таким образом, возникает вопрос, что выгоднее использовать: макросы или 
функции. : 

Вызов функции сопряжен с накладными расходами и затягивает выполнение про- 
граммы. Это соображение работает в пользу использования макросов. С другой сторо- 
ны, макрос расширяется во всех местах текста, где используется его вызов. Если таких 
мест в программе много, то это увеличивает размер текста и, соответственно, размер 
выполняемого модуля. Так что функции позволяют сокращать объем выполняемого 
файла, а махросы — сокращать скорость выполнения. Правда, макросы тоже могут 
быть связаны с дополнительными накладными ресходами. В приведенном примере 
значение параметра а + Ъ вычисляется дважды, в то время, как в функции это вычис- 
ление осуществляется только один раз. Конечно, для таких простых вычислений это не 
существенно. Но если в качестве параметра передается сложное выражение, обращаю- 
щееся в свою очередь к каким-нибудь сложным функциям, то эти дополнительные на- 
кладные расходы могут стать заметными и затянуть вычисления. 
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Недостатком макросов является отсутствие встроенного контроля согласова- 
ния типов аргументов и формальных параметров. Отсутствие соответствующих 
предупреждений компилятора может приводить к ошибкам программы, которые 
трудно отлавливать. Но наиболее существенный недостаток макросов — возмож- 
ность появления побочных эффектов, если в качестве аргумента в макрос переда- 
ется некоторое выражение. Например, если описанный выше макрос СТКС, вычис- 
ляющий площадь круга, вызвать следующим образом: 


$ = СБС (а++) р: 


предполагая рассчитать площадь и затем операцией постфиксного инкремента (см. 
раздел 12.7.2) увеличить радиус на 1, то макрос будет расширен так: 


(3 T4159, ® tatt+) .* (а++).); 


При этом площадь будет вычислена верно, HO постфиксный инкремент вычис- 
лится два раза. В результате значение радиуса а будет увеличено не на 1, ана 2. 
Если же это макрос вызвать следующим образом: 


> =.CIRC (++a) 


/ 
предполагая увеличить радиус на 1 и вычислить площадь круга с таким увеличен- 
ным радиусом, то макрос будет раситирен так: 


> = (3.14459 (++а} * (+4€a)); 


При этом площадь будет определена неверно, так как в процессе вычислений 
радиус будет увеличен дважды и выражение окажется эквивалентным следующе- 
му: | 
5 > (3.14159. ^-ца +1)^*. (ape 2)); 


Всех этих побочных эффектов не будет, если вместо макроса использовать опи- 
санную выше функцию circ. 

При выборе реализации вычислений функцией или макросом надо обеспечи- 
вать компромисс между скоростью вычислений и затратами памяти. Для неболь- 
ших функций, возможно, наилучшим решением является применение встраивае- 
мых функций (inline — см. раздел 12.5.6). Для них проблемы оптимальной реали- 
зации реитает компилятор, и делает это OH, вероятно, не хуже нас с вами. 


~~ 
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Избегайте применения сложных макросов с параметрами, так как они могут приводить к не- 
желательным побочным эффектам. Вместо подобных макросов лучше использовать встраи- 
ваемые функции ш[пе. 
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12.2.2.3 Директива #undef 


Определения символических констант и макросов могут быть аннулированы 
при помощи директивы препроцессора #undef, имеющей вид: 


#undef идентификатор 


Директива отменяет определение символической константы или макроса с 
указанным идентификатором. Таким образом, область действия символической 
константы или макроса начинается с места их определения и заканчивается яв- 
ным их аннулированием директивой #undef или концом файла. После аннулиро- 
вания соответствующий идентификатор может быть снова использован в директи- 
ве #define. 

Например, возможен следующий код: 


#define MyConst 128 
// Здесь константа MyConst равна 128 


обои бай 
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#undef MyConst 
// Здесь константу MyConst использовать нельзя 


#define MyConst 64 
// Здесь константа MyConst равна 64 


у 


.—= 


12.2.3 Условная компиляция: директивы #1, #епаН, #ifdef, #ifndef, 
#е[5е, #elif 


Условная компиляция дает возможность программисту управлять выполнени- 
ем директив препроцессора и компиляцией программного кода. Каждая условная 
директива препроцессора вычисляет значение целочисленного константного выра- 
жения. Операции преобразования типов, операция sizeof и константы перечисли- 
мого типа не могут участвовать в выражениях, вычисляемых в директивах пре- 
процессора. 

Условная директива препроцессора #if во многом похожа на оператор if. Ее 
синтаксис имеет вид: 

#1Е условие 


фрагмент кода 
fendif 


В этой записи условие является целочисленным выражением. Если это выра- 
жение возвращает не нуль (истинно), то фрагмент кода, заключенный между ди- 
рективой #Ё и директивой #Hendif, компилируется. Если же выражение возвраща- 
ет нуль (ложно), то этот фрагмент игнорируется и препроцессором, и компилято- 
ром. | 

В условиях, помимо обычных выражений, можно использовать конструкцию 


defined идентификатор 


defined возвращает 1, если указанный идентификатор ранее был определен дирек- 
тивой #define, и возвращает 0 в противном случае. Например, возможен следую- . 
щий код: 


#if defined Debug && !defined MyConst 
фрагмент кода 
#endif 


Фрагмент кода будет выполняться, если ранее была записана директива 
#define Debug 
и не было директивы 
#define MyConst 
или эта директива была отменена директивой 
#undef MyConst 


Конструкция #if defined может быть заменена эквивалентной ей директивой 
#Hifdef, а конструкция #Ё !\defined — директивой #ifndef. Например, тексты 


#ifdef Size 


#endif Е 


и 
#if defined Size 
#endif 

эквивалентны. рае 
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Можно использовать более сложные конструкции условных директив препро- 
цессора при помощи директив #elif (эквивалент else if в обычной структуре if) и 
#е]5е (эквивалент else в структуре if). Например, в коде 

#1Е условие 1 

фрагмент кода 1 

#е11Ё условие 2 

фрагмент кода 2 
#else 


фрагмент кода 3 
#endif 


фрагмент кода 1 будет компилироваться, если выполняется условие 1, фрагмент 
кода 2 будет компилироваться, если выполняется условие 2,'a фрагмент кода 3 бу- 
дет компилироваться, если не выполняется ни одно из предыдущих условий. 

Условная компиляция может быть полезна во многих случаях. Например, не- 
редко в процессе отладки приложения в него полезно ввести различные отладоч- 
ные печати, позволяющие следить за ходом выполнения программы (см. главу 2 
раздел 2.6.11). Если вы не хотите, чтобы эти печати оставались в окончательном 
варианте программы, вы можете в разных местах приложения ввести конструк- 
ции вида 

#ifdef Debug 


операторы отладки 
#епа1 Ё 


Тогда, если в начале программы вы введете директиву 
#define Debug 


операторы отладки будут компилироваться и выполняться. Но когда вы уберете 
или закомментируете эту директиву #define, определяющую введенный вами 
идентификатор Debug, все операторы отладки исчезнут из текста. Можно посту- 
пить даже проще, ничего не изменяя в тексте, а оперируя опцией Conditionals на 
странице Directories/Conditionals диалогового окна Project Options (см. в главе 14 
раздел 14.2.8). 

Конечно, вы могли бы поступить иначе: ввести переменную булева типа 
Debug, задать ей в начале выполнения приложения значение true и оформлять от- 
ладки следующим образом: 


#1Е (Debug) 
{ 


операторы отладки 


} 


Если в дальнейшем заменить задаваемое значение Debug на false, то операто- 
ры отладки перестанут выполняться. Отличие этого подхода от использования ди- 
ректив препроцессора заключается в том, что коды операторов отладки в этом слу- 
чае останутся в тексте программы, увеличивая размер выполняемого модуля. А 
директивы условной компиляции просто уберут отладочный код из программы. 

Приведем еще один пример использования условной компиляции. Если вы 
взглянете на заголовочный файл любого модуля формы вашего приложения, то 
увидите, что C++Builder первыми операторами вставляет в него директивы вида: 


ifndef Unitl1H 
“ define Unitl1H 


A завершается заголовочный файл директивой 
#endif 


Что это дает? Это позволяет исключить зацикливание при циклических ди- 
рективах #include, включающих в различных модулях заголовочные файлы друг 
друга. Когда в приложение первый раз включается модуль Unitl.h, то выполняют- 
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ся указанные выше первые две директивы и идентификатор UnitlH оказывается 
определен. После этого компилируется текст файла. Но если в результате дирек- 
тив #include этот же файл будет включаться еще один раз, то обнаружится, что 
идентификатор UnitlH уже определен, и повторной компиляции файла не про- 
изойдет. 


12.2.4 Директивы #error, #line, #ргадта 


Директива препроцессора #error имеет следующий синтаксис: 


#error errmsg 


Директива печатает в процессе компиляции сообщение об ошибке вида: 


Error: filename line# : Error directive: errmsg 


где errmsg — сообщение, заданное директивой #еггог. После печати этого сообще- 
ния компиляция прекращается. 

Директива используется в сочетании с директивами условной компиляции и 
срабатывает при возникновении условий, не позволяющих продолжить работу. 
Например: 

#ifndef UnitlH 

#error Не найден файл Unitl.h 


Директива препроцессора #line задает целочисленное константное начальное 
значение номера строки для нумерации следующих за директивой строк исходного 
текста программы. Возможны две формы директивы: 


#line номер строки 
#11пе номер строки "имя файла" 


Элемент директивы номер строки задает начальное значение номера строки. 
Все последующие строки исходного текста программы будут нумероваться, начи- 
ная с этого номера. Если в директиву включено имя файла, то не только изменяет- 
ся нумерация последующих строк программы, но и компилятор во всех своих сооб- 
щениях будет ссылаться на файл с указанным именем. Директива #Ппе обычно ис- 
пользуется для того, чтобы сделать сообщения о синтаксических ошибках и преду- 
преждения компилятора более удобными для понимания. Номера строк не добав- 
ляются в исходный файл. Пример директивы: 


#line 100 "Unitl.cpp" 


Применение директивы #Йпе делает работу с отладчиком C++Builder не очень 
удобной. При возникновении ошибки курсор в окне Редактора Кода останавлива- 
ется не на строке с ошибкой, а на начале текущего файла или, если в директиве 
указано имя другого существующего файла, то на начале этого файла. Так что 
можно рекомендовать не использовать без особой надобности директиву #line. 

Директива #pragma имеет следующий синтаксис: 


#pragma имя опции 


и вызывает действия, зависящие от указанной опции. Список возможных опций 
вы можете найти во встроенной справке C++Builder. Он довольно обширен и свя- 
зан с различными режимами работы препроцессора. 

Пример директивы #pragma вы можете видеть в любом модуле своего проек- 
та. Первые две строки файла любого модуля имеют вид: 


#include <vcl.h> 
#pragma hdrstop 


Здесь использована опция hdrstop. Она связана с особенностью работы пре- 
процессора, производительность которого существенно повышается, если учиты- 
вается, что некоторое количество заголовочных файлов общие для всех модулей. 
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Директива #pragma hdrstop указывает компилятору конец списка таких общих 
файлов. Так что надо следить за тем, чтобы не добавлять перед этой директивой 
включение каких-то заголовочных файлов, не являющихся общими для других 
модулей. 

В файлах модулей вы можете увидеть еще две директивы #pragma: 


#pragma package(smart init) 
#pragma resource "*.dfm" 


Первая из них: определяет последовательность инициализации пакетов такой, 
какая устанавливается взаимными ссылками использующих их модулей. Вторая 
говорит препроцессору, что для формы надо использовать файл .dfm с тем же име- 
нем, что и имя данного файла. Во избежание всяких неприятностей лучше не тро- 
гать и не изменять эти директивы. | 


12.2.5 Операции препроцессора # и ## 


Операция препроцессора # применяется к параметрам макросов, представ- 
ляющим собой лексемы (текст). Операция преобразует лексему в строку символов, 
взятую в кавычки. Например, если определен следующий макрос: 


#define Pers(x) Labell->Caption = "Сотрудник " #x 


и в тексте программы OH вызван оператором 


Pers (Иванов); 


то он будет расширяться до 


Labell->Caption = "Сотрудник " "Иванов" 


Строка «Иванов» заменила параметр #х в замещающем тексте. Строки, разде- 
ленные символами пробела, сцепляются (склеиваются) во время предварительной 
обработки, так что вышеприведенный оператор эквивалентен оператору 


Labell->Caption = "Сотрудник Иванов" 


Операция ## выполняет конкатенацию (сцепление, склеивание) двух лексем. 
Например, если определен макрос 


#define Concat(x,y) x ## у 


то встреченное в тексте программы выражение Concat(Edit,1) будет преобразовано 
в Edit1. 


12.3 Константы 


12.3.1 Неименованные константы 


Константы могут использоваться непосредственно в тексте программы в лю- 
бых операторах и выражениях. Имеется 4 типа констант: целые, с плавающей за- 
пятой, символьные (включая строки) и перечислимые. Например: 25 и -5 — целые 
константы, 4.8, 5е15, 5E15, -5.1е8 — константы с плавающей запятой, ‘A’, '\0', \п', 
'007`— символьные константы, «Это строка» — строковая константа. 

_ Целые константы могут быть десятичные, восьмеричные и шестнадцатерич- 
ные. Восьмеричные начинаются с символа нуля, после которого следуют восьме- 
ричные цифры (от 0 до 7). Например: 032. Запись константы вида 08 будет воспри- 
нята как ошибка, поскольку 8 не является восьмеричной цифрой. Восьмеричные 
константы не могут превышать значения 0377777777/7. Значения, большие этой 
величины, усекаются. 
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Шестнадцатеричные константы начинаются с символов нуля и Х или х, после 
которых следуют шестнадцатеричные цифры (от 0 до К, можно записывать в верх- 
нем или нижнем регистрах). Например: ОХРО]. Шестнадцатеричные константы не 
могут превышать значения OxFFFFFFFF. Значения, большие этой величины, усека- 
ются. 

Символьные константы должны заключаться в одинарные кавычки. Эти кон- 
станты хранятся Kak Char, signed char или unsigned char. 

Строковые константы заключаются в двойные кавычки. Они хранятся как по- 
следовательность символов, завершающаяся нулевым символом '\0'. Пустая стро- 
ка содержит только нулевой символ. 

Если две строковые константы разделены в тексте только пробельным симво- 
лом, они склеиваются в одну строку. Например: 


"Это начало строки, " "а это ее продолжение" 
ИЛИ 


"Это начало строки, " 
"а это. ее продолжение" 


воспримутся как константа 


"Это начало строки, а это ее продолжение" 


Перенос длинной строки с одной строчки кода в другую можно делать не толь- 


ко так, как показано выше, но и помещая в конец первой строчки одиночный сим- 
вол обратного слеша '\'. Например, запись 


"Это начало строки, \ 
а это ее продолжение" 


воспримется как одна строка. 
В строковой константе можно использовать управляющие символы, предва- 
ряемые обратным слешем (см. раздел 15.1.3 главы 15). Например, константа 


"\"Имя\"\Е \tAnpec\nUBaHoB\t \tMocKBa" 


будет при отображении на экране выглядеть так 


"Имя" Адрес 

Иванов Москва 

Кавычки после символа \ воспринимаются как символ кавычек, а не как 
окончание строки. Символы \t и \п означают соответственно табуляцию и перевод 
строки. 

Если в константу должен быть включен обратный слеш «\», то надо поместить 
подряд два слеша. Например, строка 


"c:\\test\\test.cpp" 
будет откомпилирована (если компиляция авы с опцией -А) как. 
"c:\test\test.cpp" 


п редуп режден ие О О О REESE SLES LL RSL ва 


В константах, содержащих путь к файлу, не забывайте, что для включения в строку символа 
\’надо повторить этот символ два раза, 


кои PLL OED LOE EE LE LOE бо о а о О о о оо о ла BPPESLA 


Константы перечислимого типа объявляются следующим образом: 
enum имя {значения}; 
Например, оператор 


enum color { red, yellow, green }; 


wal 
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объявляет переменную с именем со]ог, которая может принимать константные 
значения red, yellow или green. Эти значения в дальнейшем можно использовать 
как константы для присваивания переменной color или для проверки ее значения. 
Этим константам соответствуют целые значения, определяемые их местом в спис- 
ке объявления: red — 0, yellow — 1, green — 2. Эти значения можно изменить, 
если инициализировать константы явным образом. Например, объявление 


enum color { red, yellow = 3, green = red + 1}; 


приведет к тому, что значения констант будут равны: red — 0, yellow — 3, green — 1. 
При этом не обязательно должна соблюдаться уникальность значений. Несколько 
констант в списке могут иметь одинаковые значения. 

В C++Builder имеется ряд предопределенных констант, основные из которых 
true — истина, false — ложь, NULL — нулевой указатель. 


12.3.2 Именованные константы 


Именованная константа — это константа, которой присвоен некоторый иден- 
тификатор. Объявление именованной константы является указателем для компи- 
лятора заменить во всем тексте этот идентификатор значением константы. Такая 
замена производится только в процессе компиляции и не отражается на исходном 
тексте. 

Цель объявления именованной константы — сделать текст более осмыслен- 
ным и облегчить при необходимости изменение значения константы во всем тек- 
сте. Например, если в тексте многократно используется число 55, означающее 
максимально допустимое значение каких-то переменных, то проверки 


af (8 > ШМах)`... 
более понятны, чем 

ТЕ: > * 95) 

При необходимости сменить это число, проще изменить его в одном месте про- 
граммы — в объявлении константы ММах, чем искать по всему тексту числа 55, 
которые, к тому же, в разных частях программы могут иметь разный смысл. 


Именованные константы объявляются так же, как переменные. (см. раздел 
12.4.1), но с добавлением модификатора const: 


const тип имя константы = значение; 
Например: 
const float Pi = 3.14159; 


В качестве значения константы можно указывать и константное выражение, 
содержащее ранее объявленные константы. Например, если вы объявили констан- 
ту Pi, то далее можете объявить константы 


const float Pi2 = 2 * Pi; // удвоенное число Пи 
const float Kd = Р1/180; // коэффициент пересчета градусов 
// в радианы 


Для целых констант тип можно не указывать: 


const maxint = 12345; 
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Не забывайте указывать тип для констант, тип которых отличен от int. Например, объявление 
const Pi = 3.14159; присвоит константе Pi значение 3, поскольку константа без указания типа 
считается целой. 
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Попытка где-то в тексте изменить значение именованной константы приведет 
к ошибке компиляции с выдачей соответствующего сообщения. 
Приведем еще примеры объявления именованных констант: 


char *const $611 
char const *str2 


"Привет!"; 
"Всем привет!"; 


Первое объявление вводит константу Strl, являющуюся постоянным указате- 
лем на строку. Второе объявляет указатель Str2 на строковую константу. Этот ука- 
затель не является константой. Его в процессе выполнения программы можно из- 
менить так, чтобы он указывал на другую строковую константу. Иначе говоря, 
оператор : 


str2 = stri; 


допустим, a оператор 
stri = str2; 


вызовет ошибку компиляции. 


12.4 Переменные 


12.4.1 Объявление переменных 


Переменная является идентификатором, обозначающим некоторую область в 
памяти, в которой хранится значение переменной. Это значение может изменяться 
во время выполнения приложения. 

Объявление переменной имеет вид: 


тип список идентификаторов переменных; 


Список идентификаторов может состоять из идентификаторов переменных, 
разделенных запятыми. Например: 


int- xl, ХЕ? 


Одновременно с объявлением некоторые или все переменные могут быть ини- 
циализированы. Например: 


пех 1:29:20; 


Для инициализации можно использовать не только константы, но и произ- 
вольные выражения, содержащие объявленные ранее константы и переменные. 
Например: 

ИС ЖЕ by Ree У; 


\ 


Объявление переменных может быть отдельным оператором или делаться 
внутри таких операторов, как, например, оператор цикла: 


for ’( int Г=0; {< 10; 344+) 


12.4.2 Классы памяти 


Каждая переменная характеризуется некоторым классом памяти, который 
определяет ее время жизни — период, в течение которого эта переменная сущест- 
вует в памяти. Одни переменные существуют недолго, другие — неоднократно соз- 
даются и уничтожаются, третьи — существуют на протяжении всего времени вы- 
полнения программы. 

В C++Builder имеется четыре спецификации класса памяти: auto, register, 
extern и static. Спецификация класса памяти идентификатора определяет его 
класс памяти, область действия и пространство имен. 
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Областью действия (областью видимости) идентификатора называется об- 

ласть программы, в которой на данную переменную (как, впрочем, и на любой 
идентификатор — константу, функцию ит.п.) можно сослаться. На некоторые пе- 
ременные можно сослаться в любом месте программы, тогда как на другие — толь- 
_ ко в определенных ее частях. 
Класс памяти определяется, в частности, местом объявления переменной. Ло- 
кальные переменные объявляются внутри некоторого блока или функции. Эти пе- 
ременные видны только в пределах того блока, в котором они объявлены. Блоком 
называется фрагмент кода, ограниченный фигурными скобками «{ }». Глобальные 
переменные объявляются вне какого-либо блока или функции. 

Спецификации класса памяти могут быть разбиты на два класса: автомати- 
ческий класс памяти с локальным временем жизни и статический класс памяти 
с глобальным временем жизни. Ключевые слова auto и register используются для 
объявления переменных с локальным временем жизни. Эти спецификации приме- 
нимы только к локальным переменным. Локальные переменные создаются при 
входе в блок, в котором они объявлены, существуют лишь во время активности` 
блока и исчезают при выходе из блока. 

Спецификация auto, как и другие спецификации, может указываться перед 
типом в объявлении переменных. Например: 


auto float x, у; 4 


Локальные переменные являются переменными с локальным временем жизни 
по умолчанию, так что ключевое слово auto используется редко. Далее мы будем 
ссылаться на переменные автоматического класса памяти просто как на автомати- 
ческие переменные. 

Пусть, например, имеется следующий фрагмент кода: 

{ 


111 = 1; 
1++; 
} 


к которому в ходе работы программы происходит неоднократное обращение. При 
каждом таком обращении переменная 1 будет создаваться заново (под нее будет вы- 
деляться память) и будет инициализироваться единицей. Затем в ходе работы про- 
граммы ее значение будет увеличиваться на 1 операцией инкремента. В конце вы- 
полнения этого блока переменная исчезнет и выделенная под нее память освобо- 
дится. Следовательно, в такой локальной переменной невозможно хранить ка- 
кую-то информацию между двумя обращениями к блоку. 

Спецификация класса памяти register может быть помещена перед объявле- 
нием автоматической переменной, чтобы компилятор сохранял переменную не в 
памяти, а в одном из высокоскоростных аппаратных регистров компьютера. На- 
пример: 

$е913сег int 1. = 1; 


Если интенсивно используемые переменные, такие как счетчики или суммы 
могут сохраняться в аппаратных регистрах, накладные расходы на повторную за- 
грузку переменных из памяти в регистр и обратную загрузку результата в память 
могут быть исключены. Это сокращает время вычислений. 

Компилятор может проигнорировать объявления register. Например, может 
оказаться недостаточным количество регистров, доступных компилятору для ис- 
пользования. K тому же оптимизирующий компилятор способен распознавать час- 
то используемые переменные и решать, помещать их в регистры или нет. Так что 
явное объявление спецификации register используется редко. 
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Ключевые слова extern и static используются, чтобы объявить идентификато- 
ры переменных как идентификаторы статического класса памяти с глобальным 
временем жизни. Такие переменные существуют с момента начала выполнения 
программы. Для таких переменных память выделяется и инициализируется сразу 
после начала выполнения программы. 

Существует два типа переменных статического класса памяти: глобальные пе- 
ременные и локальные переменные, объявленные спецификацией класса памяти 
static. Глобальные переменные по умолчанию относятся к классу памяти extern. 
Глобальные переменные создаются путем размещения их объявлений вне описа- 
ния какой-либо функции и сохраняют свои значения в течение всего времени вы- 
полнения программы. На глобальные переменные может ссылаться любая функ- 
ция, которая расположена после их объявления или описания в файле. 
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Переменные, используемые только в отдельной функции, предпочтительнее объявлять как ло- 

кальные переменные этой функции, а не как глобальные переменные. Это облегчает чтение 

боевые и позволяет т избежать Sst даны а, BOCK © к таким Repay ee ри bs drench 

Локальные переменные, объявленные с ключевым словом Static, известны 
только в том блоке, в котором они определены. Но в отличие от автоматических 
переменных, локальные переменные Static сохраняют свои значения в течение 
всего времени выполнения программы. При каждом следующем обращении к это- 
му блоку локальные переменные содержат те значения, которые они имели при 
предыдущем обращении. 

Вернемся к уже рассмотренному выше примеру, но укажем для переменной 1 
статический класс: 

{ 


static int: 2° 21? 
1++; 
} 


Инициализация переменной 1 произойдет только один раз за время выполне- 
ния программы. При первом обращении к этому блоку значение переменной 1 бу- 
дет равно 1. К концу выполнения блока ее значение станет равно 2. При следую- 
щем обращении к блоку это значение сохранится и при окончании повторного вы- 
полнения блока 1 будет равно 3. Таким образом, статическая переменная способна 
хранить информацию между обращениями к блоку и, следовательно, может ис- 
пользоваться, например, как счетчик числа обращений. 

Все числовые переменные статического класса памяти принимают нулевые на- 
чальные значения, если программист явно не указал другие начальные значения. 
Статические переменные — указатели, тоже имеют нулевые начальные значения. 

Спецификации класса памяти extern используются в программах с несколь- 
кими файлами. Пусть, например, в модуле Unitl в файле Unitl.cpp или Unitl.h 
(это безразлично) объявлена глобальная переменная 


int а = 5; 
Тогда, если в другом модуле Unit2 в файле Unit2.cpp или Unit2.h объявлена 
глобальная переменная 


extern int а; 


то компилятор понимает, что речь идет об одной и той же переменной. И оба моду- 
ля могут с ней работать. Для этого даже нет необходимости связывать эти модули 
директивой #include (см. раздел 12.2.1), включающей в модуль Unitl заголовоч- 
ный файл второго модуля. 

Подробнее области видимости переменных рассмотрены в разделе 12.6. 
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12.5 Функции 


12.5.1 Объявление и описание функций 


Функции представляют собой программные блоки, которые могут вызываться 
из. разных частей программы. При вызове в них передаются некоторые перемен- 
ные, константы, выражения, являющиеся аргументами, которые в самих процеду- 
рах и функциях воспринимаются как формальные параметры. При этом функции 
возвращают значение определенного типа, которое замещает В вызвавшем выра- 
жении имя вызванной функции. 

Например, оператор 


Те Sac Р(Х); 


вызывает функцию Е с аргументом X, умножает возвращенное ею значение на 5 и 
присваивает результат переменной Г. 

Допускается также вызов функции, не использующий возвращаемого ею зна- 
чения. Например: 


Е(Х).;. 


В этом случае возвращаемое функцией значение игнорируется. 
Функция описывается следующим образом: 


тип возвращаемого значения имя функции (список параметров) 


{ 


операторы тела функции мел 

ВЕ № \ 

Первая строка этого описания, содержащая тип возвращаемого значения, имя 
функции и список параметров, называется заголовком функции. Тип возвращае- 
мого значения может быть любым, кроме массива и функции. Могут быть также 
функции, не возвращающцие никакого значения. В заголовке таких функций тип 
возвращаемого значения объявляется Void. 

Если тип возвращаемого значения не указан, он по умолчанию считается рав- 
ным int. 


ао 


Хороший стиль программирования -...-.- 


Хотя тип возвращаемого значения int можно не указывать в заголовке функции, не следует 
использовать эту возможность. Всегда указывайте тип возвращаемого значения, кроме глав- 
ной функции тат. Указание типа делает программу более наглядной и предотвращает воз- 
можные ошибки, связанные с неправильным преобразованием типов. 
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Список параметров, заключаемый в скобки, в простейшем случае (более слож- 
ные формы задания списка параметров будут рассмотрены позднее) представляет 
собой разделяемый запятыми список вида 
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тип параметра иденификатор параметра 
Например, заголовок: 
double FSum(double X1,double X2, int. A) 


объявляет функцию с именем FSum, с тремя параметрами X1, Х2 и A, из которых 
первые два имеют тип double, а последний — int. Тип возвращаемого результа- 
та — double. Имена параметров Х1, ХЗ и А — локальные, т.е. они имеют значение 
только внутри данной функции и никак не связаны с именами аргументов, пере- 
данных при вызове функции. Значения этих параметров в начале выполнения 
функции равны значениям аргументов на момент вызова функции. Подробнее эти 
вопросы будут рассмотрены в разделе 12.5.2. 
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Ниже приведен заголовок функции, не возвращающей никакого значения: 

void SPrint(AnsiString 5) 

Она принимает один параметр типа строки и, например, отображает его в Ka- 
ком-нибудь окне приложения. 


Если функция не принимает никаких параметров, то скобки или оставляются 
пустыми, или в них записывается ключевое слово void. Например: 


void Е] (void) 
ИЛИ 
void Е] () 


Хороший стиль программирования еее неее 
Всегда указывайте void в списке параметров, если функция не получает никаких парамет- 
ров. Это делает программу более переносимоя. 
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Предупреждение 
Роль пустого списка параметров функции в С++ существенно отличается от аналогичного 
списка в языке С. В С это означает, что все проверки аргументов отсутствуют (т.е. вызов фун- 
кции может передать любой аргумент, который требуется). А в С++ пустой список означает 
отсутствие аргументов. Таким образом, программа Ha С, использующая эту особенность, 
может сообщить о синтаксической ошибке при компиляции в С++. 


Как правило (хотя формально не обязательно), помимо описания функции в 
текст программы включается также прототип функции — ее предварительное 
объявление. Прототип представляет собой тот же заголовок функции, но с точкой 
с запятой «;» в конце. Кроме того, в прототипе можно не указывать имена пара- 
метров. Если вы все-таки указываете имена, то их областью действия является 
только этот прототип функции. Вы можете использовать те же идентификаторы в 
любом месте программы в любом качестве. Таким образом, указание имен пара- 
метров в прототипе обычно преследует только одну цель — документирование про- 
граммы, напоминание вам или сопровождающему программу человеку, какой па- 
раметр что именно обозначает. 

Примеры прототипов приведенных выше заголовков функций: 

double FSum(double X1,double X2, int A); 

void SPrint(AnsiString S); 

void F1l(void); 


или 


double FSum(double, double, int); 
void SPrint(AnsiString); 
void F1(); 


Введение в программу прототипов функций преследует несколько целей. 
Во-первых, это позволяет использовать в данном модуле функцию, описанную в 
каком-нибудь другом модуле. Тогда из прототипа компилятор получает сведения, 
сколько параметров, какого типа и в какой последовательности получает данная 
функция. Во-вторых, если в начале модуля вы определили прототипы функций, то 
последовательность размещения в модуле описания функций безразлична. При от- 
сутствии прототипов любая используемая функция должна быть описана до ее 
первого вызова в тексте. Это прибавляет вам хлопот, а иногда при взаимных вызо- 
вах функций друг из друга вообще невозможно. И, наконец, прототипы, разме- 
щенные в одном месте (обычно в начале модуля), делают программу более нагляд- 
ной и самодокументированной. Особенно в случае, если вы снабжаете прототипы 
хотя бы краткими комментариями. 
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Если предполагается, что какие-то из описанных в модуле функций могут ис- 
пользоваться в других модулях, прототипы этих функций следует включать в за- 
головочный файл. Тогда в модулях, использующих данные функции, достаточно 
будет написать директиву #include (см. раздел 12.2.1), включающую данный заго- 
ловочный файл; и не надо будет повторять прототипы функций. 
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Включайте в модуль где-то в одном месте (обычно в начале) прототипы всех описанных в нем 
ваших функций с краткими комментариями. Это хорошо документирует программу, делает 
ее нагляднее, позволяет вам не заботиться о последовательности описаний функций. Если вы 
хотите, чтобы какие-то из описанных в модуле функций могли использовать другие модули, 
включайте прототипы этих функций в заголовочный файл. 
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Обычно функции принимают указанное в прототипе число параметров указан- 
ных типов. Однако, могут быть функции, принимающие различное число парамет- 
ров (например, библиотечная функция printf) или параметры неопределенных за- 
ранее типов. В этом случае в прототипе вместо неизвестного числа параметров или 
вместо параметров неизвестного типа ставится многоточие ‹...». Многоточие мо- 
жет помещаться только в конце списка параметров после известного числа пара- 
метров известного типа или полностью заменять список параметров. Например: 


int »prfitchar: *format, /..}; 


Функция с подобным прототипом принимает один параметр format типа char 
* (например; строку форматирования) и произвольное число параметров произ- 
вольного типа. Функция с прототипом 
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может принимать произвольное число параметров произвольного типа. 

Если в прототипе встречается многоточие, то типы соответствующих парамет- 
ров и их количество компилятором не проверяются. 

Объявлению функции могут предшествовать спецификаторы класса памяти 
extern или static. Спецификатор extern предполагается по умолчанию, так что за- 
писывать его не имеет смысла. K функциям, объявленным как extern, можно по- 
лучить доступ из других модулей программы (см. заключительную часть раздела 
12.6.1 и раздел 1.5.5.4 в главе 1). Если же объявить функцию со спецификатором 
static, например 

| 


Static void F(void); 


то доступ к ней из других модулей невозможен. Это надо использовать в крупных 
проектах во избежание недоразумений при случайных совпадениях имен функций 
в различных модулях. 

Теперь рассмотрим описание тела функции. Тело функции пишется по тем же 
правилам, что и любой код программы, и может содержать объявления типов, кон- 
стант, переменных и любые выполняемые операторы. Не допускается объявление 
и описание в теле других функций. Таким образом, функции не могут быть вложе- 
‘ны друг в друга. | 

Надо иметь в виду, что все объявления в теле функции носят локальный ха- 
рактер. Объявленные переменные доступны только внутри данной функции. Если 
их идентификаторы совпадают с идентификаторами каких-то глобальных пере- 
менных модуля, то эти внешние переменные становятся невидимыми и недоступ- 
ными. В этих случаях получить доступ к глобальной переменной можно, поставив 
перед ее именем два двоеточия «::», т.е. применив унарную операцию разрешения 
области действия. 

Локальные переменные не просто видны только в теле функции, но по умолча- 
нию они и существуют только внутри функции, создаваясь в момент вызова функ- 
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ции и уничтожаясь в момент выхода из функции. Если требуется этого избежать, 
соответствующие переменные должны объявляться со спецификацией Static (под- 
робнее см. в разделе 12.4.2). 

Выход из функции может осуществляться, следующими способами. Если 
функция не должна возвращать никакого значения, то выход из нее происходит 
или по достижении закрывающей ее тело фигурной скобки, или при выполнении 
оператора return. Если же функция должна возвращать некоторое значение, TO 
нормальный выход из нее осуществляется оператором 


return выражение 


где выражение должно формировать возвращаемое значение ‘и соответствовать 
типу, объявленному в заголовке функции. 
Например: 


double FSum(double X1,double X2, int A) 


{ 
return: А.*. (Х1:+ X2)}; 


} 


Ниже приведен пример функции, не возвращающей никакого значения: 
void SPrint(AnsiString 5) 


f 


\ 
ie tee) 
ShowMessage(S); 
} 


Здесь возврат из функции происходит по достижении закрывающейся фигур- 
ной скобки тела функции. Приведем вариант той же функции, использующий опе- 
ратор return: 

void SPrint(AnsiString $5) 

{ 

if (S == "") return; 
ShowMessage (5); 
} 


Прервать выполнение функции можно также генерацией какого-то исключе- 
ния (см. раздел 12.10). Наиболее часто в этих целях используется процедура 
Abort, генерирующая «молчаливое» исключение EAbort, не связанное с каким-то 
сообщением об ошибке. Если в программе не предусмотрен перехват этого исклю- 
чения, то применение функции Abort выводит управление сразу наверх из всех 
вложенных друг в друга вызовов функций. 

Возвращаемое функцией значение может включать в себя вызов каких-то 
функций. В том числе функция может вызывать и саму себя, т.е. допускается ре- 
курсия. В качестве примера приведем функцию, рекурсивно вычисляющую факто- 
риал. Как известно, значение факториала равно п! = п : (п-Т) : (n-2)-...- 1, причем 
считается, что 1! =Ти 0! = 1. Факториал можно вычислить с помощью простого 
цикла for (и это, конечно, проще). Но можно факториал вычислять и с помощью 
рекуррентного соотношения п! = п : (п-1)!. Для иллюстрации рекурсии воспользу- 
емся именно этим соотношением. Тогда функция factorial вычисления факториа- 
ла может быть описана следующим образом: 


unsigned long factorial (unsigned long п) 
{ 
if (n <= 1) 
return 1; 
else 
return\ n** factorial (n.-: 1); 
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Если значение параметра п равно 0 или 1, то функция возвращает значение 1. 
В противном случае функция умножает текущее значение п на результат, возвра- 
щаемый вызовом той же функции factorial, но со значением параметра п, умень- 
шенным на единицу. Поскольку, при каждом вызове значение параметра уменьша- 
ется, рано или поздно оно станет равно 1. После этого цепочка рекурсивных вызо- 
вов начнет свертываться и в конце концов вернет значение факториала. 


12.5.2 Передача параметров в функции по значению 
и по ссылке 


Список параметров, передаваемый в функции, как было показано в предыду- 
щем разделе, состоит из имен параметров и указаний на их тип. Например, в заго- 
ловке 


double FSum(double X1,double X2, int A) 


указано три параметра ХТ, X2, A и определены их типы. Вызов такой процедуры 
может иметь вид: 


Peet "RS; S33 


Это только один из способов передачи параметров в. процедуру, называемый пе- 
редачей по значению. Работает он так. В момент вызова функции в памяти создают- 
ся временные переменные с именами X1, Х2, А, и в них копируются значения аргу- 
ментов У, Х2 и константы 5. На этом связь между аргументами и переменными Х1, 
Х2, А разрывается. Вы можете изменять внутри процедуры значения Х1, X2u A, 
но это никак не отразится на значениях аргументов. Аргументы при этом надежно 
защищены от непреднамеренного изменения своих значений вызванной функцией. 
Это предотвращает случайные побочные эффекты, которые так сильно мешают ино- 
гда созданию корректного и надежного программного обеспечения. 

К недостаткам такой передачи параметров по значению относятся затраты 
времени на копирование значений и затраты памяти для хранения копии. Если 
речь идет о какой-то переменной простого типа, это, конечно, не существенно. Но 
если, например, аргумент — массив из тысяч элементов, то соображения затрат 
времени и памяти могут стать существенными. 

Еще одним недостатком передачи параметров по значению является невоз- 
можность из функций изменять значения некоторых аргументов, что во многих 
случаях очень желательно. . 

Возможен и другой способ передачи параметров — вызов по ссылке. В случае 
вызова по ссылке оператор вызова дает вызываемой функции возможность прямо- 
го доступа к передаваемым данным, а также возможность изменения этих данных. 
Вызов по ссылке хорош в смысле производительности, потому что он исключает 
накладные расходы на копирование больших объемов данных; в то же время он 
может ослабить защищенность, потому что вызываемая функция может испортить 
передаваемые в нее данные. 

Вызов по ссылке можно осуществить двумя способами: с помощью ссылочных 
параметров и с помощью указателей. Ссылочный параметр — это псевдоним соот- 
ветствующего аргумента. Чтобы показать, что параметр функции передан по ссыл- 
ке, после типа параметра в прототипе функции ставится символ амперсанта (&); 
такое же обозначение используется в списке типов параметров в заголовке функ- 
ции. Перед амперсантом и после него могут вставляться пробельные символы. На- 
пример, идентичные объявления 


int &count 
int & count 
int& count 


в списке параметров заголовка функции могут читаться как «count является ссыл- 
кой на int». В вызове такой функции достаточно указать имя переменной и она бу- 
‘\ 
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дет передана по ссылке. Реально в функцию передается не сама переменная, а ее 
адрес, полученный операцией адресации (&). Тогда упоминание в теле вызываемой 
функции переменной по имени ее параметра в действительности является обраще- 
нием к исходной переменной в вызывающей функции и эта исходная переменная 
может быть изменена непосредственно вызываемой функцией. 


Например: 
void square(int &); // Прототип функции вычисления квадрата 
void square(int ба) // Заголовок функции 
{ 
а *= а; // Изменение значения параметра 


} 


Вызываться подобная функция может обычным способом передачей в нее име- 
ни аргумента. Например: 


int xl = 2; 
square (xl); 


В результате подобного вызова переменная х1 получит значение 4. 
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Поскольку ссылочные параметры упоминаются в теле вызываемой функции просто по имени, 
программист может нечаянно принять ссылочный параметр за параметр, переданный по 
значению. Это может привести к неприятным ошибкам, если исходные значения переменных 
изменяются вызывающей функцией. 

Альтернативной формой передачи параметра по ссылке является использова- 
ние указателей (см. раздел 13.7 главы 13). Тогда адрес переменной передается в 
функцию не операцией адресации (&), а операцией косвенной адресации (*). В спи- 
ске параметров подобной функции перед именем переменной указывается символ 
«*», свидетельствуя о TOM, что передается не сама переменная, а указатель на нее. 
В теле функции тоже перед именем параметра ставится символ операции разыме- 
нования *, чтобы получить доступ через указатель к значению переменной (пояс- 
нения всего этого вы можете найти в разделе 13.7 главы 13). А при вызове функ- 
ции в нее в качестве аргумента должна передаваться не сама переменная, а ее ад- 
рес, получаемый с помощью операции адресации &. 

Приведем пример той же рассмотренной ранее функции Square, но с переда- 
чей параметра по ссылке с помощью указателя: 


void square(int *); // Прототип функции вычисления квадрата 
void square(int *а) // Заголовок функции 
{ 

ха *= *а; // Изменение значения параметра 


} 


Вызов подобной функции может осуществляться, например, следующим обра- 
зом: 


int Xi ® 23 
square (&х1); 


12.5.3 Применение при передаче параметров спецификации 
const 


В предыдущем разделе была рассмотрена передача параметров по ссылке. Она 
решает сразу две задачи: исключает накладные расходы, связанные с копировани- 
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ем передаваемых значений, и дает функции доступ для изменения значений пере- 
даваемых аргументов. Однако, иногда требуется решать только первую задачу: из- 
бавиться от копирования громоздких аргументов типа больших массивов. Но при 
этом не требуется позволять функции изменять значения аргументов. 

Это может быть осуществлено передачей в функцию аргументов как констант. 
Для этого перед соответствующими переменными в списке ставится ключевое сло- 
во const. 

При использовании ссылочного параметра заголовок функции (именно заголо- 
вок описания, поскольку в прототипе спецификатор const указывать не обязатель- 
но) может иметь следующий вид: 


double F(const &A) 


В этом случае аргумент A He будет копироваться при вызове функции, HO 
внутри функции изменить значение А будет невозможно. При попытке сделать та- 
кое изменение компилятор выдаст сообщение: «Cannot modify а const object». 

Подобная передача параметра как константы позволяет сделать код более эф- 
фективным, так как при этом компилятору заведомо известно, что никакие изме- 
нения параметра невозможны. 

При использовании указателей для передачи параметров в | chit BO3MO?K- 
ны четыре варианта: неконстантный указатель на неконстантные данные, HEKOH- 
стантный указатель на константные данные, константный указатель на некон- 
стантные данные и константный указатель на константные данные. Каждая ком- 
бинация обеспечивает доступ с разным уровнем привилегий. 

Наивысший уровень доступа предоставляется неконстантным указателем на 
неконстантные данные — данные можно модифицировать посредством разымено- 
вания указателя, а сам указатель может быть модифицирован, чтобы он указывал 
на другие данные. Это описанная в предыдущем разделе передача параметров по 
ссылке с помощью указателя. В этом варианте передачи параметров спецификатор 
const не используется. 

Неконстантный указатель на константные данные — это указатель, который 
можно модифицировать, чтобы указывать на любые элементы данных подходяще- 
го типа, но сами данные, на которые он ссылается, не могут быть модифицирова- 
ны. Например, прототип: 


void F(const char *sPtr); 


объявляет функцию, в которую передается указатель SPtr, указывающий на KOH- 
стантные данные типа const char * — в данном случае строку (массив символов). В 
теле функции такой указатель можно менять, перемещая его с одного обрабатыва- 
емого символа на другой. Но сами элементы строки (массива) изменять невозмож- 
но, так как они объявлены константными. Таким образом, исходные значения 
предохраняются от их несанкционированного изменения. 

‚ Константный указатель на неконстантные данные — это указатель, который 
всегда указывает на одну и ту же ячейку памяти, данные в которой можно моди- 
фицировать посредством указателя. Этот вариант, например, реализуется по умол- 
чанию для имени массива. Имя массива — это константный указатель на начало 
массива. Используя имя массива и индексы массива можно обращаться ко всем 
данным в массиве и изменять их. Прототип функции с передачей константного 


_ указателя на неконстантные данные может иметь вид: 


void F( char *const sPtr); 


Наименьший уровень привилегий доступа предоставляет константный указа- 
тель на константные данные. Такой указатель всегда указывает на одну и ту же 
ячейку памяти и данные в этой ячейке нельзя модифицировать. Это выглядит так, 
как если бы массив нужно было передать функции, которая только просматривает 
массив, использует его индексы, но не модифицирует сам массив. Прототип функ- 
ции с подобной передачей параметра может иметь вид: 


void F(const char *const sPtr); 
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12.5.4 Параметры со значениями по умолчанию 


Обычно при вызове функции в нее передается конкретное значение каждого 
параметра. Но программист может указать, что параметр является параметром по 
умолчанию, и приписать этому параметру значение по умолчанию. Делается это 
заданием в заголовке функции после имени параметра символа «=», после которо- 
го записывается значение по умолчанию. Пусть, например, вы хотите написать 
функцию, которая рассчитывает суммарную силу, действующую на тело объемом 
У с плотностью P, погруженное в жидкость (например, воду) с плотностью РН2О. 
Как известно, формула, выражающая эту суммарную силу, направленную вверх 
(если ответ будет отрицательным, значит сила направлена вниз — тело тонет), сле- 
дующая: Е = G *У * (P - PH2O), где С — ускорение свободного падения. 

Функцию, определяющую эту силу, можно описать следующим образом: 

double Arh(double У = 1, double Р = 0.5, double PH20 = 1, 


double G = 9.81) 
{ return. С. * У * (PH20.- P);..} 


Здесь всем параметрам даны значения по умолчанию. Объем У по умолчанию 
принят равным 1 м3, плотность тела Р по умолчанию равна 0.5 т/м3 (плотность не- 
которых пород дерева), плотность воды РН2О принята по умолчанию равной 1 
т/м3, а ускорение свободного падения G принято равным 9,81 м/с?. 

Если при вызове функции параметр по умолчанию не указан, то в функцию 
автоматически передается его значение по умолчанию. Например, если вызвать 
приведенную функцию оператором 


ЕК = Arh(); 


то значение Е будет равно силе при значениях всех параметров по умолчанию. 
Аргументы по умолчанию должны быть самыми правыми (последними) аргу- 

ментами в списке параметров функции. Если вызывается функция с двумя или 6бо- 

лее параметрами по умолчанию и если пропущенный параметр не является самым 

правым в списке, то все параметры справа от пропущенного тоже пропускаются. 
Например, вызов той же функции оператором 


Е = Arh(2); 


позволяет рассчитать силу, действующую на тело объемом 2 м3 при значениях 
всех остальных параметров по умолчанию. Вызов функции оператором 


F = Arh(2,2.6); 


позволяет рассчитать силу, действующую на алюминиевое (плотность 2.6 T/M?) 
тело объемом 2 м3 при значениях остальных параметров по умолчанию. Аналогич- 
но, задав при вызове три параметра можно рассчитать силу, действующую на тело, 
погруженное в жидкость другой плотности, а задав все четыре параметра можно 
определить силу, действующую на тело при эксперименте, проводящемся не на 
уровне моря (при этом изменится ускорение свободного падения). 

Этот пример показывает, что последними в списке параметров со значениями 
по умолчанию надо указывать те параметры, значения которых в реальных зада- 
чах чаще всего остаются равными заданным по умолчанию. 

Пропускать при вызове можно только некоторое число последних параметров 
в списке. Например, нельзя вызвать функцию таким образом: 


Е = Arh(2,,1.1); // Ошибочный вызов 
Параметры по умолчанию должны быть указаны при первом упоминании име- 


ни функции — обычно в прототипе. Значения по умолчанию могут быть констан- 
тами, глобальными переменными или вызовами функций. 
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12.5.5 Передача в функции переменного числа параметров 


Иногда в функции требуется передавать некоторое число фиксированных па- 
раметров плюс неопределенное число дополнительных параметров. В этом случае 
заголовок функции имеет вид: 


тип имя функции (список аргументов, ...) 


В данном случае список аргументов включает в себя конечное число обяза- 
тельных аргументов (этот список не может быть пустым), после которого ставится 
многоточие на месте неопределенного числа параметров. Для работы с этими пара- 
метрами в файле stdarg.h определен тип списка va_list и три макроса: va_start, 
уа_агй и va_end. 

Макрос va_start имеет синтаксис: 


void va_start(va list ap, lastfix) 


Этот макрос начинает работу со списком, устанавливая его указатель ap на 
первый передаваемый в функцию аргумент из списка с неопределенным числом 
аргументов. Параметр lastfix — это имя последнего из обязательных аргументов 


функции. 
Макрос va_arg имеет синтаксис: 


type va_arg(va list ap, type) 


Макрос возвращает значение очередного аргумента из списка. Параметр type 
указывает тип аргумента. Перед вызовом Va_arg значение ар должно быть уста- 
новлено вызовом уа_5$$фагё или va_arg. Каждый вызов Va_arg переводит указатель 
ар на следующий аргумент. 

Макрос va_end имеет синтаксис: 


void va_end(va_ list ар) 


Макрос завершает работу co списком, освобождая память. OH должен вызы- 
ваться после того, как с помощью Va_arg прочитан весь список аргументов. В про- 
тивном случае могут быть непредсказуемые последствия. 

Рассмотрим пример. Пусть требуется создать функцию average, которая рас- 
считывает и отображает в метке Labell среднее значение передаваемых в нее це- 
лых положительных чисел. Функция принимает в качестве первого аргумента не- 
которое сообщение, которое должно отображаться перед результатами расчета. 
Список обрабатываемых чисел может быть любой длины и заканчиваться нулем. 
Такая функция может быть реализована следующим образом: 


#include <stdarg.h> 


void average (AnsiString mess,...) 
{ 

double A = 0; 

int i = 0,arg; 

va_list ap; 

va_start(ap, mess); 


while ((arg = va_arg(ap,int)) != 0) 
{ 
L++; 
A += arg; 
} 
Forml->Labell->Caption = mess + "М = " +IntToStr(i) + 
", среднее = "+FloatToStr(A/i); 


уа_епа (ар); 


} 
Вызов функции может быть, например, таким: 


average ("Результаты экзамена: ",4,2,3,5,4,0); 
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В результате функция выдаст в метку Labell сообщение: 


Результаты экзамена: М = 5, среднее = 3,6 


Функцию average можно было бы организовать иначе, не вводя специальную 
конечную метку в список (в приведенном примере — 0), а предваряя список аргу- 
ментов параметром М, указывающим размер списка: 


void average (AnsiString mess,int N,...) 
{ 

double A = 0; 

va_list ap; 

\ va_start(ap, №); 

for(int 1 №0; 6 № 1+) 

А += va_arg(ap,int); 

Forml->Labell->Caption = mess + "М = " +IntToStr(N) + 

", среднее = "+FloatToStr(A/N); 

va_end(ap); 


} 
Вызов функции может быть, например, таким: 


average ("Результаты экзамена: ",5,4,2,3,5,4); 


12.5.6 Встраиваемые функции inline 


Реализация программы как набора функций хороша с точки зрения разработ- 
ки программного обеспечения, но вызовы функций приводят к накладным расхо- 
дам во время выполнения. В С++ для снижения этих накладных расходов на вызо- 
вы функций — особенно небольших функций — предусмотрены встраиваемые 
(inline) функции. Спецификация inline перед указанием типа результата в объяв- 
лении функции «советует» компилятору сгенерировать копию кода функции в CO- 
ответствующем месте, чтобы избежать вызова этой функции. Это эквивалентно 
объявлению соответствующего макроса (см. раздел 12.2.2.2). В результате получа- 
ется множество копий кода функции, вставленных в программу, вместо единст- 
венной копии, которой передается управление при каждом вызове функции. 

Компилятор может игнорировать спецификацию inline, что обычно и делает 
для всех функций, кроме самых небольших. 
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Предупреждение 
Любые изменения функции inline могут потребовать перекомпиляцию всех «потребителей» 
этой функции. Это может оказаться существенным моментом для развития и поддержки неко- 
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Хороший стиль программирования 


Спецификацию inline целесообразно применять только для небольших и часто используемых 
функций. Использование функций inline может уменьшить время выполнения программы, но 
может увеличить ее размер. Применение функций inline предпочтительнее объявления мак- 
росов, поскольку в данном случае вы даете возможность компилятору оптимизировать код. 
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Пусть, например, вам во многих частях программы приходится вычислять 
длину окружности, заданной своим радиусом К. Тогда вы можете оформить эти 
вычисления, определив встраиваемую функцию: 


inline double Circ(double В) {return 6.28318 * R;} 
Обращение в любом месте программы вида Circ(2) приведет к встраиванию в 


соответствующем месте кода 6.28318 * 2 (если компилятор сочтет это целесообраз- 
ным). 
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12.5.7 Перегрузка функций _ ку 


C++ позволяет определить несколько функций с одним и тем же именем, если 
эти функции имеют разные наборы параметров (по меньшей мере разные типы па- 
раметров). Эта особенность называется перегрузкой функции. При вызове перегру- 
женной функции компилятор С++ определяет соответствующую функцию путем 
анализа количества, типов и порядка следования аргументов в вызове. Перегрузка 
функции обычно используется для создания нескольких функций с одинаковым 
именем, предназначенных для выполнения сходных задач, но с разными типами 
данных. 


> 
Хороший стиль программирования „ооо озеленении 


Перегруженные функции, которые выполняют тесно связанные задачи, делают программы 
более понятными и легко читаемыми. 


Пусть, например, вы хотите определить функции, добавляющие в заданную 
строку типа (char *) символ пробела и значение целого числа, или значение числа с 
плавающей запятой, или значение булевой переменной. Причем хотите обращать- 
ся в любом случае к функции, которую называете, например, То$, предоставив 
компилятору самому разбираться в типе параметра и в том, какую из функций 
надо вызывать в действительности. Для решения этой задачи вы можете описать 
следующие функции: 

Char * ToS(char *S,int X) 

{return strcat(strcat(S," "),IntToStr(X).c str());} 


char * ToS(char *S, double X) 
{return strcat (strcat(S," "),FloatToStr(xX).c str());} 


char. .*..ToS.(char..*S,.: bool -.X) 
тт weer «fF roat 5." Его") 
else return strcat(S," false"); } 


Тогда в своей программе вы можете написать, например, вызовы: 


char $[128] = "Значение ="; 
char $31 = 'Тоб$:(5, 5); 


или 


char $[128] = "Значение ="; 
“nar $2 =“! ToS(S,5.3) 3 


или 


char $[128] = "Значение ="; 
char $3 = ToS(S,true); 


В первом случае будет вызвана функция с целым аргументом, во втором — с 
аргументом типа double, в третьем — с булевым аргументом. Вы видите, что пере- 
грузив соответствующие функции вы существенно облегчили свою жизнь, изба- 
вившись от необходимости думать о типе параметра. 

Приведем еще один пример, в котором перегруженные функции различаются 
количеством параметров. Ниже описана перегрузка функции, названной Агеа и 
вычисляющей площадь круга по его радиусу R, если задан один параметр, и пло- 
щадь прямоугольника по его сторонам а и Ъ, если задано два параметра: 


double Area(double В) { return 6.28318 * R * R; } 
double Area(double a, double b) { return a * b; } 


Тогда операторы вида 


Sl Агеа (1); 
$2 Агеа (1,2); 
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приведут в первом случае к вызову функции вычисления площади круга, а во вто- 
ром — к вызову функции вычисления площади прямоугольника. 

Перегруженные функции различаются компилятором с помощью их сигнату- 
ры — комбинации имени функции и типов ее параметров. Компилятор кодирует 
идентификатор каждой функции по числу и типу ее параметров (иногда это назы- 
вается декорированием имени), чтобы иметь возможность осуществлять надежное 
связывание типов. Надежное связывание типов гарантирует, что вызывается над- 
лежащая функция и что аргументы согласуются с параметрами. Компилятор вы- 
являет ошибки связывания и выдает сообщения о них. 

Для различения функций с одинаковыми именами компилятор использует 
только списки параметров. Перегруженные функции не обязательно должны 
иметь одинаковое количество параметров. Программисты должны быть осторож- 
ными, имея дело в перегруженных функциях с параметрами по умолчанию, по- 
скольку это может стать причиной неопределенности. 
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Предупреждение ~~ 
Функция с пропущенными аргументами по умолчанию может оказаться вызванной аналогич- 
но другой перегруженной функции; это синтаксическая ошибка. 
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Рассмотренный аппарат перегрузки функций — только один из возможных 
способов решения поставленной задачи, правда, универсальный, позволяющий ра- 
ботать и с разными типами параметров, и с разным числом параметров^ В следую- 
щем разделе рассмотрен еще один механизм — шаблоны, позволяющий решать 
аналогичные задачи, правда, для более узких классов функций. 


12.5.8 Шаблоны функций 


Перегруженные функции обычно используются для выполнения сходных опе- 
раций над различными типами данных. Если операции идентичны для каждого 
типа, это можно выполнить более компактно и удобно, используя шаблоны функ- 
ций. Вам достаточно написать одно единственное определение шаблона функции. 
Основываясь на типах аргументов, указанных в вызовах этой функции, С++ авто- 
матически генерирует разные функции для соответствующей обработки каждого 
типа. Таким образом, определение единственного шаблона определяет целое се- 
мейство решений. 

Все определения шаблонов функций начинаются с ключевого слова template, 
за которым следует список формальных типов параметров функции, заключенный 
в угловые скобки (<) и (>). Каждый формальный тип параметра предваряется клю- 
чевым словом Class. Формальные типы параметров — это встроенные типы или 
типы, определяемые пользователем. Они используются для задания типов аргу- 
ментов функции, для задания типов возвращаемого значения функции и для объ- 
явления переменных внутри тела описания функции. После шаблона следует 
обычное описание функции. 

Приведем пример шаблона функции, возвращающей минимальный из трех 

передаваемых в нее параметров любого (но одинакового) типа: 
| template <class T> 
T . mint DP x1 58: 8256 2 x3) 
{ 
Т lmin = xl; 
if (x2 < lmin) 
lmin = ха; 
if (x3 < lmin) 
lmin = x3; 
return lmin; 
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В заголовке шаблона этой функции объявляет единственный формальный па- 
раметр T как тип данных, который должен проверяться функцией min. В следую- 
щем далее заголовке функции этот параметр Т использован для задания типа воз- 
вращаемого значения (Т min) и для задания типов всех трех параметров x1 - x3. В 
теле функции этот же параметр Т использован для указания типа локальной пере- 
менной шит. 

Объявленный таким образом шаблон можно использовать, например, следую- 
щим образом: 


За: id = 1:42 = 3, 18 23 
double rl = 2.5, г2 = 1.7, r3 = 3.4; 
AnsiString sl = "строка 1", $2 = "строка 2", $3 = "строка 3"; 


Labell->Caption = min(il,i2,i3); : 
Label2->Caption = min(rl,r2,r3)j; 
Label3->Caption min(s3,..s2, 81) 


Когда компилятор обнаруживает вызов MIN в исходном коде программы, этот 
тип данных, переданных в шт, подставляется всюду вместо Т в определении шаб- 
лона и C++ создает законченную функцию для определения максимального из 
трех значений указанного типа данных. Затем эта созданная функция компилиру- 
ется. Таким образом, шаблоны играют роль средств генерации кода. 

Например, при вызове функции с тремя целыми параметрами компилятор 
сгенерирует функцию: 

int min(int xl, int x2, int x3) 


{ 


int inin: = x1; 

LE (2 < ИА) 
Палп = x2; 

if (x3 < lmin) 
lmin = x3; 


return min; 


} 


Приведенный шаблон будет работать для любых предопределенных или вве- 
денных пользователем типов, для которых определена операция отношения <. 


Пре дуп режден ие МООА О ВЕС ЕРЕСИ ИИ ОИ И ИРИС 


Каждый формальный параметр в определении шаблона должен хотя бы однажды появиться в 
списке параметров функции. Каждое имя формального параметра в списке определения 
шаблона должно быть уникальным. Отсутствие ключевого слова class перед каждым форма- 
льным параметром шаблона функции является ошибкой. 


а ва О а а о RES EEES EELS 


12.6 Области видимости переменных и функций 


12.6.1 Правила, определяющие область видимости 


Область видимости или область действия переменной или функции — это 
часть программы, в которой на нее можно ссылаться. Например, когда мы объяв- 
ляем локальную переменную в блоке (определение блока см. в разделе 12.4.2), на 
нее можно ссылаться только в этом блоке или в блоке, вложенном в этот блок. Су- 
ществуют четыре области действия идентификатора — область действия функ- 
ция, область действия файл, область действия блок и область действия прото- 
тип функции. 

Идентификатор, объявленный вне любой функции (на внешнем уровне), имеет 
область действия файл. Такой идентификатор «известен» всем функциям от точ- 
ки его объявления до конца файла. Глобальные переменные, описания функций и 
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прототипы функций, находящиеся вне функции — все они имеют областью дейст- 
вия файл. | 

Метки (идентификаторы-с последующим двоеточием, например, start:) — 
единственные идентификаторы, имеющие областью действия функцию. Метки 
можно использовать всюду в функции, в которой они появились, но на них нельзя 
ссылаться вне тела функции. Метки используются в структурах switch (как метки 
case) и в операторах goto (см. разделы 12.8.1.2 и 12.8.1.3). Метки относятся к тем 
деталям реализации, которые функции «прячут» друг от друга. Это скрытие — 
один из наиболее фундаментальных принципов разработки хорошего программно- 
го обеспечения. 

Идентификаторы, объявленные внутри блока (на внутреннем уровне), имеют 
областью действия блок. Область действия блок начинается объявлением иденти- 
фикатора и заканчивается конечной правой фигурной скобкой блока. Если имеют- 
ся вложенные блоки, то переменная внешнего блока видна и во вложенных бло- 
ках. 

Локальные переменные, объявленные в начале функции, имеют областью дей- 
ствия блок так же, как и параметры функции, являющиеся локальными перемен- 
ными. 

Любой блок может содержать объявления переменных. Если блоки вложены и 
идентификатор во внешнем блоке или идентификатор глобальной переменной 
идентичен идентификатору во внутреннем блоке, одноименный идентификатор 
внешнего блока или глобальный «невидим» (скрыт) до момента завершения рабо- 
ты внутреннего блока. Это означает, что пока выполняется внутренний блок, он 
видит значение своих собственных локальных идентификаторов, а не значения 
идентификаторов с идентичными именами в охватывающем блоке. Локальные пе- 
ременные, объявленные как Static, имеют областью действия блок, несмотря на 
то, что они существуют с самого начала выполнения программы. 

Из внутреннего блока можно получить доступ к одндименной глобальной пе- 
ременной с помощью унарной операции разрешения области действия «::». Напри- 
мер, выражение ::1 означает глобальную переменную I, даже если в данном блоке 
объявлена локальная переменная I. | 

Единственными идентификаторами с областью действия прототип функции 
являются те, которые используются в списке параметров прототипа функции (см. 
раздел 12.5.1). Прототипы функций не требуют имен в списке параметров — тре- 
буются только типы. Если в списке параметров прототипа функции используется 
имя, компилятор это имя игнорирует. Идентификаторы, используемые в прототи- 
пе функции, можно повторно использовать где угодно в программе, не опасаясь 
двусмысленности. | 

При необходимости обеспечить видимость переменных, объявленных в одном 
модуле, из других модулей, в эти модули должны быть добавлены объявления со- 
ответствующих переменных (без их инициализации) со спецификацией extern. 
Для видимости из других модулей функций, объявленных в каком-то модуле, надо 
повторить в соответствующих модулях объявления этих функций. Это не относит- 
ся к функциям, объявленным со спецификацией static. Такие функции невидимы 
в других модулях. 

Если в модуле, описывающем функцию, ее объявление записано в заголовоч- 
ном файле, то в другом модуле можно получить к ней доступ так, как описано 
выше, а можно и проще — включить директивой #include (см. раздел 12.2.1) этот 
заголовочный файл. 

Полный список правил, определяющих видимость переменных и функций, вы 
можете найти в главе 1 в разделе 1.5.5.4. 


682 нед, ‘почГлава 12 


12.6.2 Явное определение доступа с помощью объявлений 
namespace и using 


Изложенные в предыдущем разделе правила определяют автоматически уста- 
навливаемые области видимости. Однако такого неявного задания областей види- 
мости иногда может быть недостаточно. Если речь идет о большом проекте, кото- 
рый создается несколькими разработчиками, всегда возможно перекрытие иденти- 
фикаторов, определенных в разных местах программы. Поэтому желателен инст- 
румент, позволяющий явным образом указывать области видимости идентифика- 
торов. 

_ Таким инструментом является объявление области видимости имен ключе- 
вым словом Namespace и последующее объявление использования функций и пе- 
ременных из той или иной области ключевым словом using. 

Синтаксис объявления области видимости: 


namespace имя области 


{ 


объявления типов, переменных и функций 


} 

Например: 

namespace А{ 
int i= 1; 
void Fl(int i) 


{ 
Forml->Labell->Caption 
} 

} 

namespace B{ 

yt 1 = :2} 

void Fl(int i) 

{ 
Forml->Labell->Caption = "Область В: 1 = " + IntToStr(i); 


} 
} 


Приведенные операторы объявляют две области видимости с именами А и В. В 
обеих областях объявлены переменные i и функции Е1. 

Объявление области с тем же именем может повториться в программе и содер- 
жать объявления каких-то новых переменных и функций. Соответствующие иден- 
тификаторы добавятся в указанную область. 

Доступ к объявленным переменным и функциям из любой точки файла может 
осуществляться несколькими способами. Самый простой — с помощью операции 
разрешения области действия (::). Например, оператор 


В: ЕТ (Ai si): 


"Область А: 1 е + FntToStr4i),; 


вызовет функцию F1 из области В и передаст в нее значение переменной 1 из облас- 
ти А. 

Подобный доступ гибкий, но он требует каждый раз указывать область види- 
мости. Если явное указание областей видимости сделано для того, чтобы устранить 
появившиеся в программе случайные наложения идентификаторов, то явное ука- 
зание при каждом применении идентификатора соответствующей области дейст- 
вия потребует исправлений во многих местах программы и может привести к появ- 
лению ошибок. Более простой способ указания области действия — применение 
ключевого слова using. Одна из возможных форм применения using: 


using namespace имя области; 
Например, если поместить в тексте оператор 


using namespace А; 
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то все последующие операторы будут брать идентификаторы из области А. Тогда, 
например, размещенный где-то в тексте после using оператор 


РА {1} 


вызовет функцию F1 из области А и передаст в нее значение переменной 1 из облас- 
ти А. | | 

Операторы using могут иметь и другую форму, определяющую область для 
конкретного идентификатора: 


using имя области :: идентификатор; 


Например, после операторов 


using A::F1; 
using B::i; 


оператор 
РТ: 


вызовет функцию Е1 из области А и передаст в нее значение переменной 1 из облас- 
ти В. | 

При объявлении области видимости с помощью Namespace в теле объявления 
могут присутствовать не только объявления переменных и функций, но и операто- 
ры namespace, определяющие некоторые внутренние области видимости, и опера- 
торы using namespace, ссылающиеся на ранее определенные области. Таким обра- 
зом, области видимости могут быть вложенные. Например, объявления могут 
иметь вид: 


namespace А { 


} 
namespace B { 
using namespace A; 


namespace C { \ 


} 
} 


Здесь область В использует ранее объявленную область А и содержит внутри 
себя вложенную область С. Доступ к вложенным областям осуществляется после- 
довательным применением операции разрешения области действия. Например: 


using namespace В :: С; 


12.7 Операции 


12.7.1 Общее описание 


Операции подобны встроенным функциям языка. Они применяются к выра- 
жениям — операндам. Большинство операций имеют два операнда, один из кото- 
рых помещается перед знаком операции, а другой — после. Например, операция 
сложения «+» имеет два операнда: Х + У и складывает их. Такие операции назы- 
ваются бинарными. Существуют и унарные операции, имеющие только один опе- 
ранд, помещаемый после знака операции. Например, запись -Х означает примене- 
ние к операнду Х операции унарного минуса <in -». 

В сложных выражениях последовательность выполнения операций определя- 
ется скобками, старшинством операций, а при одинаковом старшинстве — ассо- 
циативностью операций. Эти вопросы будут обсуждены в разделе 12.7.15. 
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12.7.2 Арифметические операции 


Арифметические операции применяются к действительным числам, целым 
числам и указателям. Определены следующие бинарные арифметические опера- 
ции: 


ИЛИ ПАЯ АКА ИА ИКИ EL EEE IESE LEE SCRE DIED LER GREE ELEVEEEEG BEES RIESE IBOTS. OORT к ИХ ИЕ ИИ ТУК: 


Обозначение Операция Типы операндов и результата Пример 
+ сложение арифметический, указатель 2-Е: У 
- вычитание арифметический, указатель > ory 4 
* умножение арифметический ae 4 
/ деление арифметический » /. № 
% Остаток целочислен- целый I% 6 


ного деления 


Определены следующие унарные арифметические операции: 


ИЯ Я вр САИ ААА С ХА ПЛИТА ИН CELE ODED DE EE he 


Обозначение Операция Типы операндов и результата Пример 

+ Унарный плюс арифметический +7 
(подтверждение знака) 

- Унарный минус арифметический -Х 
(изменение знака) 

++ инкремент арифметический, указатель + 

++i 
- декремент арифметический, указатель 1--; --1 


Для арифметических операций действуют следующие правила. 

Бинарные операции сложения (+) и вычитания (-) применимы к целым и дей- 
ствительным числам, а также к указателям. 

В операции сложения указателем может быть только один из двух операндов. 
В этом случае второй операнд должен быть целым числом. Указатель, участвую- 
щий в операции сложения, должен быть указателем на элемент массива. В этом 
случае добавление к указателю целого числа эквивалентно сдвигу указателя на за- 
данное число элементов массива. 

В операции вычитания указатель на элемент массива может быть первым опе- 
рандом (тогда второй операнд — целое число) или оба операнда могут быть указа- 
телями на элементы одного массива. Вычитание из указателя целого числа эквива- 
лентно сдвигу указателя на заданное число элементов массива. Вычитание двух 
указателей возвращает число элементов массива, расположенных между теми эле- 
ментами, на которые указывают указатели. Подробнее об арифметике указателей 
см. в главе 13 в разделе 13.7. 

В операциях умножения (*) и деления (/) операнды могут быть любых ариф- 
метических типов. При разных типах операндов применяются стандартные прави- 
ла автоматического приведения типов (см. раздел 13.2 главы 13). В операции вы- 
числения остатка от деления (%) оба операнда должны быть целыми числами. 

В операциях деления и вычисления остатка второй операнд не может быть ра- 
вен нулю. Если оба операнда в этих операциях целые, а результат деления являет- 
ся не целым числом, то знак результата вычисления остатка совпадает со знаком 
первого операнда, а для операции деления используются следующие правила: 
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1. Если первый и второй операнд имеют одинаковые знаки, то результат опера- 
ции деления — наибольшее целое, меньшее истинного результата деления. 


2. Если первый и второй операнд имеют разные знаки, то результат операции де- 
ления — наименьшее целое, большее истинного результата деления. 


Округление всегда осуществляется по направлению к нулю. 

Унарные операции инкремента (++) и декремента (--) сводятся к увеличению 
(++) или уменьшению (--) операнда на единицу. Операции применимы к операн- 
дам, представляющим собой выражения любых арифметических типов или типа 
указателя. Причем выражение должно быть модифицируемым Г-значением, т.е. 
должно допускать изменение. Например, ошибочным является выражение ++(а + 
Ь), поскольку (а + b) не является переменной, которую можно модифицировать. 

Операции инкремента и декремента выполняются быстрее, чем обычное сло- 
жение и вычитание. Поэтому, если переменная а должна быть увеличена на 1, луч- 
ше применить операцию (++), чем выражения а =а + Т или оператор а += 1, ис- 
пользующий описанную в разделе 12.7.3 операцию (+=). 

Если операция инкремента или декремента помещена перед переменной, гово- 
рят о префиксной форме записи инкремента или декремента. Если операция ин- 
кремента или декремента записана после переменной, то говорят о постфиксной, 
форме записи. При префиксной форме переменная сначала увеличивается или 
уменьшается на единицу, а затем это ее новое значение используется в том выра- 
жении, в котором она встретилась. При постфиксной форме в выражении исполь- 
зуется текущее значение переменной, и только после этого ее значение увеличива- 
ется или уменьшается на единицу. | 

Например, в результате выполнения операторов 

Ant 4 = 1, fae 

j = 1++ * itt; 
значение переменной 1 будет равно 3, a переменной } - 1. Оператор, присваиваю- 
щий значение переменной } будет работать следующим образом: сначала значение 
1, равное 1, умножится само на себя, т.е. вычислится значение выражения в пра- 
вой части оператора; затем это значение присвоится переменной }, а значение 1 уве- 
личится на 1 в результате первой операции инкремента и еще раз увезичится на 1 
в результате второй операции инкремента. | 

Если изменить эти операторы следующим образом: 

int i=1, 9; 

1. 2 +42: 2.441: 
то результат будет другим: значение i будет равно 3, а значение j - 9. В этом случае 
оператор, присваивающий значение переменной j будет работать следующим обра- 
зом: сначала выполнится первая операция инкремента и значение 1 станет равно 2; 
затем выполнится вторая операция инкремента и значение 1 станет равно 3; а за- 
тем это значение 1 умножится само на себя, т.е. вычислится значение выражения в 
правой части оператора и это значение присвоится переменной j. 


12.7.3 Операции присваивания, отличие присваивания 
от метода Assign 


В C++ определен ряд операций присваивания. 


Обозначение [Операция _ Типы операндов и результата Пример 
= присваивание 
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[Обозначение Операция | Tunmtst операндов и результата Пример 


мон Присваивание арифметические, указатели, 


с вычитанием структуры, объединения 

| Присваивание арифметические 
с умножением 

|= Присваивание арифметические 

делением 


присваивание остатка целые 
целочисленного деле- 
НИЯ 


| <= Присваивание 
со сдвигом влево 
>= Присваивание 


со сдвигом вправо 


присваивание с пораз- 
рядной операцией иск- 
лючающее ИЛИ 


Помимо простой операции присваивания (=) все прочие являются составными 
операциями. Они присваивают первому операнду результат применения соответст- 
вующей простой операции, указанной перед символом «=», к первому и второму 
операндам. 

Например, выражение Х += У эквивалентно выражению Х = + У, но запи- 
сывается компактнее и может выполняться быстрее. Аналогично определяются и 
другие операции присваивания: Х % = У эквивалентно Х = Х % Уит.д. (см. соот- 
ветствующие простые операции в разделах 12.7.2 и 12.7.6). 

При записи составных операций присваивания между символом операции и 
знаком равенства пробел не допускается. 

В операциях присваивания первый операнд не может быть нулевым указате- 
лям. 

Операции присваивания возвращают как результат присвоенное значение. 
Благодаря этому они допускают сцепление. Например, вы можете написать: 


А = (B=C = 1) + 1; 


Выполняются операции присваивания справа налево. Поэтому приведенное 
выражение задаст переменным В и С значения 1, а переменной А - 2. Вычисляться 
это будет следующим образом. Сначала выполняются операции, заключенные в 
скобки, а из них первой — самая правая (т.е. С = 1). Эта операция вернет 1, так что 
далее будет выполнена операция В = 1. Она вернет значение 1, после чего выпол- 
нится операция сложения 1 + 1. Полученное в результате значение 2 присвоится 
переменной А. | 

Применительно к указателям на объекты надо четко представлять различие 
между оператором присваивания и методом копирования Assign (см. соответст- 
вующий раздел в главе 16), свойственным многим классам объектов. Метод Assign 
используется следующим образом: 


объект приемник->А$$1ап (объект источник); 
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Например: дей 
A->Assign (В); 


Этот оператор копирует содержание объекта В (все его свойства) в объект А. 
Для тех же самых объектов А и В можно записать оператор присваивания: 


А = В; 


Различие между двумя приведенными операторами следующее. Метод Assign 
копирует содержимое одного объекта в другой. Таким образом в памяти будет 
иметься два объекта А и В одинакового содержания. А оператор присваивания, 
примененный к указателям (имя объекта — это указатель на объект), присваивает 
указателю А значение указателя В. Таким образом, и А, и В будут указывать на 
один и тот же объект в памяти. А тот объект, на который до выполнения этого опе- 
ратора указывал A, может быть вообще потерян, если в программе где-то не хра- 
нится другой указатель на него. 


12.7.4 Операции отношения и эквивалентности 


Операции отношения и эквивалентности используются при сравнении двух 
операндов. Они возвращают true — истина, если указанное соотношение операн- 
дов выполняется, и false (0) — ложь, если соотношение не выполняется. Определе- 
ны следующие операции отношения: 


одних Г рые аи 
ea Е Ре ету рая 
РАО ео очен ЕТ 
eas ea | 


Больше чем арифметический, указатели Len > 0 | 
Меньше или равно |арифметический, указатели 
Больше или равно |арифметический, указатели 


Операнды должны иметь совместимые типы, за исключением целых и дейст- 
вительных типов, которые могут сравниваться друг с другом. 

Применять операции <, <=, >, >= к указателям имеет смысл, только‘если оба 
операнда указывают на элементы одного массива. 

Операции == и != могут применяться к указателям на любые объекты. В этом 
случае они вернут соответственно true и false, только если указатели указывают 
на один и тот же объект. 

Следует предостеречь от довольно распространенной ошибки: случайного при- 
менения вместо операции эквивалентности (==) операции присваивания (=). На- 
пример, если вы по ошибке вместо оператора 


Sf (A- me 2). ды 
написали оператор 
LG 95. А onic 


то это не будет расценено как синтаксическая ошибка. Дело в том, что в С++ любое 
выражение, имеющее некоторое значение, может использоваться в условных опе- 
раторах, в частности, в if. Если значение выражения 0, то оно трактуется как fal- 
se. Любое другое значение трактуется Kak true. Поэтому результат операции А = 2 
будет трактоваться как true и независимо того, чему было равно значения А до вы- 
полнения этого ошибочного оператора, условие в операторе if всегда будет считать- 
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ся выполненным. К тому же эта ошибка приведет к несанкционированному изме- 
нению значения А. 

К счастью, компилятор C++Builder замечает подобные недоразумения и при 
записи в операторе if операции присваивания на всякий случай делает замечание: 
«Possibly incorrect assignment» (Возможно некорректное присваивание). Это не 
ошибка, а только замечание. Так что если вы не обратите внимание на него, то по- 
тратите потом много времени на поиск ошибки в программе. 


~ 
Xo po Lu и и сти л b п ро гр а мм и Pp (®) ва > и я ЗОО ВЕСЕ TSS Pa I ERE EES HIN CG NE AIP LES ORSINI RA BOS RE ROMA ESE SOLE RENN SE OU RE SLNEEPBEISS 


He пропускайте ни одного замечания компилятора, не проанализировав текст и не найдя 
причины, вызвавшей замечание. Это один из залогов построения надежного программного 
обеспечения. 


а о о а В К а о ба В В а ая 


12.7.5 Логические операции 


Логические операции принимают в качестве операндов выражения скалярных 
типов и возвращают результат булева типа: true или false (0). 


| Обозначение Операция [Пр _ 
ЕЕ ото ось Оорщави мт. КСК 
| [Лоев MM АВ | 


Унарная операция логического отрицания (!) возвращает true, если операнд 
возвращает ненулевое значение. Таким образом, выражение !А эквивалентно вы- 
ражению А == 0. 

Операция логического И (&&) возвращает true, если оба ee операнда возвра- 
щают ненулевые значения. Если хотя бы один операнд возвращает 0 (false), то опе- 
рация И также возвращает false. Поэтому для сокращения времени расчета, если 
первый операнд возвращает нуль, то второй операнд даже не вычисляется. 

Операция логического ИЛИ (|) возвращает true, если хотя бы один ее операнд 
возвращает ненулевое значение. Если оба операнда возвращают 0 (false), то опера- 
ция ИЛИ также возвращает false. Для сокращения времени расчета, если первый 
операнд возвращает ненулевое значение, то второй операнд даже не вычисляется. 


12.7.6 Поразрядные логические операции 


Поразрядные логические операции работают с целыми числами и оперируют с 
их двоичными представлениями, т.е. работают с двоичными разрядами операндов. 


[Операция о о |Примр о 
поразрядное отрицание 


| << поразрядный сдвиг влево X << 2 
| >> поразрядный сдвиг вправо Кома | 
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Операция поразрядного отрицания (-) инвертирует каждый бит операнда. . 
Поразрядные операции &, | и ^ работают в соответствии со следующей табли- 
цей, где El и E2 — сравниваемые биты операндов: 


Операция поразрядного сдвига вправо (>>) сдвигает биты левого операнда на 
число разрядов, указанное правым операндом. При этом правые биты теряются. 
Если левый операнд представляет собой целое без знака, то левые освободившиеся 
биты заполняются нулями. В противном случае они заполняются символом знака. 
Сдвиг целого числа на п разрядов вправо эквивалентен целочисленному делению 
его на 21. 

Операция поразрядного сдвига влево (<<) сдвигает биты левого операнда на 
число разрядов, указанное правым операндом. При этом левые биты теряются, а 
правые заполняются нулями. Сдвиг целого числа на п разрядов влево эквивален- 
тен умножению его на 2", 


12.7.7 Операция запятая (последование) 


Операция запятая (,), называемая операцией последования, соединяет два 
произвольных выражения, которые вычисляются слева направо. Сначала вычис- 
ляется выражение левого операнда. Тип его результата считается void. Затем вы- 
числяется выражение правого операнда. Значение и тип результата операции по- 
следования считается равным значению и типу правого операнда. 

Например, фрагмент текста 

а = 4; 

b a. +: 3; 


можно записать как 
а = 4, ББ =а + 5; 


Можно рекурсивно соединить операциями запятая последовательность выра- 
жений: 


выражение 1, выражение 2, ..., выражение п 


Выражения будут вычисляться слева направо, а самое правое выражение оп- 
ределит значение и тип всей этой последовательности. 

Соединяться запятыми могут не только выражения присваивания, но и дру- 
гие. Например, вызов функции с тремя параметрами ‘может иметь вид 


Pune (7 (fp ae” т, RT 


Здесь в качестве второго параметра передается значение операции последова- 
ния, заключенной в скобки. В результате вызов производится со следующими ар- 
гументами: (1, 5, К). 

Операция последования используется в основном в операторах цикла for (см. 
раздел 12.8.2.1) для задания в заголовке некоторой совокупности действий. На- 
пример, цикл подсчета суммы элементов некоторого массива можно осуществить 
циклом for без использования операции последования: 
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int A[10], sum, i; 


sum = A[0]; 
for Wint =: № 1: 344) 
sum += А[1]; 
To же самое можно реализовать более компактно с помощью операции после- 
дования: 


int А[10], sum, 1; 


for: (1 = ] Зи = А[0]; 1.< 10; sum += Afi], 11+); 


Здесь операция последования использована дважды: при задании действий, 
выполняемых перед началом цикла (задание начальных значений 1 и Sum), и при 
описании действий, выполняемых в теле цикла (суммирование значений элемен- 
тов в SUM и инкремент счетчика 1). 


> 
Хо р fe) LU и и Cc т и n by п р [®) r pa MM и Pp (®) B a 1 и qi ККИ НИИ У IEEE IE OLR ИРОНИИ НИЕМ КАЛИНИН ЧИ КАНКРИН 


Не используйте без нужды операцию последования (,). Применение ее оправдано только при 
объединении одинаковых по смыслу выражений в основном в операторах циклов. Более ши- 
рокое применение операции’ последования ухудшает читаемость кода, маскирует ошибки, 
усложняет сопровождение программы. 


О В О рай 


12.7.8 Условная операция (?: 


Условная операция (?:) — единственная трехчленная (тернарная) операция`в 
С++, имеющая три операнда. Ее синтаксис: 


условие ? выражение 1 : выражение 2 


Первый операнд является условием, второй операнд содержит значение услов- 
ного выражения в случае, если условие истинно (возвращает ненулевое значение), 
а третий операнд равен значению условного выражения, если условие ложно (воз- 
вращает нуль). Например, оператор 

Labell->Caption = 

grade > 3 ? "Вы хорошо знаете материал" : "Плохо"; 


в зависимости от значения переменной grade выдаст текст «Вы хорошо знаете ма- 
териал» при значении grade, превышающем 3, и текст «Плохо» при меньшем зна- 
чении grade. 

Оператор с условной операцией выполняет фактически те же функции, что и 
оператор if...else (см. раздел 12.8.1.1). Но в ряде случаев применение условной 
операции компактнее и нагляднее оператора if...else. К тому же иногда условная 
операция может использоваться в таких ситуациях, когда применение оператора 
if...else синтаксически невозможно. 

В условной операции условие может быть любым скалярным выражением. Ус- 
ловные выражения могут быть практически любого типа (арифметические, указа- 
тели, структуры, объединения), но типы двух выражений в операции должны 
быть согласованными. В качестве условных выражений могут также фигуриро- 
вать какие-то исполняемые действия. 


12.7.9 Операция sizeof 


Операция sizeof определяет размер в байтах своего операнда — переменной, 
объекта, типа. Возвращаемый результат имеет тип size_t (unsigned). 
Операция имеет две формы: 
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sizeof выражение 
sizeof (имя типа) 


Например: 


sizeof *Labell; 
sizeof (TLabel); 
sizeof a; 
Sizeof (int); 


Во всех случаях операция возвращает целое, равное числу байтов в объекте 
(*Labell), типе (TLabel, int), переменной (а). 

Надо учесть, что размер переменной, объекта, типа может изменяться в зави- 
симости от машины и от используемой версии программного обеспечения. Поэто- 
му во всех случаях, когда вам требуется знать размер объекта или типа, нельзя по- 
лагаться на документацию, а надо использовать операцию sizeof. 

Если операндом является выражение, то sizeof возвращает суммарный объем 
памяти, занимаемый всеми переменными и константами, входящими в него. Если 
операндом является массив, то возвращается объем памяти, занимаемый всеми 
элементами массива (т.е. имя массива не воспринимается в данном случае как ука- 
затель). Число элементов в массиве можно определить выражением sizeof array/ 
sizeof array[0O]. 

Если операндом является параметр, объявленный как тип массива или функ- 
ции, то возвращается размер только указателя. К функциям операция sizeof не 
применима. 

Если операция sizeof применяется к структуре или объединению, она возвра- 
щает общий объем памяти, включая все наполнение этого объекта. 


12.7.10 Операция typeid 


Операция typeid возвращает информацию времени выполнения type_info, о 
типе или выражении. Операция имеет две формы: 

typeid( выражение ) 

typeid( тип ) 

Если операндом является разыменованный указатель или ссылка на поли- 
морфный тип, операция typeid возвращает динамический тип того реального объ- 
екта, на который ссылается указатель или ссылка. Если оператор не полиморф- 
ный, возвращается статический тип объекта. 


12.7.11 Операции адресации (&) и косвенной адресации (*) 


При работе с указателями и при передаче в функции параметров по ссылке ис- 
пользуются операции (&) — адресации, и (*) — косвенной адресации или разыме- 
нования. Применение этих операций при работе с указателями подробно рассмот- 
рено в разделе 13.7 главы 13. Применение их при передаче параметров в функции 
рассмотрено в разделе 12.5.2. 


12.7.12 Операции разрешения области действия (::) 


Операции разрешения области действия обозначаются двумя двоеточиями, за- 
писываемыми без пробела (::). Имеется две различных операции: 
унарная: 


переменная 
и бинарная: 


класс :: элемент класса 
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Унарная операция разрешения области действия позволяет получить доступ к 
глобальной переменной из блока, в котором объявлена локальная переменная с 
тем же именем. Например, выражение ::1 означает глобальную переменную I, 
даже если в данном блоке или в одном из обрамляющих блоков объявлена локаль- 
ная переменная I. Подробнее об областях действия (видимости) см. в разделе 12.6. 

Бинарная операция разрешения области действия позволяет сослаться на дан- 
ные-элемент или функцию-элемент класса, даже если имеются одноименные пере- 
менные или функции, определенные вне класса или в нескольких классах. Она ис- 
пользуется также при описании функции-элемента вне класса. Вы можете увидеть 
автоматическое применение этой операции в любом модуле, создаваемом 
C++Builder, если взглянете на заголовок любого обработчика событий. Подробнее 
о применении бинарной операции разрешения области действия см. в главе 1 в 
разделе 1.5.5.3. 


12.7.13 Операции доступа к элементам: точка (.) и стрелка (->) 


Доступ к элементам структур и классов может осуществляться двумя опера- 
циями: операцией точки (.) или операцией стрелки (->). Если доступ осуществля- 
ется через объект, то используется операция точка. Например, если объект с име- 
нем А имеет свойство Prop и метод F(), то доступ к ним дается выражениями: 


А.Ргор 
А.Е() 


Если доступ осуществляется через указатель на объект, что чаще всего прак- 
тикуется для доступа к компонентам в C++Builder, то используется операция 
стрелка. Например: 


Labell->Caption / 
Labell->Hide () 


Правда, и в случае, если вы имеете указатель на объект, вы можете использо- 
вать операцию точка, но тогда вы сначала должны разыменовать указатель: 


(*Labell) .Caption 


Впрочем, вряд ли подобное усложнение записи целесообразно. 


12.7.14 Операции поместить в поток (<<) и взять из потока (>>) 


Операции поместить в поток (<<) и взять из потока (>>) предназначены для 
работы с потоками, как со стандартными потоками cout и cin, используемыми в 
основном в консольных приложениях, так и с файлами (см. главу 13 раздел 
13.9.3.1). В приведенных ниже примерах мы будем ориентироваться на то, что соз- 
дается файловый поток outfile для вывода данных и файловый поток ше для 
чтения данных. Для этого должны быть выполнены операторы 


#include <fstream.h> 
// создание потока outfile, связанного с файлом "Test.dat" 
ofstream outfile("Test.dat"); 
if (!outfile) 
{ 
ShowMessage("®amn не удается создать"); 
return; 


} 


И // операторы поместить в поток 


outfile.close(); // закрытие файла 
// создание потока infile, связанного с файлом "Test.dat" 
ifstream infile("Test.dat") ; 
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if ('!infile) 
{ 
ShowMessage("®aun не удается открыть"); 
return; 


} 
// операторы взять их потока 


infile.close(); // закрытие файла 


Пояснения этих операторов см. в главе 13 в разделе 13.9.3.1. 

Вывод в потоки может быть выполнен с помощью операции поместить в по- 
ток, т.е. перегруженной операции <<. Операция << перегружена для вывода эле- 
ментов данных встроенных типов, для вывода строк и вывода значений указате- 
лей. Она позволяет также с помощью манипуляторов потока осуществлять вывод 
целых чисел в десятичном, восьмеричном и шестнадцатеричном форматах, вывод. 
значений с плавающей запятой с различной точностью, с указанием по выводу де- 
сятичной точки, в экспоненциальном формате или в формате с фиксированной 
точкой, вывод данных с выравниваем относительно какой-либо границы поля ука- 
занной ширины, вывод данных с полями, заполненными заданными символами, 
вывод буквами в верхнем регистре в экспоненциальном формате и при выводе ше- 
стнадцатеричных чисел. 

Операция << помещает в поток, являющийся ее первым операндом, аргумент, 
являющийся ее вторым операндом. Размещение в потоке происходит в текстовом 
виде. Например, оператор 


outfile << "Привет!"; 

поместит в файл текст «Привет!». Операторы 
int 1.25; 
outfile << i; 


поместят в файл текст "25". 

Операция << возвращает ссылку на объект своего первого операнда, т.е. Ha по- 
ток. Это позволяет использовать сцепленные операции поместить в поток, напри- 
мер, оператор 


outtile: рые Эй Зе. г ЗЕ Й. 
поместит в файл текст "2 * 2 = 4". Это произойдет потому, что левая операция << 
поместит текст "2 * 2 = "и вернет outfile, после чего правая операция << будет 
иметь вид 


outfile << (2 * 2); 


и добавит к тексту результат своего правого операнда. 

Проверить работу этого и рассматриваемых далее операторов можно, напри- 
мер, на следующем тестовом приложении. Разместите на форме компонент Мето, 
кнопку и в обработчик ее события OnClick вставьте операторы: 


char sin[80]; 


ofstream outfile("Test.dat"); 

if (!outfile) 

{ , 

ShowMessage ("Файл не удается создать"); 
return; 


} 


// операторы записи в файл, например: 
outrite: <<. 72°" 9 Fa 

// закрытие файла 

Outfile.close(); 


694 ‚ Глава 12 


// открытие ‘файла как входного потока 
ifstream infile("Test.dat"); 

if (!infile) 

{ 

ShowMessage ("Файл не удается открыть"); 
return; 


} 
Memol->Clear(); 
while(!infile.eof()) 


{ 
infile.getline(sl1, 80); 
Memol->Lines->Add (AnsiString(sl)); 
} 


// закрытие файла 
infile.close(); 


Подробное пояснение этих операторов вы найдете в главе 13 в разделе 
13.9.3.1. А смысл их сводится к тому, что создается файл «Test.dat», связанный с 
потоком outfile, затем в него заносится операциями << некоторый текст, после 
чего файл закрывается. Затем он опять открывается, связываясь с потоком ше, 
и строки из него считываются и переносятся в окно Memol. 

Продолжим рассмотрение операции <<. Последовательное применение опера- 
ций поместить в поток (сцепленных или задаваемых самостоятельными оператора- 
ми) приводит к занесению текстов в одну строку, как в рассмотренном выше при- 
мере. Если требуется перейти на новую строку, то можно или ввести в текст сим- 
вол конца строки '\п’' или применить манипулятор потока endl (сокращение от end 
line — конец строки). Например, операторы 


ОЕ. <<. "2. *.: 2° s\n" <<. (2.2) <; 


ро 33а 2. :* << endl << €2:.* 4) << endl; 


дадут один и тот же результат: первая строка будет содержать текст «2 * 2 :», вто- 
рая — "4", а курсор файла будет переведен на третью строку. 
В предыдущих примерах выводились константы и константные выражения. | 
При выводе переменных все работает точно так же. Например, операторы 
int i = 25, 3 =2; 
ПЛА 2х. 5 eee eK eS, п = ON Re TL Ba 4° <ко@впаы 
и операторы 
int i = 25, 3 = 2; 


Caer sTs0T = 725 * 2° 6 "7 
eutfile << 's << (i * 7) <<-endl} 


выводят в файл один и TOT же текст: «25 * 2 = 650». 

Предыдущий пример показывает, что вывод строки типа Char * осуществляет- 
‚ ся просто записью в качестве правого операнда указателя на эту строку. Однако, 
для строк типа AnsiString (см. соответствующий раздел в главе 16) операция << 
‚ не перегружена. Поэтому при выводе таких строк надо использовать приведение ее 
к типу char * с помощью метода C_str: 


AnsiString за = "Это строка AnsiString"; 
outfile << \sa.c str() << endl; 


При выводе могут использоваться и достаточно сложные выражения. В приве- 
денном ниже примере предполагается наличие двух окон редактирования ЕЯ И1 и 
Edit2, в которые пользователь вводит целые числа, а программа выводит резуль- 
тат их сравнения: | 


int i = StrToInt (Editl->Text) ; 
int.3 StrTolInt (Edit2->Text) ; 
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outfile<<i i << Ц мт ® ме: "<< “равно. "59-1 

<< endl; 

В зависимости от введенных чисел будет выведен текст «... равно ...» или «... 
не равно ...». 

Обратите внимание на то, что условный оператор заключен в скобки. Это необ- 
ходимо делать, поскольку операция поместить в поток имеет сравнительно высо- 
кий приоритет (см. раздел 12.7.15) и без скобок она применилась бы только к пере- 
менной 1, что вызвало бы сообщение о синтаксической ошибке. 

Операция << позволяет выводить и указатели. Например, вы можете напи- 
сать оператор | 


outfile << Memol endl; 


и он выведет текст типа "00632610" — шестнадцатеричный адрес объекта Memol. 
Особым приемом надо выводить при необходимости указатель на строку типа Char 
*. Если записать в операции поместить в поток сам указатель, например, $, то вы- 
ведется не указатель, а содержимое строки. Так перегружена операция << при вы- 
воде строк. Если же нужен именно адрес, то перед именем указателя надо помес- 
тить операцию приведения типа (void *). Например: 


outfile << (void *)s << endl; 


Рассмотренные выше примеры далеко не исчерпывают возможностей вывода с 
помощью операции <<. При выводе можно использовать немало манипуляторов 
потоков, позволяющих форматировать текст, выводимый операцией <<. Ранее 
был рассмотрен только один манипулятор потока — endl. Описание других мани- 
пуляторов приведено в главе 13 в разделе 13.9.3.2. 

Теперь остановимся на операции взять из потока (>>). Эта операция извлекает 
данные из потока, заданного ее левым операндом, и заносит их в переменную, за- 
данную правым операндом. Операция возвращает поток, указанный как ее левый 
операнд. Благодаря этому допускаются сцепленные операции взять из потока. На- 
пример, оператор 

infile >> i >> 3; 
прочтет, начиная с текущей позиции файла, связанного с потоком infile, два це- 
лых числа в переменные i и }. Если в текущей позиции файла первому из чисел 
предшествуют пробельные символы или разделители, то они будут пропущены. За 
окончание. числа операция примет первый отличный от цифры символ, в частно- 
сти, пробельный. Поэтому, если эти два числа были ранее записаны в файл напри- 
мер, оператором 


outfile << 4 <<< << endl; 
то они прочтутся нормально. Но если они были записаны оператором 
outfile << i << j << endl; 


т.е. без пробела, то их цифры будут слиты вместе и это составное число прочтется 
как 1, а при чтении } произойдет ошибка. 

Операцией >> можно вводить из файла строки в переменные типа Char *. На- 
пример, операторы: 

char $[80]; 

infile >> $; 


осуществляют чтение из файла в строку $. Но при этом читается не вся строка, а 
только одна лексема — последовательность символов, заканчивающаяся пробель- 
ным или разделительным символом. Для чтения целой строки имеются другие 
способы, отличные от операции взять из потока и рассмотренные в главе 13 в раз- 
деле 13.9.3.1. 
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Если при выполнении операции взять из потока считывается символ конца по- 
тока, то операция возвращает 0. Этим можно воспользоваться, чтобы, например, 
читать все содержимое файла, разбитое на лексемы: 


while (1пЕ11е>>$1) 
{ 


ge 


12.7.15 Приоритет и ассоциативность операций 


В сложных выражениях, содержащих несколько операций, последователь- 
ность их выполнения определяется прежде всего приоритетом операций. Имеется 
16 уровней приоритета, приведенных ниже в таблице. Некоторые из этих уровней 
содержат всего по одной онерации. Наивысший уровень имеют операции, приве- 
денные в первой строке таблицы, низший — в последней. Операции, указанные в 
одной строке, имеют одинаковый уровень старшинства. 

Там, где в таблице встречаются дубликаты операций (например, дубликаты 
имеют операции сложения и вычитания), первая относится к унарной операции, а 
вторая — к бинарной. 

Если в выражении встречаются записанные подряд операции одного уровня 
старшинства, то последовательность их выполнения определяется ассоциативно- 
стью, которая может быть слева направо или справа налево. 

Все операции, перечисленные в таблице, были рассмотрены в предыдущих 
разделах, кроме ых new и delete, которые будут рассмотрены в разделе 12.9. 
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справа налево 


| слева | направо _ | 


Например, выражение a+ b * / 4 будет выполняться Kak a + ((b * c) / 9). Сна- 
чала выполнятся операции умножения и деления, имеющие более высокий при- 
оритет, чем операция сложения. Поскольку ассоциативность операций умножения 
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и деления слева направо, то прежде всего будет выполнено умножения b * с, а за- 
тем результат разделится на с. В заключение результат этого деления прибавится 
ка. 

Вы можете легко изменять последовательность действий, применяя скобки, 
которые имеют очень высокий приоритет. 


12.7.16 Перегрузка операций 


Все операции C++ могут быть перегружены, кроме операций точка (.), разы- 
менование (*), разрешение области действия (::), условная (?:) и sizeof. 
| Операции =, [ ], () и -> могут быть перегружены только как нестатические 
функции-элементы. Они не могут быть перегружены для перечислимых типов. 

Все остальные операции можно перегружать, чтобы применять их к каким-то 
новым типам объектов, вводимым пользователем. Кроме того, многие операции 
уже перегружены в С++. Например, арифметические операции применяются к 
разным типам данных — целым числам, действительным ит.д., именно в резуль- 
тате того, что они перегружены. 

Операции перегружаются путем составления описания функции (с заголовком 
и телом), как это делается для любых функций, за исключением того, что в этом 
случае имя функции состоит из ключевого слова Operator, после которого записы- 
вается перегружаемая операция. Например, имя функции Operator+ можно ис- 
пользовать для перегрузки операции сложения. 

Чтобы использовать операцию над объектами классов, эта операция должна 
быть перегружена, но есть два исключения. Операция присваивания (=) может 
быть использована с каждым классом без явной перегрузки. По умолчанию опера- 
ция присваивания сводится к побитовому копированию данных-элементов класса. 
Такое побитовое копирование опасно для классов с элементами, которые указыва- 
ют на динамически выделенные области памяти; для таких классов следует явно 
перегружать операцию присваивания. Операция адресации (&) также может быть 
использована с объектами любых классов без перегрузки; она просто возвращает 
адрес объекта в памяти. Но операцию адресации можно также и перегружать. 

Перегрузка не может изменять старшинство и ассоциативность операций. 
Нельзя также изменить число операндов операции. Например, унарную операцию 
можно перегрузить только как унарную. 

Перегрузка больше всего подходит для математических классов. Они часто 
требуют перегрузки значительного набора операций, чтобы обеспечить согласован- 
ность со способами обработки этих математических классов в реальной жизни. На- 
пример, было бы странно перегружать только сложение класса комплексных чи- 
сел, потому что обычно с комплексными числами используются и другие арифме- 
тические операции. — 

Цель перегрузки операций состоит в том, чтобы обеспечить такие же краткие 
выражения для типов, определенных пользователем, какие C++ обеспечивает с по- 
мощью богатого набора операций для встроенных типов. Однако, перегрузка опе- 
раций не выполняется автоматически; чтобы выполнить требуемые операции, про- 
граммист должен написать функции, осуществляющие перегрузки операций. 


Хороший стиль программирования почин тоном ооо 


Перегружайте операции так, чтобы они выполняли над объектами вашего класса ту же функцию 
или близкие к ней функции, что и операции, выполняемые над объектами встроенных типов. 


а ERB INGE 


Ниже приведен упрощенный пример создания класса комплексных чисел 
Complex, в котором переопределены операции сложения, вычитания и присваива- 
ния. Дается описание не всех функций, поскольку очевидно, что сложение и вычи- 
тание — операции идентичные с точностью до знака. 
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class Complex { 


public: 
double Re; // действительная часть 
double Im; // мнимая часть 


Сомр1ех (Ч4оцю1е = 0.0, double = 0.0); // конструктор 

// Операции сложения 

Complex operator+(const Complex &) const; // бинарная 
Complex operator+() const; // унарная 

// Операции вычитания 

Complex operator-(const Complex &) const; // бинарная 
Complex operator-() const; // унарная 
Complex &0perator=(const Complex &); // присваивание 


}; 


// Конструктор 
Complex: :Complex (double В, double I) 
{ 

Re = R; 
Im = I; 
} 

// Перегруженная бинарная операция сложения 
Complex Complex: :operator+ (const Complex &X) const 
{ 

Complex R; 

R.Re = Re + X.Re; 

R.iIm Im + X.Im; 

return R; 


} 


// Перегруженная унарная операция вычитания 
Complex Сомр1ех: : орегафог- () const 

{ 

Complex R; 

R.Re = -Re; 

R.Im = м; 

return R; 

} 

// Перегруженная операция присваивания 
Complex & Complex: :operator=(const Complex &R) 
{ 

Re = R.Re; 

Im R. Im; 

return *this; // возможность сцепления 


} 


В этом классе вводится два открытых данных-элемента: Re — действительная 
часть комплексного числа, и Пи — мнимая часть. Конструктор по умолчанию зада- 
ет действительную и мнимую части равными 0. 

Оператор 


Complex operator+(const Complex &) const; 


объявляет прототип бинарной операции сложения. Ha TO, что это операция бинар- 
ная, указывает наличие параметра — правого операнда. Когда компилятор встре- 
тит в тексте операцию А + В, примененную к переменным типа Complex, он, He- 
зримо для пользователя, заменит ее выражением A.operator+(B). 

Оператор 


Complex operator+() const; 
объявляет прототип унарной операции сложения, поскольку список параметров 


пуст. 
Прототипы операций вычитания и присваивания строятся аналогично. 
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В реализации функции бинарного сложения создается локальная переменная 
В типа Complex, в которой формируется возвращаемое значение. В процессе фор- 
мирования к данным левого операнда производится обращение просто по именам 
Ве и Im, а второй операнд является параметром, передаваемым в функцию по 
ссылке. В заключение значение сформированной переменной возвращается как ре- 
‘зультат функции. 

В функции операции присваивания просто данные параметра пересылаются в 
поля Ве и Im. Обратите внимание на последнюю строку, которая возвращает *this. 
Указатель this является указателем на объект данного класса. Подобный возврат 
ссылки необходим, чтобы можно было использовать сцепленные операции при- 
сваивания. Рассмотрим это подробнее. 

Если компилятор встречает в тексте выражение А = В, примененное к пере- 
менным типа Complex, он заменяет его выражением A.operator=(B). А что про- 
изойдет, если встретится выражение А = В = С ? Поскольку ассоциативность опе- 
рации присваивания справа налево, то сначала заменится вторая часть выражения 
на B.operator=(C). После замены первого знака равенства получится выражение 
A.operator=(B.operator=(C)). Для того, чтобы это работало, нужно, чтобы выраже- 
ние возвращало ссылку на объект В. Это и делается, возвращением в функции 
ссылки *this. Тогда обеспечивается правильное выполнение сцепленных присваи- 
ваний. 

С описанным классом вы можете, например, выполнять такие действия: 


Complex А(1,1), В(2,2),С,0; 


А = -А; 
C=A+ B+ В; 
О = A - В; 

А = В = С; 


12.8 Операторы 


12.8.1 Операторы передачи управления 


12.8.1.1 Условные операторы выбора if 


Оператор if предназначен для выполнения тех или иных действий в зависимо- 
сти от истинности или ложности некоторого условия. Условие задается выражени- 
ем, имеющим результат булева типа. 

Оператор имеет две формы: Ни if...else. Форма if имеет вид: 


if (условие) оператор; 


Скобки, обрамляющие условие, обязательны. 

Условием может быть выражение, преобразуемое в булев тип. Если условие 
истинно (возвращает true - ненулевое значение), то указанный в конструкции if 
оператор выполняется. В противном случае управление сразу передается следую- 
щему за конструкцией И оператору. Например, в результате выполнения операто- 
ров | 

C= A; 

Lf AB. >.А}.С = В; 
переменная С станет равна максимальному из чисел А и В, поскольку оператор С = В 
будет выполнен только при В > A. 

Поскольку в С++ арифметическое (целое или действительное) значение может 
преобразовываться к булеву (любое ненулевое значение воспринимается как true, 
а нулевое — как false), то условие может иметь целый тип. Например: 
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Таба: Юр с; 


tia oe As ЕТ 


В данном случае условие if(a - b/c) эквивалентно if(a == b/c), поскольку a - b/e 
возвращает нуль при равенстве a и b/c. Аналогичные условия формально можно 3a- 
писывать и для действительных чисел: 


double а, b, с; 


if(a - b/c) ...; 


Но из-за ошибок округления это может не сработать, даже если теоретически 
значения а и b/c должны совпадать. 


ИМАМ к, 94; . AMO ee. 


Хороший стиль программирования оон 


В условных операторах выбора можно сравнивать целые числа и записывать целые выраже- 
ния. Но никогда не записывайте действительные выражения. Из-за ошибок округления резу- 
льтат их вычисления может не быть равным нулю, даже когда чисто теоретически результат 
дает нуль. 


LOPLI АРКА SEER НКАУ КНУ НИИ АКУНИН ИМИ ИУ ОНИ АРМИИ КИНУ ОИК ESD LSE PIAL SEES B ALLELE Конин РН еее акки веке 


В условии можно объявлять переменные. Например: 
af fant 7 =. баса). «о. 


В этом случае область действия и существования объявленной переменной — 
только данная структура if, включая ее выполняемый оператор. 
Форма конструкции if...else имеет вид: 


if (условие) оператор; 
else оператор2; 


Если условие возвращает true, то выполняется первый из указанных операто- 
ров, в противном случае выполняется второй оператор. Обратите внимание, что в 
конце первого оператора перед ключевым словом else ставится точка с запятой. 

Приведем примеры. 

if (J == 0) 

ЗпомМе$5асче ("Деление на нуль"); 


else 
Result = 1/9; 


В качестве и первого, и второго оператора могут, конечно, использоваться и 
составные операторы: 
if (J == 0) 
{ 
ShowMessage("Tlenenue на нуль"); 
Result = 0; 
} 


else 
Result:.= I/J; 


Опять обратите внимание, что после фигурной скобки перед else точка с запя- 
той не ставится. 

При вложенных конструкциях И могут возникнуть неоднозначности в пони- 
мании того, к какой из вложенных конструкций if относится элемент else. Компи- 
лятор всегда считает, что elSe относится к последней из конструкций if, в которой 
не было раздела else. 

Например, в конструкции 

if (условие1) 

1Е (условие2) 
оператор1; 
else оператор2; 
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else будет отнесено компилятором ко второй конструкции И, т.е. оператор2 будет 
выполняться в случае, если первое условие истинно, а второе ложно. Иначе гово- 
ря, вся конструкция будет прочитана как 


if (условие1) 


{ 
1Е (условие2) оператор1; 
else оператор2; , 


} 


Если же вы хотите отнести else к первому if, это надо записать в явном виде с 
помощью фигурных скобок: 


if (условие1) 


{ 
if (условие2) оператор1; 


} 


else оператор2; 


12.8.1.2 Условный оператор множественного выбора switch 


Оператор switch позволяет провести анализ значения некоторого выражения и 
в зависимости от его значения выполнить те или иные действия. В общем случае 
формат записи оператора switch следующий: 


switch (выражение выбора) { 
сазе значение 1 : оператор 1; 


break; // не обязательно 
сазе значение п : оператор п; 

break; // не обязательно 
default : оператор; // не обязательно 


} 


В этой конструкции выражение выбора должно иметь порядковый тип — це- 
лый, перечислимый и т.д. Поэтому, например, нельзя использовать выражения, 
возвращающие действительные числа или строки. 

Значения, указываемые в метках сазе, должны быть константными выраже- 
ниями, соответствующими возможным значениям выражения выбора. После зна- 
чения ставится двоеточие «:»›, а затем пишется оператор (может писаться состав- 
ной оператор), который должен выполняться, если выражение приняло указанное 
в метке значение. 

Если значение выражения выбора совпало со значением, указанным в одной 
из меток Case, то выполняется оператор, записанный после этой метки, после чего, 
если не принять соответствующих мер, будут выполняться все последующие опе- 
раторы остальных меток. Поскольку это обычно нежелательно, то, как правило, 
после оператора, который должен выполняться, записывают оператор 


break; 


Он прерывает выполнение структуры switch и управление передается следую- 
щему за ней оператору. 

Если значение выражения выбора не соответствует ни одному из перечислен- 
ных в метках, то выполняется оператор, следующий за меткой default. Впрочем, 
метка default не обязательно должна включаться в структуру switch. В этом слу- 
чае, если не нашлось соответствующего значения выражения выбора, то ни один 
оператор не будет выполнен. 

Значения в метках могут содержать константы и константные выражения, ко- 
торые совместимы по типу с объявленным выражением и которые компилятор мо- 
жет вычислить заранее, до выполнения программы. Недопустимо использование 
переменных и многих функций. В метках не допускается повторение одних и тех 
же значений, поскольку в этом случае выбор был бы неоднозначным. 
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Приведенный ниже пример анализирует переменную Key типа char, содержа- 
щую символ, введенный пользователем в ответ на некоторый вопрос. При положи- 
тельном ответе вызывается процедура FYes, при отрицательном — FNo, при иных 
ответах отображается сообщение об ошибке. 


Switch (Key) { 


case. 'у': case “Y': $. P¥es()+ break; } 
Cane ‘n': cade 'N':.t FNo():) break; ) 
default : ЗПомМеззасде ("Ошибочный ответ"); 


} 


Обратите внимание, что при необходимости выполнять одинаковые действия 
при нескольких значениях выражения выбора, надо размещать подряд несколько 
меток Case. 


12.8.1.3 Оператор передачи управления goto 


Оператор goto позволяет прервать обычный поток управления и передать 
управление в произвольную точку кода, помеченную специальной меткой. В свое 
время при появлении концепции структурного программирования на оператор goto 
обрушился поток критики и его применение стало рассматриваться как дурной тон. 
Действительно, чрезмерно широкое применение goto делает структуру программы 
крайне запутанной и затрудняет ее сопровождение. Однако, во многих случаях 
стремление обойтись без оператора goto не только не упрощает код, а еще более ero 
запутывает. Так что этот оператор, безусловно, имеет право на существование. 


> ` 
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Без особой нужды старайтесь обходится без применения оператора goto. Однако, He воз- 
водите это в принцип. В некоторых случаях применение goto не только не запутывает про- 
грамму, но, наоборот, делает ее более понятной и облегчает отладку. Старайтесь разме- 
щать передачу управления и метки, на которые передается управление, недалеко друг от 
друга и как следует выделяйте их и снабжайте соответствующими комментариями. 


2 COLLELEESE RELL VELL LE DEES LILLE SESE ALES ILL ALLEAL ISABEL LSA LLL ELLLILELL LEDERER LLLP в нь SEES ILL IDPE APSE 


OTR aS he 


Метка в тексте программы обозначается идентификатором с последующим 
двоеточием. Например, 


Lbegin: 


Метка отмечает точку, в которую передается управление оператором goto. 
Метка может располагаться в любом месте блока, как после оператора goto, пере- 
дающего на нее управление, так и до этого оператора. Надо только иметь в виду, 
что передача управления извне внутрь цикла может приводить к непредсказуе- 
мым последствиям, так что таких ситуаций следует избегать. 

Метки имеет областью действия функцию. Метки можно использовать всюду в 
функции, в которой они появились, но на них нельзя ссылаться вне тела функции. 
Метки используются также в структурах Switch (как метки сазе — см. раздел 
12.8.1.2). 

После метки следует оператор, на который передается управление. 

Сам оператор goto имеет форму: 


goto метка; 


Таким образом, организация работы с операторами goto может выглядеть, на- 
пример, так: 


goto 11; 
second: 


hls 


Справочные данные по языку С++ 703 


р Оо wlekd 
else goto second; 


При этом, как видно, можно ссылаться на метки, расположенные после или до 
оператора goto. : 


12.8.2 Операторы циклов 


12.8.2.1 Оператор Тог 


Оператор for обеспечивает циклическое повторение некоторого оператора (в 
частности; составного оператора) заданное число раз. Повторяемый оператор назы- 
вается телом цикла. Повторение цикла обычно определяется некоторой управ- 
ляющей переменной (счетчиком), которая изменяется при каждом выполнении 
тела цикла. Повторение завершается; когда управляющая переменная достигает 
заданного значения. 

Синтаксис структуры for: 


for (выражение1; выражение2; выражение3) оператор; 


где выражение1 задает начальное значение переменной, управляющей циклом, 
выражение? является условием продолжения цикла, а выражение3 изменяет 
управляющую переменную. | 

Структура for работает следующим образом. Сначала выполняется 
выражение] (оно может состоять и из ряда выражений, разделенных запятой т.е. 
может использоваться операция последования — см. раздел 12.7.7). Это выраже- 
ние задает начальные значения переменной (или переменных) цикла. Затем прове- 
ряется выражение? — условие продолжения цикла. Если условие истинно (воз- 
вращает true — ненулевое значение), то выполняется тело цикла — оператор, за- 
писанный в структуре for. После завершения тела цикла выполняется 
выражение3, определяющее обычно изменение переменной цикла. Затем опять 
проверяется условие, записанное как выражение2, и при истинности этого усло- 
вия выполнение цикла продолжается. Как только в каком-нибудь цикле 
выражение2 вернет false (нулевое значение), цикл прерывается и управление пе- 
редается оператору, расположенному следом за структурой Фог. 

Приведем примеры использования цикла Фог. Следующие операторы вычисля- 
ют максимальное значение и сумму элементов, расположенных в массиве целых 
чисел Data размерностью 10: 

int Max, Sum; 

Max = Sum = Data[0]; 

for(int i = 1:71, < 103.i++) 

{ 
if (Data{i] > Мах) Max = Data[i]; 
Sum += Data[i]; 

, 

Здесь первое выражение в структуре for вводит целую переменную 1, являю- 
щуюся счетчиком циклов, и инициализирует ее значением 1. Второе выражение 
проверяет условие завершения цикла. В данном случае цикл должен завершиться, 
когда переменная 1, используемая в теле цикла как индекс массива, примет значе- 
ние, большее 9. Третье выражение структуры for увеличивает после каждого вы- 
полнения цикла значение 1 на 1 с помощью операции инкремента. 

В данном случае переменная 1 объявлена в заголовке структуры Фог. Значит ее 
область действия только эта структура. После завершения циклов переменная 1 
удаляется из памяти. 

При использовании компилятора BCC32.EXE, запускаемого из командной 
строки, подобное уничтожение локальной переменной, объявленной в цикле, мож- 
но отменить опцией -Vd. Но вряд ли это имеет смысл делать. 
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Теперь рассмотрим пример использования в структуре for операции запятая 
(см. раздел 12.7.7). Пусть в приведенном выше примере нам надо найти только 
сумму элементов массива. Тогда, если объявить переменные i и Sum до начала 
цикла, собственно цикл можно весь разместить в заголовке структуры for: 

ant..Sum;, i; 

for(Sum = Data[0],i = 1; 1 < 10; Sum += Data[i++]); 

В этом примере первое выражение структуры for включает в себя два операто- 
ра, разделенных операцией запятая и задающих начальные значения переменной 
Sum, накапливающей сумму, и переменной цикла i. Третье выражение структуры 
Гог объединяет в одном операторе формирование суммы и постфиксный инкремент 
переменной цикла i. После структуры for стоит точка с запятой, что означает пус- 
тое тело цикла. 

В приведенных примерах переменная цикла увеличивалась на единицу при 
каждом цикле. Можно, конечно, организовывать циклы с уменьшением перемен- 
ной. Ниже приведен такой пример. В нем приведена программа, которая берет 
строку, записанную в окне редактирования Editl, шифрует ее сложением по опе- 
рации исключающее ИЛИ каждого символа строки с произвольным ключом и воз- 
вращает строку в окно редактирования. Если повторно применить эту процедуру с 
тем же ключом к зашифрованной строке, то будет произведена дешифровка и в 
окне отобразится исходная строка. 


AnsiString $; 


Char Key = 'А'; 
$ = Editl->Text; 
for’ {int т = 9 .Léngth() 3: i >0;7 s{i-+) =: 31] ^ Key); 


Editl->Text = s; 


В этом примере начальное значение переменной i задано равным числу симво- 
лов в строке, полученному применением функции Length(). В дальнейшем при ка- 
ждом выполнении цикла 1 уменьшается на 1 постфиксной операцией декремента. 
В этом случае целесообразно именно уменьшение счетчика цикла, поскольку в 
противном случае во втором выражении структуры for пришлось бы каждый раз 
проверять с помощью функции Length(), не кончилась ли строка. А в приведенном 
варианте обращение к Length() производится всего один раз. 

Выражения в структуре for являются необязательными. Иногда может отсут- 
ствовать первое выражение, если начальное значение управляющей переменной 
задано где-то в другом месте программы. Если отсутствует второе выражение, 
предполагается, что условие продолжения цикла всегда истинно и таким образом 
создается бесконечно повторяющийся цикл. Выйти из такого цикла можно, прове- 
рив в теле цикла какие-то условия и прервав выполнение передачей управления за 
пределы цикла оператором goto или применить другие способы прерывания, рас- 
смотренные в разделе 12.8.2.4. Может отсутствовать в структуре for и третье выра- 
жение, если приращение переменной осуществляется операторами в теле структу- 
ры или если приращение не требуется. 

При пропуске какого-то из выражений, точка с запятой после пропущенного 
выражения (кроме третьего) должна писаться. Например, в заголовке 


20у( 2 ‹1<10:).. рых 


пропущено первое условие и третье. 

Если условие продолжения цикла не удовлетворяется с самого начала, то опе- 
раторы тела структуры for не выполняются ни разу. 

Операторы цикла for могут быть вложенные. Следующий пример содержит 
три вложенных цикла for, осуществляющих вычисление матрицы Mat, равной 
произведению двух квадратных матриц Ма{1 и Mat2 размером М на М. Все матри- 
цы представлены двумерными массивами. Формула для вычисления: 
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Mat|I,J] = х Mati[I, K]- Mat2| K,J]. 
К=1 


ЧЕ. т. ак №. | 


for(I = 1; I <= М; I++) 
for(J = 1; J <= M; J++) 
{ 
X = 0; 
for(K = 1; К <= M; К++) 
Х += Matl[{1I][K] * Mat2[K] [J]; 
Mat[I][J] = X; 


12.8.2.2 Onepatop do...while 


Структура do...while используется для организации циклического выполне- 
ния оператора или совокупности операторов, называемых телом цикла, до тех пор, 
пока не окажется нарушенным некоторое условие. Синтаксис управляющей струк- 
туры do...while: 


do оператор while (условие); 


Структура работает следующим образом. Выполняется оператор тела цикла. 
Затем вычисляется условие — выражение, которое должно возвращать результат 
булева типа. Если выражение возвращает true (не нулевое значение), то повторяет- 
ся выполнение тела цикла и после этого снова вычисляется выражение. Такое цик- 
лическое повторение цикла продолжается до тех пор, пока проверяемое выраже- 
ние не вернет false (нуль). После этого цикл завершается и управление передается 
оператору, следующему за структурой do...while. 

Поскольку проверка выражения осуществляется после выполнения тела цик- 
ла, то цикл будет заведомо выполнен хотя бы один раз, даже если выражение сразу. 
ложно. С другой стороны, программист должен быть уверен, что выражение рано 
или поздно вернет false. Если этого не произойдет, то программа «зациклится», 
т.е. цикл будет выполняться бесконечно. Иногда такие бесконечные циклы ис- 
пользуются. Но в этом случае внутри тела цикла должно быть предусмотрено его 
прерывание в какой-то момент, например, оператором break или другими способа- 
ми, рассмотренными в разделе 12.8.2.4. 

Обычно оператор 4о целесообразно использовать для организации поиска сре- 
ди множества объектов такого, который обладает каким-то определенным свойст- 
вом. Причем заранее должно быть известно, что множество объектов не пустое, 
т.е. хотя бы один объект в нем имеется. К тому же должен быть критерий, позво- 
ляющий проверить, не является ли текущий объект последним. Тогда тело цикла 
включает операторы перехода к новому объекту и какой-то его обработки, а усло- 
Bue while включает проверку, является ли объект не последним и отсутствуют ли у 
него искомые свойства. Если объект последний или искомые свойства найдены, 
выполнение цикла прерывается. Если же объект не последний и искомые свойства 
у него не найдены, осуществляется переход к следующему объекту. 

Если множество проверяемых объектов может быть пустым, следует использо- 
вать другой оператор цикла — while (см. раздел 12.8.2.3). Если число повторений 
циклов заранее известно, лучше применять оператор for (см. раздел 12.8.2.1). 

Ниже приведен пример, в котором в файле Filel.txt ищется строка, содержащая 
фрагмент текста (последовательность символов с учетом регистра), указанный поль- 
зователем в окне редактирования Editl. Проверка наличия в строке заданного фраг- 
мента проверяется функцией strstr. Окончание файла проверяется функцией feof. 

FILE *F; 

char Sizs67) «> 

AnsiString 5Кеу = Edit1l->Text; 

'Е((Е = fopen("Filel.txt","r")) == NULL) 


93. Joe 322 
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{ 
ShowMessage ("Файл не найден"); 
return; 


} 


do 
fgets (S,256,F); 
while(!feof(F) &&(strstr(S,SKey.c str()) == NULL)); 


fclose(F).; 
if. (strstr(S,SKey.c str()) == NULL) 


Цикл будет выполняться, до тех пор, пока не достигнут конец файла и пока 
функция strstr возвращает NULL (фрагмент не найден). Если хотя бы одно из этих 
условий нарушается (достигнут конец файла или найден фрагмент), выполнение 
цикла прекращается. | 


12.8.2.3 Оператор while 


Оператор while используется для организации циклического выполнения тела 
цикла, пока выполняется некоторое условие. Синтаксис структуры while: 


while (условие) оператор; 


Структура работает следующим образом. Сначала вычисляется условие, кото- 
poe должно возвращать результат булева типа. Если выражение возвращает true 
(ненулевое значение), то выполняется оператор тела цикла, после чего опять вы- 
числяется выражение, определяющее условие. Такое циклическое повторение вы- 
полнения оператора и проверки условия продолжается до тех пор, пока условие не 
вернет false (нуль). После этого цикл завершается и управление передается опера- 
тору, следующему за структурой while. 

Поскольку проверка выражения осуществляется перед выполнением операто- 
ра тела цикла, то, если условие сразу ложно, оператор не будет выполнен ни одно- 
го раза. 

Программист должен быть уверен, что выражение рано или поздно вернет 
false. Если этого не произойдет, то программа «зациклится», т.е. цикл будет вы- 
полняться бесконечно. Иногда такие бесконечные циклы используются. Но в этом 
случае внутри тела цикла должно быть предусмотрено его прерывание в какой-то 
момент, например, оператором break, прерывающим цикл, или другими способа- 
ми, рассмотренными в разделе 12.8.2.4. 

Часто оператор while используется для организации поиска среди множества 
объектов такого, который обладает каким-то определенным свойством. Причем не 
исключается, что множество объектов может быть пустым, т.е. не содержащим ни 
одного объекта. K тому же должен быть критерий, позволяющий проверить, не AB- 
ляется ли текущий объект последним. Тогда тело цикла включает операторы пере- 
хода к новому объекту и какой-то его обработки, а условие while включает провер- 
ку, является ли объект не последним и не обладает ли он искомым свойством. Если 
одно из этих условий нарушается (объект последний или имеет искомое свойство), 
выполнение цикла прерывается. 

Ниже повторен приведенный в предыдущем разделе пример поиска в файле 
Filel.txt фрагмента текста, указанного пользователем в окне редактирования 
Editl. Ho если в предыдущем разделе для организации цикла использовался опе- 
ратор do...while, то в данном случае использован оператор while. Этот оператор 
здесь более уместен, поскольку проверка конца файла осуществляется до начала 
цикла, т.е. до чтения из него строки. Поэтому все будет нормально работать даже в 
случае, если файл окажется пустым и в нем не будет ни одной строки. 
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FILE: Е; 
char $ [2560] = “м: 
AnsiString SKey = Edit1l->Text; 
if((F = fopen("Filel.txt","r")) == NULL) 
{ 
ShowMessage("®amn не найден"); 
return; 
} 
while(!feof(F) &&(strstr(S,SKey.c_ str()) == NULL)) 


fgets (5S, 256; F) ; 


fclose (ЕЁ); 
if (strstr (S,SKey.c str()). == NULL) 


B данном случае можно использовать и цикл Гог: 


for(; !feof(F)&&(strstr(S,SKey.c_ str()) == NULL); 
fgets (S,256,F)); 


но цикл While выглядит наиболее естественным. 


12.8.2.4 Прерывание цикла: операторы break, Continue, return, 
функция Abort 


В некоторых случаях желательно прервать повторение цикла, проанализиро- 
вав какие-то условия внутри него. Это может потребоваться в тех случаях, когда 
проверки условия окончания цикла громоздкие, требуют многоэтапного сравне- 
ния и сопоставления каких-то данных и все эти проверки просто невозможно раз- 
местить в выражении условия операторов for, do или while. 

Один из возможных вариантов решения этой задачи — ввести в код какой-то 
флаг окончания (переменную). При выполнении всех условий окончания этой пе- 
ременной присваивается некоторое условное значение. Тогда условие в операторах 
Гог, do или while сводится к проверке, не равно ли значение этого флага принято- 
му условному значению. | 

Другой способ решения задачи — использование оператора break. Он исполь- 
зуется как в операторах цикла, так и в структурах switch. Оператор break преры- 
вает выполнение тела' любого цикла for, do или while и передает управление сле- 
дующему за циклом выполняемому оператору. 

Например, цикл в рассмотренном в предыдущих разделах примере поиска 
текста в файле мог бы быть организован следующим образом: 

while(!feof (F) ) 

{ 

fgets (S,256,F); 
if(strstr(S,SKey.c str()) != NULL) break; 
} 


Еще один способ прерывания цикла — использование оператора goto, пере- 
дающего управление какому-то оператору, расположенному вне тела цикла. 

Для прерывания циклов, размещенных в функциях, можно воспользоваться 
оператором return. В отличие от оператора break, оператор return прервет не толь- 
ко выполнение цикла, но и выполнение той функции, в которой расположен цикл. 

Прервать выполнение цикла, а заодно — и блока, в котором расположен цикл, 
можно также генерацией какого-то исключения (см. раздел 12.10). Наиболее часто 
в этих целях используется процедура Abort, генерирующая «молчаливое» исклю- 
чение, не связанное с каким-то сообщением об ошибке. 

Описанные способы прерывали выполнение цикла. Имеется еще процедура 
Continue, которая прерывает только выполнение текущей итерации, текущего вы- 
полнения тела цикла и передает управление на следующую итерацию. 
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Чтобы продемонстрировать применение Continue, усложним рассмотренный 
ранее пример поиска заданного фрагмента в текстовом файле. Пусть, например, 
мы хотим найти заданный фрагмент не в любой строке файла, а только в такой, ко- 
торая начинается с символа «*». Тогда поиск можно было бы организовать следую- 
щим образом: 


while (!ЕеоЕЁ (Е)) 
{ 
Egeta (Ss, 256, F) ; 
at Carol t= ***). continne; 
if(strstr(S,SKey.c_str()) != NULL) break; 
} . 


В этом варианте при первом символе в строке, отличном от «*», текущая ите- 
рация прерывается и поиск в такой строке не производится. Таким образом, не 
тратится время на выполнение функции strstr для строк, в которых искать фраг- 
мент не нужно. 


12.9 Динамическое распределение памяти 


Динамическое распределение памяти широко используется для экономии вы- 
числительных ресурсов. Те переменные или объекты, которые становятся ненуж- 
ными, уничтожаются, а освобожденное место используется для новых переменных 
или объектов. Это особенно эффективно в задачах, в которых число необходимых 
объектов зависит от обрабатываемых данных или от действий пользователя, т.е. 
заранее не известно. В этих ситуациях остается только два выхода: заранее с запа- 
сом отвести место под множество объектов или использовать динамическое распре- 
деление памяти, создавая новые объекты по мере надобности. Первый путь, конеч- 
но, неудовлетворительный, поскольку связан с излишними затратами памяти и в 
то же время накладывает на размерность задачи необоснованные ограничения. 

Для динамического распределения выделяется специальная область памя- 
ти — heap. Динамическое распределение памяти в этой области может произво- 
диться несколькими способами: с помощью библиотечных функций malloc, саПос, 
realloc, free или с помощью операций new и delete. 

Указанные функции объявлены в файле stdlib.h или аПос.В. Объявление 
функции malloc следующее: | 


void *malloc(size t size); 


Функция выделяет в heap блок размером в size байтов. В случае успешного вы- 
деления памяти функция возвращает указатель на выделенный блок. Если не хва- 
тило места для блока требуемого размера или если size = 0, возвращается NULL. 

Другая функция — calloc объявлена следующим образом: 


void *calloc(size t nitems, size t size); 


Функция выделяет память под nitems объектов, размер каждого из которых 
равен size. Таким образом общий объем выделяемой памяти составляет nitems * 
size. Выделенная память инициализируется нулями. В случае успешного выделе- 
ния памяти функция возвращает указатель на выделенный блок. Если не хватило 
места для блока требуемого размера или если size = 0 или nitems = 0, возвращает- 
ся NULL. | 

Еще одна функция — realloc позволяет изменить размер ранее выделенного 
блока памяти. Функция объявлена следующим образом: 


void *realloc(void *block, size t.size); 
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Она изменяет размер блока в heap, на который указывает block, до размера 
size. При этом предполагается, что block указывает блок памяти, выделенной pa- 
нее функциями malloc, calloc или realloc. Если же аргумент block задан равным 
NULL, то функция геаПос работает так же, как описанная выше функция malloc. 

Если размер $12е задан равным нулю, то выделенный ранее блок, на который 
указывает block, освобождается, а функция возвращает NULL. Таким образом, 
функция с Size равным 0 может использоваться не для выделения памяти, а для 
освобождения памяти, выделенной ранее. 

Если блок нового размера не может быть выделен, то функция геаПос возвра- 
щает NULL. Если же память выделилась успешно, то возвращается адрес выделен- 
ного блока. При этом он может отличаться от начального значения block, посколь- 
ку функция при необходимости осуществляет копирование содержимого блока в 
новое место. 

Функция #гее объявлена следующим образом: 


void free(void *block); 


Она освобождает блок памяти, выделенный ранее функциями шаПос, calloc 
или геаПос, на который указывает block. 

Рассмотрим примеры использования описанных функций. Следующий код 
динамически выделяет функцией malloc память под строку, а затем, после выпол- 
нения с ней каких-то операций, освобождает выделенную память. 

#include <stdio.h> 


#include <alloc.h> 
char '*str; 


// str - указатель на строку, под которую выделена память 
str = (char *) ма11ос (100); 


// освобождение памяти 
free(str); 


В этом примере можно было бы использовать для выделения памяти функцию 
calloc: 


Str = (char *) calloc(100, sizeof (char) ); 


Размер выделенной функциями malloc или calloc памяти можно было бы из- 
менить, например, следующим оператором: 


Str = (char *) realloc(str, 20); 


Впрочем, к тому же результату привел бы и более простой оператор: 


realloc(str, 20); 


Необходимо помнить, что рассмотренные функции возвращают NULL (0), 
если память не удалось выделить. Поэтому прежде, чем использовать возвращен- 
ные ими указатели, надо обязательно проверять, не равны ли они NULL. Иначе 
возможны очень тяжелые ошибки при работе программы. 

Теперь рассмотрим другой подход к динамическому распределению памяти: 
операции new и delete. 

Операция new работает аналогично функции malloc, но лучше использовать 
именно ее, а не malloc. Это пожелание становится безусловной необходимостью, 
если речь идет о динамическом размещении в памяти объектов библиотеки компо- 
нентов C++Builder. 

Операция new имеет следующий синтаксис: 


<::> new <размещение> тип <(инициализатор) > 


<::> пем <размещение> (тип) <(инициализатор) > 


Операция возвращает указатель на динамически размещенный в памяти объект. 
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Все элементы, заключенные в описании синтаксиса в угловые скобки, являют- 
ся необязательными. Операция разрешения области действия (::) позволяет обра- 
титься к глобальной версии new, если наряду с ней возможно использование пере- 
груженных операций. Элемент размещение используется (если он предусмотрен 
перегруженной версией) для дополнительной информации о месте размещения в 
памяти. Инициализатор задает начальное значение создаваемого объекта. 

Таким образом, обязательно должен быть указан только тип данных. Напри- 
мер: 

double *А = new double; 


В данном случае в памяти динамически создается объект — действительное 
число. В дальнейшем доступ к нему осуществляется как *А. Например: 


ЗА. = 5.1; 
Labell->Caption = *А; 


Если нет желания вводить указатель на объект и в дальнейшем работать с 
этим указателем, можно динамически разместить объект с помощью следующего 
оператора: 


double В = *new double; 


В этом случае в дальнейшем Ha объект можно ссылаться просто по имени — В. 
Создание динамически размещенного объекта можно совместить с его инициа- 
лизацией. Например: 


double *А = new double(5.1); 
double B = *new double(5.5); 


Ниже приведен пример создания и динамического размещения в памяти KOM- 
понента — окна редактирования типа TEdit: 


TEdit *Edit = new TEdit (this); 
Edit->Parent = Forml; 


Первый оператор выделяет память под объект и создает его, передавая в него 
указатель this как владельца Owner. Второй задает для компонента родителя — 
Form1. В этот момент компонент станет виден на форме. 

Рассмотрим подробнее выполнение операции New при создании и размещении 
в памяти объекта. Операция определяет объем необходимой памяти, использую 
неявно операцию $12е0о{(тип). Если в динамически распределяемой области памяти 
есть место для размещения объекта, то выделяется соответствующий блок памяти 
и операция new возвращает указатель на объект данного типа. При этом нет необ- 
ходимости явно приводить тип этого указателя — все делается автоматически. 
Созданный объект хранится в памяти, пока не будет уничтожен описанной далее 
операцией delete или пока на завершится выполнение программы. 

Если в памяти невозможно выделить блок требуемого размера, генерируется 
исключение bad_alloc. Поэтому в программе всегда надо предусматривать блок 
catch (см. раздел 12.10.5), который бы перехватывал это исключение прежде, чем 
программа попытается получить доступ к создаваемому объекту. Таким образом, 
динамическое размещение объектов в памяти, как правило, должно оформляться 
следующим образом: 

#include <iostream.h> 

try 

{ 


Операторы динамического распределения памяти с помощью New 


} 
catch (56а: :раа alloc) 


{ 


Операторы действий при недостаточной памяти 


} 
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Можно отменить генерацию исключения bad_alloc, задавая указатель на свой 
собственный обработчик событий, связанных с невозможностью выделить память. 
Для этого используется оператор 


set new handler (указатель) 


который позволяет задать указатель на обработчик. При этом set_new_handler 
возвращает прежний указатель, который был зарегистрирован до этого. 
Например, вы можете описать функцию 
void Е] (\уо1а) 
{ 
5помМеззасе ("Не хватает памяти"); 
ех1{ (1); 
} 


которая обрабатывает ситуацию, связанную с нехваткой памяти, и ввести в про- 
грамму (например, в обработчик события OnCreate формы) оператор 


set new handler (F1); ‚ 


Вводимый таким образом обработчик не может ничего возвращать и должен 
или освободить память для выполнения New, или сгенерировать исключение 
bad_alloc, или завершить программу (это сделано в приведенном примере). Если 
не выполнено ни одно из этих действий, возникнет бесконечный цикл обращений 
к обработчику. | 

Можно отменить генерацию исключения bad_alloc, не вводя специального об- 
работчика, а просто записав оператор 


зеЕ пем Папа1ег (0); 


В этом случае при недостатке памяти операция new будет возвращать NULL. 
Тогда проверку можно строить, проверяя, не равен ли значению NULL указатель, 
возвращенный new. 

Приведенные ранее примеры относились к динамическому размещению в па- 
мяти одиночных объектов. Аналогичным образом можно размещать и массивы. 
Например, оператор 


double *А = new double[100]; 


динамически размещает массив из 100 действительных чисел. К, его элементам в 

дальнейшем можно обращаться как обычно, по индексу: Afind]. При использова- 

нии для создания массива операции new надо иметь в виду, что в момент создания 

его нельзя инициализировать, как это делается с одиночными объектами. 
Можно создавать и многомерные массивы. Например, оператор 


double *М = new double[100] [100]; 


создает и динамически размещает в памяти двумерный массив. При размещении 
многомерных массивов надо иметь в виду, что первый размер можно задавать пе- 
ременной, но остальные размеры задаются только константами. Например: 


double *M = new double[n] [100]; 


Динамически распределенную память надо освобождать, когда отпадает необ- 
ходимость в размещенных в ней объектах. В противном случае получится неоправ- 
данная утечка памяти. Освобождение памяти осуществляется операцией delete. 
Она выполняет то же, что описанная ранее стандартная библиотечная функция 
free. Но использование delete предпочтительнее. Во всяком случае все, что разме- 
щается в памяти операцией new, должно удаляться операцией delete. 

Операция может иметь следующие формы записи: 

<::> delete <выражение> 


<::> delete [ ] <выражение> 
delete <имя массива> [ ]; 


4 
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Например: 
double *А = new double(5.1); 


delete A; 
или 

double *A = new. double[100]; 

delete [] A; 

Операция delete освобождает память, но сама не задает указателю на эту па- 
мять значения NULL. Поэтому желательно это делать программно, чтобы случай- 
но в дальнейшем не воспользоваться указателем, который уже ни на что не указы- 
вает: 


delete А; 
А = NULL; 


\ 


12.10 Исключения 


12.10.1 Исключения и их стандартная обработка 


При работе программы могут возникать различного рода ошибки: переполне- 
ние, деление на нуль, попытка открыть несуществующий файл и т.п. При возник- 
новении таких исключительных ситуаций программа генерирует так называемое 
исключение и выполнение дальнейших вычислений в данном блоке прекращается. 
Исключение — это объект специального вида, характеризующий возникшую в 
программе исключительную ситуацию. Он может также содержать в виде пара- 
метров некоторую уточняющую информацию. Особенностью исключений является 
то, что это сугубо временные объекты. Как только они обработаны каким-то обра- 
ботчиком, они разрушаются. 

Если исключение не перехвачено нигде в программе (как это делать — будет 
рассказано в последующих разделах), то оно обрабатывается методом Applicati- 
on->HandleException. Он обеспечивает стандартную реакцию программы на боль- 
‘шинство исключений — выдачу пользователю краткой информации в окне сооб- 
щений и уничтожение экземпляра исключения. На рис. 12.1 приведены примеры 
таких стандартных сообщений для случаев целочисленного деления на нуль и по- 
пытки преобразовать функцией StrTolInt строку «1.5» в целое число. 


Рис. 12.1. 

Примеры стандартных сообщений 
об ошибках деления на нуль (a) и 
преобразования (6) 


п ре дуп режде H и е а ВВ В О О а О Ва LEBEL 


Если вы работаете в среде разработки C++Builder и отлаживаете свою программу, то при 
исключениях, помимо указанных на рис. 12.1] сообщений, могут появляться сообщения отлад- 
чика C++Builder, которые могут мешать вашей работе. Если хотите, то можете отключить по- 
явление этих сообщений. О том, как это делается, см. в главе 14 в разделе 14.2.8. 


SILER LEE SLL : В О О о О Овны 


Если не принять соответствующих мер, то к неприятностям прекращения вы- 
числений могут добавиться еще неприятности, связанные с так называемой утеч- 
кой ресурсов. Под этим подразумеваются потери динамически распределяемой па- 
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мяти, незакрытые файлы, не уничтоженные временные файлы на диске и прочий 
«мусор». Например, пусть вы выполняете некоторую программу, в которой имеют- 
ся следующие операторы: 

FILE *fp; 

int size; 

char *str; 


fp = fopen("a.tmo”,. “w")}; 


fprintf(fp,"odawn a.tmp"); 
str = (char *) malloc(size); 


<операторы, в которых может обнаружиться исключительная ситуация> 


remove ("a.tmp") ; 
free(str); 


Вы открываете временный файл (см. раздел 13.9.2) с именем a.tmp, чтобы 
хранить в нем какие-то промежуточные данные вычислений. В конце работы вы 
намерены уничтожить его процедурой гетоуе. Вы динамически выделяете (см. 
раздел 12.9) некоторую память процедурой malloc, намереваясь освободить ее, KO- 
гда она вам больше не будет нужна, процедурой #гее. Но если в промежуточных 
операторах возникнет исключение, то вычисления прервутся и процедуры гетоуе 
и free не будут выполнены. В результате память, выделенная процедурой malloc, 
останется недоступной, а на диске сохранится временный и уже ненужный файл 
a.tmp. 

Помимо указанного, стандартная обработка исключений программой имеет 
еще один недостаток — пользователь остается в полном недоумении, что же ему 
дальше делать? И не только не очень квалифицированный пользователь, которого 
приведенные на рис. 12.1 сообщения на английском языке могут повергнуть в 
шок. Даже опытному человеку невозможно порой догадаться, что же в вашей про- 
грамме делится на нуль и как этого можно избежать. Наверное, каждый попадал в 
подобные ситуации, даже применяя профессионально сделанные программы, 
включая Windows. 


~ 
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Программист должен принять все мыслимые меры, чтобы ни при каких ошибках пользователя 
и ни при каких сочетаниях данных приложение не заканчивалось бы аварийно. Но если 
все-таки аварийное завершение происходит, необходима полная зачистка «мусора» — уда- 
ление временных файлов, освобождение памяти, разрыв связей с базами данных и т.д. 


НИКИ ИМИ КИВИ POLLING LA TEVESES BENS КЛОН BERLE LDA POPE ABSG EPA SPO SONS ЛИМА УМА АИК BETES ESEONS REDS И ННИКИННАЕ УЕ ИУЯЯ УР ИДИ ВМИК УИ УИ ИМИ EES НАНА ИЗИИЛНИИФ 


12.10.2 Способы защиты кодов зачистки — блоки 
try ... _ИЯпайЙу и функции exit 


Рассмотрим способы зашиты кодов зачистки «мусора». Первый из них — ис- 
пользование блока фту ... finally. Блок, содержащий совокупность операторов, 
способных привести к исключению, можно оформить следующим образом: 

try 

{ / 


4 


// операторы, способные привести к исключению 
} 
__finally 
{ 

// операторы, выполняемые в любом случае 


} 
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В этом случае операторы в разделе finally будут выполняться всегда, неза- 
висимо от того, было или не было исключение. Если было исключение, то после 
выполнения этих операторов вычисления, как и ранее, прерываются и возникает 
сообщение об исключении; в противном случае управление передается операторам, 
следующим за разделом __finally. 

В качестве примера рассмотрим приведенный ранее фрагмент кода с времен- 
ным файлом и динамическим распределением памяти, оформленный следующим 
образом: 

FILE *fp; 

int size; 

РН ВЕ 


cry 


{ 

fp = fopen("a.tmp", "w"); 
fprintf(fp,"odanvmn a.tmp"); 
str = (char *) malloc(size); 


// операторы, в которых может обнаружиться исключительная ситуация 


} 

'‚. finally 

{ 

remove ("a.tmp") ; 
free(str); 


} 


В этом случае процедуры remove и free будут выполнены независимо от того, 
сгенерировано ли исключение в операторах блока try, или все вычисления в них 
закончились благополучно. Таким образом проблема зачистки «мусора» снимает- 
ся — память в любом случае будет освобождена, а временный файл будет удален. 
Причем, это достигается ничтожным дополнительным кодом по сравнению с гло- 
бальной предварительной проверкой всех операций. 

К сожалению, остаются другие из рассмотренных проблем: необходимость 
принять какие-то меры для дальнейшей нормальной работы программы при гене- 
рации исключения, а также необходимость уведомить пользователя о желатель- 
ных действиях с его стороны (сообщения типа приведенных на рис. 12.1 в этом 
случае отображаются на экране, но они мало информативны для пользователя). 
Решить эти проблемы в данном случае невозможно, поскольку при выполнении 
операторов раздела __ finally программа не знает, произошло ли исключение, и 
если произошло, то какое именно. Проверки наличия исключения с помощью 
функций ExceptAddr и ExceptObject, специально предназначенных для этого, 
внутри раздела __ finally Hu к чему не приводят, так как исключение генерируется 
после выполнения этих операторов. 


Рассмотренные выше меры направлены на защиту кода зачистки в блоке. Од- 
нако, не все можно сделать на уровне блока. Поэтому полезно предусмотреть зачи- 
стку при завершении приложения. 

Один из способов завершения приложения — вызов функции exit: 


#include <stdlib.h> 
void exit(int status); 


Параметр status определяет код завершения. Обычно 0 соответствует нор- 
мальному завершению, а значение, отличное от нуля — аварийному при наличии 
ошибки выполнения. Можно, но не обязательно, использовать для задания значе- 
ния Status предопределенные константы: EXIT FAILURE — аварийное заверше- 
ние, EXIT SUCCESS — нормальное. 

Например: 

exit (0); // нормальное завершение 

exit (EXIT SUCCESS); // нормальное завершение 
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exit (1); // аварийное завершение 
exit (EXIT SUCCESS); // аварийное завершение 


При завершении приложения с помощью exit перед прекращением работы за- 
крываются все открытые файлы и очищаются все буфера вывода (печатается нахо- 
дящийся в них текст). Эти операции совершаются по умолчанию. Если же вам надо 
произвести еще какие-то действия (например, уничтожить временные файлы на 
диске), то вы можете зарегистрировать одну или несколько собственных функций, 
которые всегда автоматически будут выполняться перед действиями по умолчанию. 

Регистрируются собственные функции завершения с помощью функции 
atexit: 

#include <stdlib.h> 

int atexit(void ( USERENTRY * func) (void)); 

Здесь func — имя регистрируемой функции. Можно выполнить несколько вы- 
зовов atexit, зарегистрировав таким образом несколько функций завершения. При 
завершении приложения выполняться эти функции будут в обратной последова- 
тельности: сначала — последняя из зарегистрированных, а в конце — зарегистри- 
рованная первой. 

Например, следующий код определяет две функции завершения — myexitl и 
туех 2: 

void myexitl (void) 


{ 


// операторы зачистки 


} 


void myexit2 (void) 


{ 


// операторы зачистки 


} 


Эти функции могут не объявляться в заголовочном файле, а просто включать- 
ся в текст модуля. 

Следующие операторы регистрируют эти функции: 

atexit (myexitl); 

atexit (myexit2) ; 

Они могут быть включены, например, в обработчик события ен главной 
формы приложения. Тогда при выполнении в любой точке программы вызова 
функции exit выполнятся операторы функции туех 2, затем операторы функции 
туех 1, затем выполнится зачистка по умолчанию (закрытие файлов и буферов), 
после чего произойдет завершение приложения. 

Приведем пример функции туех 1, удаляющей в рабочем каталоге все вре- 
менные файлы с расширением .tmp (использованные в примере функции findfirst, 
findnext и remove см. в главе 15 в разделе 15.5.6): 


void myexitl (void) 


{ 
struct ffblk ffblk; 


int D; 
0. = СЛЕ rset ("*. Нло". CFIDIK, 0): 
while (!D) “ 


{ 

remove (f{fblk.ff name) ; 
р = findnext (&ffblk); 
} , 
} 


Возможность ввести в процесс собственные функции зачистки делает заверше- 
ние приложения вызовом exit «мягким» по сравнению с некоторыми другими спо- 
собами. 


‚ 
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Если приложение завершается закрытием главной формы методом Close, то 
коды зачистки можно вставить в обработчики событий, происходящих при выпол- 
нении этого метода. Таким образом это тоже «мягкий» способ завершения прило- 
жения. Причем, он имеет дополнительные преимущества, так как позволяет про- 
анализировать ситуацию и в зависимости от каких-то условий завершить прило- 
жение, или не завершать его. 


12.10.3 Иерархия классов исключений VCL 


Для дальнейшего рассмотрения работы с исключениями надо представлять, 
хотя бы в первом приближении, иерархию классов объектов исключений и свойст- 
ва этих объектов. Ниже приведена таблица иерархии большинства предопределен- 
ных в C++Builder классов исключений с краткими пояснениями. Создаваемые 
пользователем новые классы должны быть производными от одного из классов 
этой иерархии. Следует отметить, что помимо исключений, наследующих базово- 
му классу Exception и используемых в объектах (компонентах) библиотеки VCL, 
имеется еще класс exception, стандартный для С++. Этот класс мы рассматривать 
не будем. 


‘Exception | Базовый класс исключений УСТ, 


EAbort «Молчаливое» исключение, предназначенное для наме- 
ренного прерывания вычислений и быстрого выхода из 
глубоко вложенных процедур и функций 


| EAbstractError Попытка вызвать абстрактный метод 


| EArrayError Ошибка манипулирования с потомками класса TBase- | 
Аггау: использование ошибочного индекса элемента 

| массива, добавление слишком большого числа элемен- | 
| тов в массив фиксированной длины, попытка вставки | 
| элемента в отсортированный массив | 


| EAssertionFailed Ложное выражение, проверяемое процедурой Assert в 
| объектах VCL или в модулях Pascal 


| EBitsError | Ошибка доступа к массиву булевых величин TBits 
| ECacheError Ошибка построения кэша в кубе решений 


ЕСоттопСа]епдаг- 
Еггог 


Ошибки ввода в компоненты, наследующие классу 
TCommonCalendar 


Ошибка преобразования строк или объектов (в частно- 
сти, в функциях StrToInt, StrToFloat, StrToDate) 


| EDatabaseError Ошибка работы с базами данных 


| 
EDBClient | Ошибка в наборе данных клиента. Свойство ErrorCode | 
| 


EConvertError 


содержит код ошибки, возвращаемый BDE 


EReconcile- Ошибка обновления данных компонента TClientData- 
Еггог set; свойство Context содержит информацию в виде со- 
общения об ошибке, а свойство ЕггогСо4е содержит 

код ошибки, возвращаемый BDE 
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06 ошибке — объект типа TDBErrors. Свойство Еггог- 
Count хранит число ошибок 


Генерируется компонентом TQuery при попытке от- 
крыть запрос без оператора SELECT 


EUpdateError Ошибка при обновлении в TProvider 


EDBEditError Ошибка при попытке приложения использовать дан- 
ные, не соответствующие заданной маске для поля 


ENoResultSet 


| 
| 
| 


EDimensionMap- Ошибка формата данных в кубе решений 


Еггог 


Ошибочный индекс в задании размерности в кубе ре- 
шений 


EDimIndexError 


| 
| 
| 
| 
| 
| 
| 
| 
| 


| EExternal 


EAccess- 
Violation 


Класс, перехватывающий исключения Windows 


Ошибочный доступ к памяти; генерируется при попыт- 
ке разыменования нулевого указателя NULL, попытке 
записи в кодовую страницу, попытке доступа к адресу 
вне памяти, распределенной приложению 


Нажатие пользователем клавиш Ctrl+C при выполне- 
нии консольного приложения. При обработке этого 
исключения можно выдать запрос пользователю, дей- 
ствительно ли он хочет прервать работу, и предпри- 
нять действия в зависимости от его ответа 


EControlC 


| EIntOverflow | Переполнение при операции с целыми числами 


Базовый класс исключений целочисленных математи- 
ческих операций 


| 

| Базовый класс исключений операций с плавающей 3a- 
пятой; всегда генерируются только потомки этого иск- 
| ! лючения; обработка исключения EMathError может 
использоваться для перехвата всех исключений опера- 
| ций с плавающей запятой 


EInvalid- Недопустимое значение параметра при обращении к 


| Argument математической функции 

| EInvalidOp 

| 

| ошибочную операцию или переполняется стек процес- 
| сора с плавающей запятой 


| EOverflow Переполнение регистра при операциях с плавающей 

| запятой 

| J 

| EUnderflow |Потеря значащих разрядов при выполнении операции 
| с плавающей запятой 


| EZeroDivide |Деление на нуль числа с плавающей запятой т: 


Неопределенная операция с плавающей запятой: про- 
цессор наталкивается на неопределенную инструкцию, 
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| EPrivilege Попытка приложения выполнить инструкцию процес- 
| сора, которая недоступна для текущего уровня приви- 
| легий 


| EStackOverflow | Переполнение стека 
| EExternalException | Неизвестный код исключения 
| EHeapException Ошибка динамического распределения памяти 


| EInvalidPointer |Ошибочная операция с указателем, например, попытка 
дважды освободить один и тот же блок памяти 


| EOutOfMemory Неудачная попытка динамически выделить память; 
| может генерироваться процедурой OutOfMemoryError 


EOutOf- Генерируется при попытке приложения создать деск- 
Resources . риптор Windows, когда Windows не имеет места для 
размещения дополнительных дескрипторов; возможно 
и при выделении других ресурсов Windows 


Ошибка ввода-вывода из файла; исключение генериру- 
ется, если включена опция I/O checking на странице 
Pascal окна опций проекта; информация о конкретном 
виде ошибки (см. раздел 15.1.5.2) содержится в лока- 
льной переменной ErrorCode 


EIntfCastError Ошибочное применение операции преобразования ти- 


пов интерфейса 


| EInvalidCast Ошибка преобразования типа объекта 
| EInvalidGraphic Нераспознаваемый графический файл 


EInvalidGraphic- Ошибочная операция с графикой, например, попытка 
Operation изменить размер пиктограммы или копирование пик- 
тограммы в буфер Clipboard | 


EInvalidGrid- 
Operation 


Ошибочная операция с таблицей 


Ошибочная операция с компонентом; генерируется при 
попытке выполнить операцию, которая требует обра- 

ботчика окна, над компонентом, не имеющем родителя 
(свойство Parent = NULL). Это исключение также ге- 

нерируется при выполнении операций перетаскивания 
над формой (например, при попытке выполнить опера- 
цию Form1::BeginDrag). 


EInvalidOperation 


EListError 


Ошибка работы с объектом типа списка TStringList и 
TStrings: попытке сослаться на элемент с индексом 

вне допустимых пределов, попытке добавления дубли- 
ката строки в объект TStringList, в котором значение 
свойства Duplicates равно dupError, попытке вставить 
элемент в сортированный список, так как это может 
нарушить правильную последовательность элементов 


Попытка выделить памяти больше, чем доступно кубу 
решений; надо или увеличить значение Capacity, или 
уменьшить размерность куба 


ELowCapacityError 


EMC IDeviceError 
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| EMenuError | Ошибка, связанная с элементами меню 


| 
| EOleCtrlError ‚ |Генерируется при невозможности связать приложение 


с компонентом ActiveX 
Низкоуровневая ошибка OLE; C++Builder проверяет 

| это исключение, но не генерирует ero 

EOleSysError Ошибка OLE, специфическая для интерфейса OLE IDis- 
patch; свойство ErrorCode содержит номер ошибки 


EOleExcepti- |Ошибка OLE, связанная с методом или свойством 
on 


| 
| EOutlineError Ошибка при работе с компонентом Outline 
| 
| 
| 
| 


EOutOfResour- |Генерируется при попытке приложения создать деск- 
риптор Windows, когда Windows не имеет места для 
размещения дополнительных дескрипторов; возможно | 
и при выделении других ресурсов Windows 


EPackageError Исключение времени проектирования, генерируемое 
при загрузке или использовании пакета 


ЕРаг5егЕггог Ошибка преобразования текста описания формы в дво- 
| ичное представление, происходящая обычно из-за син- 
| таксической ошибки исходного текста (часто из-за исп- 
| равления текста вручную) 
| Ошибка печати; например, приложение пытается испо- 
| льзовать принтер, которого нет, или задание по ка- | 
| кой-то причине не может быть послано на принтер | 
| 
| 
| 


| 

|  EPropReadOnly Попытка записать с помощью автоматизации OLE зна- 
| чение свойства, которое предназначено только для чте- 
| ния 


Попытка прочитать с помощью автоматизации ОГЕ 
| значение свойства, которое предназначено только для 
записи 


| ЕРгорегуЕггог____ Ошибка при задании значения свойства | 
| ERegistryException | Ошибка при обращении к реестру 


| EResNotFound Ошибка при загрузке файла ресурсов .DFM или .RES в 
| процессе проектирования. 


| 
| 
EStreamError Базовый класс исключений ошибок потоков 


| а 
| EFCreateError |Ошибка создания файла; например, пользователь ука- 
зал недопустимое имя файла или указанный файл уже 


существует и не может быть перезаписан, так как по- 
льзователь не обладает соотваетствующим уровнем до- 
ступа 


| | 
| г | 
| EFOpenError Ошибка открытия файл | 
| EFilerError Базовый класс исключений файловых потоков 
| | 
| 


EReadError |Невозможно прочесть заданное число байтов | 
EWriteError |Невозможно записать заданное число байтов 


EClassNot- Компонент не связан с приложением 
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EInvalid- | Невозможно прочесть файл ресурсов 
Image 


| 
| 
| EStringListError Ошибочный доступ к окну списка с неверным индексом 


| EThread Конфликт в многопоточном приложении (например, 
| вызов метода Synchronize объекта TThread yo успеш- 
| ного завершения его предыдущего вызова) 


ma a + SSS 


i 
| 
| 


| ETreeViewError Ошибка индекса при работе с компонентом TTree View 


EUnsupportedType- | Ошибка выбора типа поля в качестве размерности куба 


| 
| 
| 
| 
| 
| 
} 


Error решений 
EWin32Error Ошибка Windows, генерируется процедурой Raise- 


| 
| 
| 
| EVariantError Ошибка, связанная с типом данных Variant 


| Last Win32Error, если Windows возвращает ошибку 


А 


12.10.4 Базовый класс исключений VCL Exception 


Все предопределенные в C++Builder классы исключений, как видно из их ие- 
рархии, приведенной в разделе 12.10.3, являются прямыми или косвенными на- 
следниками класса Exception, объявленного в модуле SysUtils и наследующего непо- 
средственно TObject. 


12.10.4.1 Свойства исключений 


В классе Exception объявлено два свойства: 


Описание 


Целый идентификатор экрана контекстно-зависимой | 
справки. Этот экран справки отображается, если по- 
льзователь, находясь в окне с сообщением об ошиб- 
Ke, нажимает клавишу Fl. По умолчанию значение 
равно 0 


Строка сообщения, которая в дальнейшем при обра- 
ботке исключения системным обработчиком отобра- 
жается в окне сообщений; устанавливается конст- 


System:: 
AnsiString 


Свойство Message имеет значение по умолчанию, которое присваивается при 
автоматической генерации исключения. При преднамеренной генерации исключе- 
ний их конструкторы, описанные в следующем разделе, могут задавать значение 
свойства Message в виде переменной типа string или литеральной константы. 

Свойство HelpContext хранит целый идентификатор экрана контекстно-зави- 
симой справки. Этот экран справки отображается, если пользователь, находясь в 
окне с сообщением об ошибке, нажимает клавишу Fl. 

По умолчанию значение свойства HelpContext равно 0. Это значение может 
изменяться некоторыми конструкторами (см. следующий раздел). Например, опе- 
ратор 

throw Exception("He хватает исходных данных", 4); 


генерирует исключение со значением свойства Message, равным тексту «Не хвата- 
ет исходных данныху, и значением свойства HelpContext, равным 4. При получе- 


Справочные данные по языку С++ 721 


нии сообщения 06 этом исключении пользователь сможет нажать клавишу ЕЁ] и по- 
лучить пояснения, что ему делать в этом случае. 

Конечно, чтобы это работало, надо создать соответствующий файл справки и 
связать его с приложением, установив соответствующую опцию Help file (файл 
справки) в окне Project Options (опции проекта) на странице Application (приложе- 
ние). Разработка файла справки подробно рассмотрена в главе 8, а связь приложе- 
ния с файлом справки — в разделе 4.1.9. 


12.10.4.2 Конструкторы исключений 


Класс Exception наследует все функции своего базового класса TObject, в част- 
ности, полезную для идентификации неизвестного исключения функцию Class- 
Маше. 

Кроме того, в интерфейсе класса Exception описаны 8 конструкторов, насле- 
дуемых всеми исключениями: 


| Конструктор НЕ 


Exception(const System::AnsiString Msg) Конструктор, передает строку сооб- 
щения Msg свойству Message 


| Exception(const System::AnsiString Msg, Конструктор формирует строку свой- 
const System::TVarRec * Args, | ства Message, исходя из строки опи- 
const int Args_ Size) сания формата Msg и массива аргу- 
ментов Args размером Args_ Size 


Конструктор задает строку свойства 
Message идентификатором Ident 

строки сообщения в ресурсах проек- 
та 


_Exception(int Ident) 


- 


Конструктор задает строку свойства 
Message идентификатором Ident 

строки описания формата в ресурсах 
проекта и массивом аргументов Args 


| Exception(int Ident, 
const System::TVarRec * Args, 
const int Args_ Size) 


Конструктор передает строку сооб- 
щения Msg свойству Message; пере- 
дает свойству HelpContext иденти- 
фикатор HelpContext экрана контек- 
стно-зависимой справки по этому 
исключению 


| Exception(const System::AnsiString Msg, 
int AHelpContext) 


Конструктор формирует строку свой- 
ства Message, исходя из строки опи- 
сания формата Msg и массива аргу- 

ментов Args; передает свойству Не!р- 
Context идентификатор HelpContext 
экрана контекстно-зависимой справ- 
‚| ки по этому исключению 


Exception(const System::AnsiString Msg, 
const System::TVarRec * Args, 
const int Args_ Size, 

int AHelpContext) 


Конструктор задает строку свойства 
Message идентификатором Ident 
строки сообщения в ресурсах проек- 
та; передает свойству HelpContext 
идентификатор HelpContext экрана 
контекстно-зависимой справки по 
этому исключению 


Exception(int Ident, int AHelpContext) 
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| Exception(int Ident, Конструктор формирует строку 

| const System::TVarRec * Args, | свойства Message исходя из строки 
const int Args_ Size, описания формата в ресурсах проек- 
int AHelpContext) Ta, указываемой идентификатором 


Ident, и массива аргументов Args; 
передает свойству HelpContext иден- 
тификатор HelpContext экрана кон- 
текстно-зависимой справки по этому 
исключению 


Рассмотрим примеры использования различных конструкторов: 


throw Exception("He хватает исходных данных"); 


throw Exception(Format ("Задано %а параметров из %а", 
OPENARRAY (TVarRec, (№1, N2)))); 


Последний пример использует функцию Format (см. раздел 15.3.1.2 главы 15) 
для форматированного вывода информации о значениях переменных М1 и №2. 
При этом для передачи в конструктор массива используется макрос OPENARRAY 
(о передаче в функции открытых массивов см. в главе 13 в разделе 13.10.3). В ре- 
зультате, например, при значениях переменных М1 = 5 и N2 = 7 будет сгенериро- 
вано исключение, в диалоговом окне которого появится текст: «Задано 5 парамет- 
ров из 1». 

Следующий пример: 

throw Exception("S3amaHo %d параметров из %d", 

OPENARRAY (TVarRec, (№1, N2))); 


Этот пример аналогичен предыдущему, HO использует конструктор с непосред- 
ственным заданием строки форматирования в качестве первого параметра. Поэто- 
му запись получается несколько короче, чем в предыдущем примере. 

Следующий пример генерирует исключение с указанием темы контекстно за- 
висимой справки: 


throw Exception("He хватает исходных данных",4); 

Этот оператор сгенерирует исключение с тем же текстом, что и в одном из при- 
веденных выше примеров, но если в диалоговом окне с сообщением 06 этом исклю- 
чении пользователь нажмет клавишу Fl, ему будет предъявлена контекстная 


справка с идентификатором 4. 
Пример применения конструктора, использующего строку ресурсов: 


throw Exception (65369); 


Этот оператор передает в свойство Message строку с номером 65369 из файла 
ресурсов. Оператор 


raise EMy.CreateResFmt (65369, OPENARRAY (TVarRec, (№1,`№2))); 


берет из файла ресурсов строку с номером 65369 как строку описания формата и 


передает в свойство Message сформатированные с ее помощью значения перемен- 
ных N1 u №2. 


12.10.5 Обработка исключений в блоках try ... catch 


12.10.5.1 Синтаксис блоков try ... catch 


Наиболее кардинальный путь борьбы с исключениями — отлавливание и об- 
работка их с помощью блоков try ... catch. Синтаксис этих блоков следующий: 
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try 
{ 


Исполняемый код 


} 
catch ( TypeToCatch ) 


{ 


Код, исполняемый в случае ошибки 


} 


Операторы блока catch представляют собой обработчик исключения. Пара- 
метр TypeToCatch может быть или одним из целых типов (int, char и т.п.), или 
ссылкой на класс исключения, или многоточием, что означает обработку любых 
исключений. Смысл параметров целого типа будет рассмотрен ниже в разделе 
12.10.6.1. А пока остановимся на случае, когда параметр является ссылкой на 
класс исключений. 

Операторы обработчика выполняются только в случае генерации в операторах 
блока try исключения типа, указанного в заголовке catch. После блока try может 
следовать несколько блоков catch для разных типов исключений. Таким образом, 
в обработчиках catch вы можете предпринять какие-то действия: известить поль- 
зователя о возникшей проблеме и подсказать ему пути ее решения, принять ка- 
кие-то меры к исправлению ошибки (например, при переполнении заслать в ре- 
зультат очень большое число соответствующего знака) и т.д. Наиболее ценным яв- 
ляется то, что вы можете определить тип сгенерированного исключения и диффе- 
ренцированно реагировать на различные исключительные ситуации. Причем пере- 
хват исключения блоком Catch приводит к тому, что это исключение далее не обра- 
батывается стандартным образом, т.е. пользователю не предъявляется окно с непо- 
нятными ему английскими текстами. 

Приведем пример обработки исключений. Пусть в вашем приложении имеет- 
ся два окна редактирования ЕЧИ1 и Edit2, в которых пользователь вводит действи- 
тельные числа типа float. Приложение должно разделить их одно на другое. При 
этом возможен ряд ошибок: пользователь может ввести в окно символы, не преоб- 
разуемые в целое число, может ввести слишком большое число, может ввести вме- 
сто делителя нуль, результат деления может быть слишком большим для типа 
float. Следующий код отлавливает все эти ошибки: 


float А; 
try 
{ 
А = StrToFloat(Editl->Text) / StrToFloat (Edit2->Text) ; 
} 
catch (EConvertErroré&) 
{ 
Application->MessageBox ("Вы ввели ошибочное число", 
"Повторите ввод", МВ_ОК); 
} 
catch (EZeroDivideé&) 
{ 
Application->MessageBox ("Вы ввели нуль", 
"Повторите ввод",МВ_ОК}); 
№ 
catch (ЕОуегЕ1ом&) 
{ 
Application->MessageBox ("Переполнение", 
"Ошибка вычислений", МВ_ ОК); 
if (StrToFloat (Editl->Text) * StrToFloat(Edit2->Text) >= 0) 
A = 3.4E38; 
else A = -3.4E38; 
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Если пользователь ввел неверное число (например, по ошибке нажал не циф- 
ру, а какой-то буквенный символ), то при выполнении функции StrToFloat воз- 
никнет исключение класса EConvertError. Соответствующий обработчик исклю- 
чения сообщит пользователю о сделанной ошибке и посоветует повторить ввод. 
Аналогичная реакция последует на ввод пользователем в качестве делителя нуля 
(класс исключения EZeroDivide). Если возникает переполнение, то соответствую- 
щий блок catch перехватывает исключение, сообщает о нем пользователю и ис- 
правляет ошибку: заносит в результат максимально возможное значение соответ- 
ствующего знака. 

Поскольку исключения образуют иерархию, рассмотренную в разделе 12.10.3, 
можно обрабатывать сразу некоторую совокупность исключений, производных от 
одного базового исключения. Для этого надо в заголовке блока catch указать имя 
этого базового исключения. Например, исключения EZeroDivide (целочисленное 
деление на нуль), EOverflow (переполнение при целочисленных операциях), Ет- 
validArgument (выход числа за допустимый диапазон) и некоторые другие явля- 
ются производными от класса исключений ЕМа Еггог. Поэтому все их можно от- 
| лавливать с помощью одного блока catch, например, такого: 


catch (EMathErroré&) 
4 
Application->MessageBox ("Ошибка вычислений", 
"Повторите ввод", МВ_ОК); 


} 


Правда, в этом случае не конкретизируется причина прерывания исключений. 
Однако, такая конкретизация возможна, если воспользоваться свойствами исклю- 
чений. Все исключения имеют свойство Message, которое представляет собой стро- 
ку, отображаемую пользователю при стандартной обработке исключений. 

Чтобы воспользоваться свойствами исключений, надо в заголовке блока catch 
не только указать тип исключения, но и создать временный указатель на объект 
этого типа. Тогда через имя этого объекта вы получаете доступ к его свойствам. 
Ниже приведен пример использования свойств исключений при перехвате исклю- 
чений, наследующих классу EMathError: 


catch(EMathErroré Е) 
{ 


AnsiString $ = "Ошибка вычислений : "; 

if(E.Message == "EZeroDivide") S += "деление на нуль"; 
1Е(Е.Меззаде == "EOverflow") $ += "переполнение"; 

if(E.Message == "EInvalidArgument") $ += "недопустимое число"; 
Application->MessageBox(S.c str(), "Повторите ввод", МВ_ОК); 


} 


Вводимое в этом операторе имя ссылки на исключение Е носит сугубо локаль- 
ный характер и вводится только для того, чтобы можно было сослаться на свойст- 
во Message по имени объекта исключения. 

ак уже говорилось выше, если в заголовке блока catch указано многоточие, 
то этот блок перехватит любые исключения: 


засей(:..) | 
{ 


ShowMessage ("Призошла ошибка."); 


} 


Блок catch(...) может сочетаться и с другими блоками catch, но в этом случае 
он должен, конечно, располагаться последним. Поскольку этот блок перехватит 
все исключения, то все блоки, следующие за ним, окажутся недоступными. 
C++Builder следит за этим. Если блок catch(...) оказался не последним, вам будет 
выдано компилятором сообщение об ошибке с текстом: «The handler must be last » 
(«Обработчик должен быть последним»). т: 
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Следует указать на некоторую опасность применения блока catch(...). Перехват всех исклю- 
чений способен замаскировать какие-то непредвиденные ошибки в программе, что затруд- 
нит их поиск и снизит надежность работы. 
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12.10.5.2 Последовательность обработки исключений, обработка 
на уровне приложения 


Блоки try...catch могут быть вложенными явным или неявным образом. При- 
мером неявной вложенности является блок try...catch, в котором среди операторов 
раздела try имеются вызовы функций, которые имеют свои собственные блоки 
try...catch. Рассмотрим последовательность обработки исключений в этих случаях. 
При генерации исключения сначала ищется соответствующий ему обработчик в том 
блоке try...catch, в котором создалась исключительная ситуация. Если соответст- 
вующий обработчик не найден, поиск ведется в обрамляющем блоке try...catch (при 
наличии явным образом вложенных блоков) ит.д. Если в данной функции обработ- 
чик не найден или вообще в ней отсутствуют блоки try...catch, то поиск переходит 
на следующий уровень — в блок, из которого была вызвана данная функция. Этот 
поиск продолжается по всем уровням. И только если он закончился безрезультатно, 
выполняется стандартная обработка исключения, заключающаяся, как уже было 
сказано, в выдаче пользователю сообщения о типе исключения. 

Как только блок catch, соответствующий данному исключению, найден и вы- 
полнен, объект исключения разрушается и управление передается оператору, сле- 
дующему за соответствующим блоком try...catch. 

Возможен также вариант, когда в самом обработчике исключения в процессе. 
обработки возникла исключительная ситуация. В этом случае обработка прерыва- 
ется, прежнее исключение разрушается и генерируется новое исключение. Его об- 
работчик ищется в блоке try...catch, внешнем по отношению к тому, в котором 
возникло новое исключение. 

Если исключение не перехвачено ни одним обработчиком в функциях, вы мо- 
жете обработать его на уровне приложения. Для этого предусмотрены события 
OnException компонента Application — самого приложения. Обработчик этих со- 
бытий можно ввести в ваше приложение следующим образом. Пусть вы решили 
назвать этот обработчик MyException. Тогда в заголовочный файл приложения 
надо добавить его объявление: 


void _fastcall MyException(TObject *Sender, Exception *Е); 
В файл вашего модуля надо внести реализацию обработчика: 


void _fastcall TForml::MyException(TObject *Sender, Exception *Е) 
{ 


// Операторы обработки 


} 


Осталось указать приложению на вашу функцию MyException как на обработ- 
чик события OnException. Вы можете это сделать, включив, например, в обработ- 
ку события формы OnCreate оператор: 


Application->OnException = MyException; 


Ваш обработчик не перехваченных ранее исключений готов. Осталось только 
наполнить его операторами, сообщающими пользователю о возникших неполад- 
ках и обеспечивающими дальнейшую работу программы. К вашей функции 
MyException приложение будет обращаться, если было сгенерировано исключение 
ини один блок catch ero не перехватил. В функцию передается указатель Е на объ- 
ект класса Exception. Этот объект является сгенерированным исключением, а 
класс Exception — базовый класс всех исключений. 


726 aM | ': ‚ Глава 12 


Простейшая обработка исключения могла бы производиться функцией 
ShowException, обеспечивающей отображение информации об исключении: 


Application->ShowException (Е); 


Примеры сообщений, выдаваемых этой функцией, были приведены ранее на 
рис. 12.1. В заголовке окна пишется имя приложения, а текст содержит описание 
причины генерации исключения. Основным недостатком функции являются сооб- 
щения на английском языке, что вряд ли порадует пользователей вашего прило- 
жения. Поэтому лучше сделать собственные сообщения. При этом для определе- 
ния истинного класса сгенерированного исключения можно воспользоваться мето- 
дом ClassName. Тогда обработчик события OnException может иметь, например, 
следующий вид: 

void _ fastcall TForml::MyException(TObject *Sender, Exception *E) 

{ 


AnsiString S = "Ошибка вычислений : "; 
if (String(E->ClassName()) == "EZeroDivide") 
5 += "деление на нуль"; 
if (String (E->ClassName()) == "ЕОуегЕ1 ом") 
5 += "переполнение"; 
if (String (E->ClassName()) == "EInvalidArgument") 
S += "недопустимое число"; 
if (String (E->ClassName()) == "EConvertError") 
S += "ввели недопустимое, число"; 
Application->MessageBox(S.c_ $6: (), "Повторите Ввод", МВ_ОК); 


} 


На рис. 12.2 приведены примеры сообщений, выдаваемых эти обработчиком. 


Вероятно, пользователям более понравятся сообщения рис. 12.2, чем сообщения 
рис. 12.1. 


Сообщения, выдаваемые вашим обработчиком LR : а т 
при делении на нуль (а) и при неверной записи 
вводимого числа (6) 


0 : 


$ 


12.10.6 Преднамеренная генерация исключений 


12.10.6.1 Оператор throw 


В ряде случаев возникает потребность сгенерировать исключение искусствен- 
но. Например, вы обработали какое-то исключение, но хотите, чтобы его обработка 
была завершена обработчиком внешнего по отношению к данному блока 
try...catch. В этом случае вам надо повторно сгенерировать исключение того же 
типа, что и прежнее, поскольку прежнее разрушено данным обработчиком. | 

Повторная генерация исключения осуществляется ключевым словом throw. 
Общая схема такой двухэтапной обработки исключений может иметь вид: 
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try 
{ 

// операторы внешнего блока 
try // начало внутреннего блока 


{ 
// операторы внутреннего блока, 
// способные привести к генерации исключения 


catch(tTun исключения &) 


{ 
// обработка исключения, сгенерированного во внутреннем блоке 
throw; // повторная генерация того же исключения 


} 

// операторы внешнего блока; 

// при генерации исключения не выполняются 
} // завершение внешнего блока try 
сассй (тип исключения &) 


{ 


// обработка исключений и внутреннего, и внешнего блоков 


} 


При такой организации программы исключения, сгенерированные во внут- 
реннем блоке, обрабатываются в два этапа: сначала обработчиком внутреннего бло- 
ка, а затем обработчиком внешнего блока. При этом операторы внешнего блока, 
следующие за внутренним, при генерации исключения во внутреннем блоке вы- 
полняться не будут. Исключения, сгенерированные во внешнем блоке, будут обра- 
батываться только обработчиками этого внешнего блока. 

С помощью ключевого слова throw можно сгенерировать не только повторное 
исключение, но и исключение любого типа в любом месте программы. Такая необ- 
ходимость, в частности, возникает, когда пользователь что-то не так сделал и не. 
имеет смысла продолжать выполнение приложения. Например, пользователь дол- 
жен был задать какую-то информацию в окнах редактирования, но забыл это сде- 
лать. В этом случае прежде, чем продолжать работу, надо указать пользователю на 
его ошибку. Это можно сделать, сгенерировав соответствующее исключение. 

Генерация нестандартного исключения производится ключевым словом 
throw, после которого указывается генерируемый объект любого типа. Это исклю- 
чение может в дальнейшем перехватываться блоком catch, в заголовке которого 
указан то же тип, что у сгенерированного объекта. Например, вы можете написать 
оператор, который проверяет, задана ли информация в окне редактирования 
ЕЧИТ, и, если не задана, то генерируется исключение: 


if (Editl->Text == "") throw "Не задана требуемая информация"; 


В данном случае объект генерируемого исключения имеет тип Char *. Подоб- 
ных операторов с различными текстами в разных местах кода может быть много. 
И все они могут быть перехвачены, например, следующим блоком catch: 


catch(char * $5) 


{ 
Application->MessageBox(s, "Ошибка ввода", МВ ICONHAND|MB ОК); 


} ° 
Заголовок этого блока обеспечивает перехват любых исключений типа Char * 


и отображение их текстов в диалоговом окне, пример которого показан на 
рис. 12.3. 


Рис. 12.3. 
Окно, отображающее текст перехваченного исключения 
типа char * 
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Вы можете в качестве параметра throw задавать целые числа, отображающие 
некие номера ошибок. Например: 


ЕС -б::.) throw 1; 


В данном случае генерируется объект исключения типа int. Поэтому подобные 
исключения могут быть перехвачены и обработаны блоком вида: 


catch(inté& i) 
{ ¢ 
Switch (i) 
{ 
case 1: 7 
break; 
case 2: . 
break; 


} 

} 

Можно генерировать объекты исключений и более сложных типов, например, 
структуры с полями, которые анализируются в обработчике исключения. Пусть, 
например, пользователь перед занесением в базу данных новой записи, относящей- 
ся к некоторому объекту, должен задать некоторый минимум параметров (харак- 
теристик) этого объекта. В приведенном ниже коде создается структура st типа 
Pers и в ходе диалога с пользователем в нее заносится число заданных параметров 
(5611) объекта. Тогда перед занесением в базу данных программа может сверить 
требуемое (st.il) и действительно заданное ($%.12) число параметров. Если парамет- 
ров задано недостаточно, то генерируется исключение, объектом которого являет- 
ся структура st. Обработчик этого исключения в свою очередь может проанализи- 
ровать все поля структуры и выдать пользователю соответствующее сообщение. 


struct Pers 


{ 


ет, wes 


р ЗС = {075}; 
try 

{ 

‚а № em epee OE SS 


imvist.ii < st.iz}) throw st; 
} 
catch (Persé) 

{ 

Application->MessageBox ( ("Требуется параметров - " + 
IntToStr(st.i2) + "\пЗадано параметров - " + 
IntToStr(st.il)).c str(), 

"Не хватает информации", МВ ICONHAND | MB _ ОК); 

} 


Пример выдачи информации таким обработчиком исключения приведен на 
рис. 12.4. 


Рис. 12.4. 
Пример выдачи сообщения об объекте исключения 


в виде структуры 
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12.10.6.2 Исключение EAbort и функция Abort 


В C++Builder имеется исключение EAbort, несколько отличающееся OT pac- 
смотренных ранее. Генерация этого исключения, как и любых других, прерывает 
процесс вычисления. Но если приложение не отлавливает соответствующим бло-. 
ком catch исключений этого класса, TO они попадают в обработчик 
TApplication::HandleException и там, в отличие от других исключений, разруша- 
ются без всяких сообщений. Таким образом, это «молчаливое» прерывание процес- 
са вычисления, при котором не должно отображаться диалоговое окно с сообщени- 
ем об ошибке. 


Простейший путь генерации исключения EAbort — вызов функции Abort. 
Например: 

a5 les.) ОКЕ: 

Только нельзя путать две похожие внешне функции: Abort — генерация 


«молчаливого» исключения, и abort — аварийное завершение программы. 

Обычное применение EAbort — прерывание вычислений при выполнении не- 
которого условия окончания или условия прерывания пользователем (например, 
при нажатии клавиши Esc или какого-то оговоренного сочетания клавипт). Функ- 
ция Abort прерывает текущую процедуру и все вызвавшие ее процедуры, переда- 
вая управление на самый верх. Таким образом, это наиболее простой выход из глу- 
боко вложенных процедур. Впрочем, можно при необходимости перехватить ис- 
ключение на каком-то промежуточном уровне, предусмотрев на нем блок 
try...catch и вставив соответствующий оператор обработки: 


catch (EAborté&) 
{ 


: 


12.11 Сигналы 


Сигнал — это некоторое непредвиденное событие (прерывание), которое может 
вызвать преждевременное завершение программы. Перечислим некоторые из та- 
ких непредвиденных событий: прерывание программы, вызванное нажатием поль- 
зователем клавиш Ctrl+C, появление недопустимой команды, ошибочный доступ к 
памяти (нарушение сегментации), запрос от операционной системы о завершении 
работы, ошибка операций с вещественными числами (деление на нуль или пере- 
множение слишком больших действительных чисел). 

Ниже перечислены некоторые стандартные сигналы, определенные в заголо- 
вочном файле signal.h (полный список приведен в главе 15 в разделе 15.6.1). 


ПАЛИЗА ИДИ ИИА: В О к ОНИ 


SIGABRT — Аварийное завершение программы (например, Е B ‚ результате г вызова 
функции abort). Действие по умолчанию — вызов _ exit(3) 


SIGFPE Ошибка арифметической операции, например, деление на нуль 
или операция, вызвавшая переполнение. Действие по умолча- 
нию — вызов _ exit(1) 


SIGINT Получение интерактивного сигнала (например, прерывание 
Ctrl+C). Действие по умолчанию — прерывание INT 23h 


SIGUSR1, Определенные пользователем (только в Win32) сигналы пользова- 
SIGUSR2, теля, генерируемые функцией raise. Действие по умолчанию — 
SIGUSR3 — игнорирование сигнала 
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Библиотека обработки сигналов содержит функцию Signal, перехватывающую 
сигналы. В функцию Signal передаются два параметра: целочисленный номер сиг- 
нала и указатель на функцию обработки сигнала. 

Обычно сигналы автоматически генерируются при возникновении соответст- 
вующих событий. Но программа может целенаправленно генерировать сигналы 
функцией raise, в которую передаются целочисленное значение номера сигнала. 

Например, вы можете предусмотреть в своей программе обработчик некоторо- 
го вводимого вами сигнала SIGUSRI1. Пусть вы дали ему имя Handl SIGUSR1. 
Тогда где-то в программе (например, при обработке события OnCreate формы) вам 
надо установить в системе этот обработчик с помощью оператора 


signal (SIGUSR1, Напа1 SIGUSR1); 


При этом He забудьте вставить в файл директиву 
#include <signal.h> 


Сам обработчик сигнала может иметь вид: 


void Напа1 SIGUSR1 (int N) 
{ 


if (MessageDlg ("Продолжать?", mtConfirmation, 
TMsgDlgButtons() << mbYes. << mbNo,0) == шгуез) 
// повторная установка обработчика: | 
$1апа1 ($5169$8В1, Handl SIGUSR1); 
else exit (EXIT SUCCESS) ; 
} 


Этот обработчик принимает одно целое значение, соответствующее номеру 
сигнала. В обработчике предусматриваются некоторые действия, необходимые при 
появлении данного сигнала. Затем, если выполнение программы должно продол- 
жаться, надо повторно установить обработчик сигнала с помощью функции signal, 
как показано в приведенном примере. Если этого не сделать, то последующие со- 
бытия SIGUSRI1 не будут вызывать этот обработчик. После выполнения команды 
повторной установки обработчика сигнала управление автоматически передается в 
точку программы, в которой сигнал был обнаружен. В этом, в частности, коренное 
отличие сигналов от исключений. 

Генерация сигнала SIGUSR1 в необходимых местах программы осуществля- 
ется оператором 


raise(SIGUSR1); 


Рассмотренный вариант функции сейчас считается несколько устаревшим. 
Более современный вариант (подробнее о нем см. в главе 15 в разделе 15.6.1) вы- 
глядит следующим образом. Определите в программе тип указателя на функцию 
fptr: 

typedef void (*fptr) (int); 

Этот указатель используется в вызове функции signal: 

Signal(SIGFPE, (fptr)Handl SIGFPE) ; 


Весь остальной приведенный выше текст примера может не изменяться. 
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13.1 Классификация типов данных, 
объявление типов 


Все типы, используемые в C++Builder, можно разбить на четыре группы: 


И ИИС т структуры данных 

Аггау массивы 

struct 
union [объединения | 
А aan Meee argu 
ыы Gude std Ще icon scene aie 
pee is a 8 фу ое tame 
islegBnsete, dun be Aug 
НУР nek 
Arithmetic 


скалярные 


| Scalar 


Другой способ классификации типов связан с их разбиением на основные и про- 
изводные типы. К основным относятся: Void, char, int, float и double, а также ux ва- 
рианты с модификаторами short (короткий), long (длинный), signed (со знаком) и 
unsigned (без знака). Например, unsigned char, unsigned int, signed int (модифика- 
Top signed подразумевается по умолчанию и поэтому обычно не указывается). 

Основные типы в С++ следующие: 


oe Размер ов в:бадоам.:. Диапазон значений 


от -128 до 126 
mained char 


oa or 0 до 255 
short fk for -82 168 до 82 167 | 
unsigned short ——— от 0 до 65 535 


ПЕ НИНЕ) 


anne or -2 147,483 648 до 2 147 483 647 


от -2 147 483 648 до 2 147 483 647 
пней long {or 0 no 4 294 967 295 


732 Глава 13 


Tun | Размер в байтах __ | Диапазон значений | 
ag ar aa eS eS OP НТИ ET РЕЛЕ 
unsigned |4 кк ют 
float Coes ев ne a 


double 8 от 1.7 + 10-308 до 1.7 - 10308 


long double or 3.4 . 10-4932 до 1.1 - 104932 
bool De a Oe В ао 


Имеются также основные типы __int8, _int16, _int32, __ 1664, о которых 
подробнее см. в разделе 13.3. 

Следует отметить, что в C++Builder, в отличие от некоторых других версий 
C++, булев тип bool реализован как отдельный THM, не как псевдоним целого. Од- 
нако, это не мешает при желании использовать в логических выражениях целые 
значения вместо булевых. При этом значение 0 расценивается Kak false, а любое 
ненулевое значение — как фгие. 

Производные типы включают в себя указатели и ссылки на какие-то типы, 
массивы каких-то типов, типы функций, классы, структуры, объединения. Эти 
типы считаются производными, поскольку, например, классы, структуры, объе- 
динения могут включать в себя объекты различных типов. 

Можно выделить еще одну категорию типов — порядковые, в которых значе- 
ния упорядочены и для каждого из них можно указать предшествующее и после-. 
дующее. К ним относятся целые, символы, перечислимые типы. 

Типы данных указываются при объявлении любых переменных и функций 


(см. разделы 12.4.1 и 12.5.1). Например: 


double “@ 45.4, b= 2; 

Ln. с: 

void Fl(double A); 

Пользователь может вводить в программу свои собственные типы. Объявления 
типов могут делаться в различных местах кода. Место объявления влияет на о0б- 
ласть видимости или область действия так же, как и в случае объявления перемен- 
ных (см. раздел 12.6). 

Синтаксис объявления типа: 


typedef определение типа идентификатор; 


Здесь идентификатор — это вводимое пользователем имя нового типа, а опре- 
деление типа — описание этого типа. Например, оператор 


typedef double Ar[10]; 


объявляет тип пользователя с именем Ar Kak массив из 10 действительных чисел. В 
дальнейшем на этот тип можно ссылаться при объявлении переменных. Например: 


АГ. А. = \{1, 2. 59'4¢57 6, 7,8 9,10}: 


Объявление типа с помощью typedef можно использовать и для создания HOBO- 
го типа, имя которого будет являться псевдонимом стандартного типа С++. Имен- 
но так в C++Builder многие встроенные типы компонентов Object Pascal приведе- 
ны к типам, характерным для С++. Эти переопределения типов содержатся в фай- 
ле sysdefs.h. Например: 


typedef bool Boolean; 
typedef int Integer; 
typedef short Smallint; 
typedef unsigned char Byte; 


Ниже дается таблица соответствия типов Delphi (т.е. типов Object Pascal) и ти- 
пов C++. 
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i Ae fa 
Delphi Реализация _ 
ShortInt typedef 


: SmallInt целое 16 бит short typedef 


Longint int __| typedef 


Byte целое без знака 8 6ur___jumsigned char __| typedef 


Word unsigned short | typedef 
Integer |uenoe 32 бта int typedef 
Cardinal _|uenoe без знака 32 6ura__|unsigned int _itypedef_— 
[Boolean [true/false м [фур | 


| ByteBool true/false или целое без unsigned char typedef 
| знака 8 бит 

WordBool true/false или целое без typedef 

| знака 16 бит 

| LongBool true/false или целое без typedef | 
| знака 32 бита 


[AnsiChar __ [символ без знака 8 бт__ (ог [Муровей 


| WideChar символ Unicode размером wchar t typedef 
| в слово | 


| 
|Сваг____ [символ без знака 8 бит _  |сваг typedef 
AnsiString AnsiString Delphi AnsiString класс 


| | прежний стиль строк Delphi, | SmallString<n> шаблон 

| п = 1...255 бит класса 
| ShortString aaa стиль строк Delphi, | SmallString<255> | typedef 
! ит 


число с плавающей запятой | float typedef 
| 32 бита 
| Double число с плавающей запятой | double typedef 
| 64 бита 
Extended число с плавающей запятой | long double typedef 
80 бит 
число с плавающей запятой | double typedef 
32 бита 


родовой указатель 32 бита 


PChar указатель на символы 32 unsigned char * typedef | 
бита 


| PAnsiChar. указатель на символы ANSI | unsigned char * typedef 
| 32 бита | 
число с плавающей запятой | Comp класс | 

64 бита 


OleVariant (значение variant OLE __|OleVariant_ 


unsigned short 


BOOL (WinAPI) 


© 
SS 


| 
} 
| 
| 


| 
| 
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13.2 Приведение типов 


В арифметических выражениях, содержащих элементы различных арифмети- 
ческих типов, C++Builder в процессе вычислений автоматически осуществляет 
преобразование типов. Это стандартное преобразование всегда осуществляется по 
принципу: если операция имеет операнды разных типов, то тип операнда «млад- 
шего» типа приводится к типу операнда «старшего» типа. Иначе говоря, менее 
точный тип приводится к более точному. Например, если в операции участвует ко- 
роткое целое и длинное целое, то короткое приводится к длинному; если участвует 
целый и действительный операнды, то целый приводится к действительному ит.д. 
Таким образом, после подобного приведения типов оба операнда оказываются од- 
ного типа. И результат применения операции имеет тот же тип. 

Все это относится к арифметическим операциям, но не относится к операции 
присваивания. Присваивание сводится к приведению типа результата выражения 
к типу левого операнда. Если тип левого операнда «младше», чем тип результата 
выражения, возможна потеря точности или вообще неправильный результат. 

Рассмотрим примеры неявного автоматического преобразования типов. В ре- 
зультате действия следующих операторов 

double а = 5.4, b = 2; 

Eno? c.f а. *Ъ; 
переменная © получит значение 10, хотя истинное значение должно быть равно 
10.8. Это значение действительно будет вычислено в результате умножения а * b, 
но затем дробная часть будет отброшена, поскольку е — целая переменная. 

Результатом выполнения операторов 

int m=1, n= 2; 

double A =m / п; 


будет значение A = 0. Поскольку ш и п — целые переменные, то деление т / п све- 
дется к целочисленному делению с отбрасыванием дробной части, результат кото- 
рого равен нулю. 

Результат выполнения похожих на предыдущие операторов 

int..m =. 1; 

double n = 2; 

double A m / п; 


даст правильный результат — A = 0.5. Поскольку в данном случае один из операн- 
дов операции деления имеет Tun double, то тип другого, целого операнда будет 
тоже приведен к double и результат деления будет иметь тип double. 

Еще один пример, который дает совершенно неверный результат: 


double a = 300, b = 200; 
short с = а * b; 


Если вы попробуете реализовать этот пример, то увидите, что переменная с по- 
лучит значение -5536, вместо ожидаемого 60 000. Дело в том, что переменная типа 
short может хранить значение не больше, чем 32 767. Поскольку выражение в пра- 
вой части приведенного оператора дает результат 60 000, то его присваивание пе- 
ременной типа short дает совершенно неверное значение. 

Как было видно из некоторых приведенных примеров, неявное автоматиче- 
ское приведение типов не всегда дает желаемый результат. Это можно исправить, 
применив операцию явного приведение типов. Она записывается в виде 


(тип) 


перед той величиной, которую вы хотите привести к указанному типу. Вернемся к 
уже рассмотренному примеру 
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int =1 n = 2; 

double А =m / п; 
который давал неверное значение переменной А. Этот результат можно исправить, 
применив во втором операторе явное приведение типа: 


double А = (double)m / п; 


В этом случае переменная п, к которой применяется операция приведения 
типа, рассматривается как действительная величина типа double. Тогда и перемен- 
ная п неявно приводится к типу double, так что деление осуществляется уже не с 
целыми, а с действительными числами. Результат получается правильным — 0.5. 

Есть еще одна ситуация, которая требует явного приведения типов: в некото- 
рых случаях компилятор не может выбрать среди перегруженных функций (0 пе- 
регрузке функций см. раздел 12.5.7 главы 12), если под данный тип параметра 
подходит несколько из них. Если в C++Builder 4 вы напишете код 

TPoint 'P; 

P.x = 5; 

Р.у =. 1; 

Labell->Caption = "Координата x = " + IntToStr(P.x); 
то получите сообщение компилятора об ошибке: «Ambiguity between ' fastcall Sy- 
sutils::IntToStr(__int64)' and ‘ fastcall Sysutils::IntToStr(int)'» (Неоднозначность 
применения функции IntToStr к параметрам типов _ 11464 и int). Компилятор, 
как Буриданов осел, остановился между двумя (в данном случае идентичными) ~ 
возможностями и отказывается производить выбор. Помочь компилятору легко, 
применив в последнем из приведенных операторов явное указание типа int: 


Labell->Caption = "Координата x = " + IntToStr((int)P.x); 


Подобный текст компилятор обработает без проблем. 

В C++Builder 5 компилятор более «интеллектуальный» и в приведенном при- 
мере в подобной помощи не нуждается. Но в некоторых других сложных случаях 
подобное явное приведение типов может потребоваться. 


13.3 Арифметические типы данных 


Арифметические типы данных — это целые и действительные типы. 

К целым типам относятся char, short, int и long вместе с их вариантами 
signed — со знаком и unsigned — без знака. Из этих ключевых слов может форми- 
роваться множество целых типов данных. Многие из них являются синонимами 
друг друга, как следует из следующей таблицы. 


ыы ¢? а о аа 


| саг, signed char Синонимы, если умолчанием для chix 


| 7 
|unsigned char 


|char, unsigned char Синонимы, если умолчанием для Char 


задано signed 


задано unsigned 


rere signed int 
unsigned, unsigned int 
short, short int, signed short int 


736 | Глава 13 


= ——- 


о о и И 
т | 


Спецификаторы signed и unsigned могут применяться только к Char, short, 
int, long. Если тип обозначен просто Kak signed или unsigned, то подразумеваются 
соответственно Signed int и unsigned int. 

При отсутствии в указании типа спецификатора unsigned для целых типов 
подразумевается signed. Исключением из этого правила является тип char. 
C++Builder позволяет вам установить в качестве умолчания для Char signed или 
unsigned. В этом случае, если вы пишете объявление 


char ch; 


OHO воспринимается как 


Signed char ch; 


Если же вы хотите объявить переменную типа Char без знака, вы должны это 
сделать явно: 


unsigned char ch; 


Спецификаторы long и short могут использоваться только с int. Если тип обо- 
значен просто как long или short, то подразумеваются соответственно long int и 
short int. 

Объем памяти, занимаемый различными целыми типами, не лимитирован 
стандартом ANSI С. Указано только, что short, int и long должны образовывать не- 
убывающую последовательность, т.е. Short <= int <= long. Поэтому He исключает- 
ся, что все три типа требуют одинакового объема памяти. Таким образом, объем 
памяти может меняться от одной платформы к другой и это надо учитывать, если 
хотеть создавать переносимые программы. | 

Объемы памяти, занимаемые целыми типами в данной версии C++Builder для 
32 разрядных программ, приведены в таблице в разделе 13.1. В частности, из этой 
таблицы вы можете увидеть, что int и long эквивалентны и занимают по 32 бита. 

Типы со знаком используют старший бит для хранения знака: 0 — положи- 
тельный, 1 — отрицательный. 

Помимо рассмотренных выше имеются еще целые типы, имена которых начи- 
наются с символов «_ 11%», за которыми следует число бит. При записи констант 
этих типов можно использовать суффиксы Ги Ui, как показано в приведенной 
ниже таблице. Впрочем, эти же суффиксы можно использовать и при задании зна- 
чений переменных других целых типов. 


= ——— — 


|| Тивы | Суффикс [Прим [Память биты) 

_ints 38 | Sane o's Tarraay! ни 
_int16 16 |_imtt6s= 3276716 16 
па [64 | _imt64 big = 1284565482164; — 


unsigned _64 hugelInt = 
1128496 (68 7G set uiee 
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Основными типами данных для представления действительных чисел с пла- 
вающей запятой являются типы float и double. Первый из них размещается в 32 
битах, второй — в 64. К типу double может применяться СОИИкАТЫИ long, KOTO- 
рый увеличивает размер памяти до 80 бит. 

Диапазоны возможных значений и затраты памяти для действительных типов 
в данной версии C++Builder для 32 разрядных программ приведены в таблице в 
разделе 13.1. Стандарт ANSI С не накладывает никаких ограничений на способ 
реализации действительных чисел. Поэтому, если вы хотите делать переносимые 
программы, то не ориентируйтесь на тот или иной размер памяти для действитель- 
ных типов, а используйте для определения этого размера операцию sizeof (см. раз- 
дел 12.7.9 главы 12). 


13.4 Типы строк 


13.4.1 Массивы символов 


В С++ отсутствует специальный тип строк. Строки рассматриваются как мас- 
сивы символов, оканчивающиеся нулевым символом ('\0'). Строка доступна через 
указатель на первый символ в строке. Значением строки является адрес ее первого 
символа. Таким образом, можно сказать, что в C++ строка является указателем — 
указателем на первый символ строки. B этом смысле строки подобны массивам, 
потому что массив тоже является указателем на свой первый элемент. Подробно о 
работе с массивами символов см. в разделе 13.10.1, посвященном массивам. 

Строка может быть объявлена либо как массив символов, либо как перемен- 
ная типа char*. Каждое из двух приведенных ниже эквивалентных объявлений 


char S[{] = "строка"; 
char *Sp = "строка"; 


я 


присваивает строковой переменной начальное значение «строка». Первое объявле- 
ние создает массив из 7 элементов $ содержащий символы ‘с’, ‘т’, ‘р’, 0, 'к’,'а’и 
'\0’. Второе объявление создает переменную указатель Sp, который указывает на 
строку с текстом «строка», лежащую где-то в памяти. Но в любом случае число 
хранимых символов на 1 больше числа значащих символов за счет оконечного ну- 
левого символа. 

Доступ к отдельным символам строки осуществляется по индексам, начинаю- 
щимся с нуля. Например, $[0] и Sp[O] — первые символы объявленных выше 
строк, S[1] и Sp[1] — вторые и т.д. 

В приведенных объявлениях длина строк определялась автоматически компи- 
лятором. Можно объявлять строковые переменные заданной длины. Например, 


оператор 
char buff[100]; 


объявляет переменную buff, которая может содержать строку до 99 значащих сим- 
волов плюс заключительный нулевой символ. 

Для обработки строк имеется ряд библиотечных функций. Основные из них 
streat — конкатенация (склеивание) двух строк, strcmp — сравнение двух строк, 
strcpy — копирование одной строки в другую, strstr — поиск в строке заданной 
подстроки, strlen — определение длины строки, strupr — преобразование симво- 
лов строки к верхнему регистру, sprintf — построение строки по заданной строке 
форматирования и списку аргументов и ряд других функций. Все они подробно 
рассмотрены в главе 15 в разделе 15.4.2. А пока рассмотрим несколько примеров 
их применения. 
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Начнем с самого простого. Выше было приведено объявление массива симво- 
лов buff. Как занести в него какой-то текст? Это можно сделать с помощью функ- 
ции strepy: 


strcepy (раЕЁ, "Текст, копируемый в buff"); 


Эта функция копирует строку, являющуюся ее вторым параметром, в строку, 
являющуюся первым параметром, и возвращает указатель на результат копирова- 
ния. | 

Теперь решим задачу посложнее. Пусть, например, мы хотим прибавить в ко- 
нец текста строки 51 текст, хранящийся в строке 52. Это можно сделать с помо- 
щью функции streat: | 


’ 


char $1[20] = "текст. 1", S2{10] = "текст: 2"; 
strcat (Si, $2); 


_ Обратите внимание на TO, что размер первой строки выбран с запасом, чтобы в 
ней уместились оба текста. Если не задать в объявлении размер строки; то он опре- 
делится по присваиваемому ей тексту и в ней не останется места для каких-то до- 
бавлений. 

Функция strcat прибавляет к тексту строки, указанной ее первым парамет- 
ром, текст строки, указанной вторым параметром, и возвращает указатель на пер- 
вую строку. Последнее обстоятельство позволяет делать вложенные вызовы Strcat, 
если надо склеить несколько текстов. Давайте несколько усложним задачу. Пусть 
мы хотим оставить в неприкосновенности обе строки, а в третьей строке $ хотим 
получить склеенные тексты строк 51 и 52, разделенные символом пробела. Это 
можно сделать следующими операторами: 


Ghar *98] ‘= "текст. 1", *52 = "текст 2", $5120]; 
StreactscecactStrcacit(S, sid,” "827 


Самый внутренний вызов strcat склеивает пустую строку $ и строку 51. Он 
возвращает указатель на S и, значит, следующий вызов strcat склеивает текст, 
появившийся в 5, со строковой константой, содержащей символ пробела. Функ- 
ция strcat опять возвращает указатель на $ и последний внешний вызов Strcat до- 
бавляет к уже сформированной строке текст строки $32. 

Приведенный код будет работать, если есть уверенность, что сначала текст BS 
отсутствует. Чтобы не зависеть от исходного текста в S, лучше вместо внутреннего 
вызова Strcat применить функцию 


strcpy(S, 51) 


При анализе текстовых строк часто надо найти в одной из строк фрагмент тек- 
ста, заданный в другой строке. Этот фрагмент, например, может быть некоторым 
ключевым словом, символом и т.п. Эту задачу позволяет решить функция 


strstr (31,52) 


которая ищет в строке 51 первое вхождение текста строки 52 и, если поиск про- 
шел удачно, возвращает указатель на первый символ этого вхождения. Если же 
текст не был найден, возвращается нуль. 

Теперь давайте решим более сложную задачу. Пусть нам надо найти в строке 
51 первое вхождение текста строки 32 и, если поиск прошел удачно, то заменить 
найденный фрагмент на текст, содержащийся в строке 53. Иначе говоря, требует- 
ся произвести контекстную замену в 51 текста S2 на текст 53. Один из возможных 
вариантов решения этой задачи приведен ниже. 


Char: ЗЕ ТО}, 5211207531201, S60 fy. “* Sty 
fy операторы занесения текста в Sl, 52, S3 


ВЕ = -strstrisSi,$2); 
if (St) 
{ 
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*5Е = О; 

St += $6г1еп (52); 

Labell->Caption = strcat(strcat(strcpy(S,S1),S3),St); 
} 


else Labell->Caption = "Текст не найден"; 


Помимо строк $1, 52, $3 в этом коде объявлена строка $, являющаяся буфе- 
ром, в который будет помещаться текст с произведенной в нем заменой. Объявлен 
также указатель на строку St. OH нам потребуется в качестве вспомогательной пе- 
ременной. 

Первый выполняемый оператор кода ищет с помощью функции strstr вхожде- 
ние строки 52 в строку 81 и присваивает результат поиска переменной St. Если 
функция strstr вернула нуль (это эквивалентно false), то печатается сообщение 
«Текст не найден». Если же поиск прошел успешно, то осуществляются следую- 
щие операции. Сначала в символ, на который указывает 5%, засылается 0 — это эк- 
вивалентно нулевому символу. Таким образом выделяется первая часть строки Sl, 
расположенная до заменяемого текста. Затем указатель St сдвигается на длину за- 
меняемого текста, которая определяется функцией strlen. После этой операции St 
начинает указывать на первый символ в строке $51 после заменяемого текста. Сле- 
дующий оператор формирует в буфере $ текст с заменой и отображает его в метке 
Labell. Формирование текста осуществляется вложенными вызовами функций 
strcat и strcpy. Сначала срабатывает вложенный вызов strcpy. Он копирует в $ 
строку, на которую указывает 51. Но поскольку вместо первого символа заменяе- 
мого текста мы занесли нулевой символ, то скопирована будет только начальная 
часть строки $31 до этого символа. Затем срабатывает вложенный вызов Strcat и к 
тексту, сформированному в S добавляется строка 53. Последний внешний вызов 
strcat добавляет к сформированному тексту часть строки $1, расположенную по- 
сле замененного фрагмента. Именно на эту часть строки указывает 5$. 

Чтобы это стало понятнее, разберем пример. Пусть строка 51 содержит текст 
«Маша ела кашу», строка 52 содержит текст «ела», а строка 53 — «съела». Зна- 
чит строка 51 представляет собой массив: 


О бт ae ae О Зее А ЗЫ CT ta ae, Sat RG? А 

После выполнения функции strstr указатель 5% будет указывать на шестой 
символ — букву 'е’. После того, как в этот символ заносится нуль, строка $51 имеет 
вид: 

Бе ГЫ ВУЗЕ ea Se ND el От Та tgs" Tee et a fat, TAD? 

После изменения Pt OH начинает указывать на девятый символ — пробел по- 


сле слова «ела». После вызова strepy в строку $ копируется первая часть строки 
$1, завершающаяся нулевым символом: 


ree, Ра en А 

После вложенного вызова Strcat к строке S добавляется текст строки 533: 

OP Lars Pay.) ers ' my rei 6: ae 'е', Но та: AO 

И после внешнего вызова Streat к $ добавляется строка, на которую указывает 
St, т.е. часть строки 51, начинающаяся с пробела после «ела»: 

Ne РА, о” by Fhe а te ee A, en ee tbe: ВЕ ИТ ТЗ Te ee 

В качестве последнего примера рассмотрим использование функции sprintf. 
Пусть в приложении имеется окно редактирования Editl, в котором пользователь 
вводит фамилию сотрудника, и компонент CSpinEdit1 типа TCSpinEdit, в котором 
вводится год рождения. Вы хотите сформировать строку вида «Сотрудник ..., 


... Г.р.», в которой вместо точек должны подставляться введенные данные: фами- 
лия и год. Это можно сделать следующим кодом: 
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#include <stdio.h> 
char $[40]; 
sprintf ($, "Сотрудник %s, %1 r.p.",Editl->Text, CSpinEditl->Value) ; 


Первый аргумент функции sprintf — формируемая строка. Второй — строка 
форматирования (ее полное описание см. в главе 15 в разделе 15.1.4.1). Она указы- 
вает текст формируемой строки и содержит спецификаторы, записываемые после 
символа «% », которые указывают формат включения в строку аргументов, список 
которых расположен в вызове sprintf после строки форматирования. В данном 
случае первый из этих параметров — текст в окне Editl, вводимый со специфика- 
тором %$, что означает строку, а второй параметр — значение года в компоненте 
CSpinEdit1, вводимое со спецификатором %1, что означает целое число. 

Мы рассмотрели применение основных библиотечных функций работы со 
строками. Более полное изложение этих функций вы найдете в главе 15 в разде- 
ле 15.4.2. 

C++Builder не ограничивается изложенным выше типичным для С++ подхо- 
дом, сводящим строки к массивам символов. В нем реализованы в виде классов 
еще некоторые очень полезные типы. Наиболее интересные из них — AnsiString, 
имеющий множество методов и перегруженных операций, облегчающих работу со 
строками, и типы списков строк TStrings и TStringList. Первый из них рассмот- 
рен в следующем разделе. А описание второго и третьего вы найдете в главе 16. 


13.4.2 Тип строк AnsiString 


В C++Builder тип строк AnsiString реализован как класс, объявленный в фай- 
ле vel/dstring.h и аналогичный типу длинных строк в Delphi. Это строки с нуле- 
вым символом в конце. При объявлении переменные Tuna AnsiString инициализи- 
руются пустыми строками. 

Для AnsiString определены операции отношения ==, !=, >, <, >=, <=. Сравне- 
ние производится с учетом регистра. Сравниваются коды символов, начиная с пер- 
вого, и если очередные символы не одинаковы, строка, содержащая символ с мень- 
шим кодом, считается меньше. Если все символы совпали, но одна строка длиннее 
и в ней имеются еще символы, то она считается больше, чем более короткая. 

Для AnsiString определены операции присваивания =, += и операция склеи- 
вания строк (конкатенации) +. Определена также операция индексации []. Индек- 
сы начинаются с 1. Например, если 51 = «Привет», то $ Ц1] вернет II’, S1[2] вер- 
нет 'р’ит.д. 

Класс AnsiString имеет множество методов, подробно рассмотренных в главе 
16. Не останавливаясь сейчас на их перечислении, рассмотрим только некоторые 
примеры применения типа AnsiString. 

Tun AnsiString используется для ряда свойств компонентов C++Builder. Ha- 
пример, для таких, как свойства Text окон редактирования, свойства Caption ме- 
ток и разделов меню ит.д. Этот же тип используется для отображения отдельных 
строк в списках строк типа TStrings. Таким образом, постоянно имея дело с этими 
свойствами, вы постоянно работаете с AnsiString. 

Рассмотрим некоторые примеры работы с AnsiString. Следующий оператор 
демонстрирует конкатенацию (склеивание) двух строк: 


Labell->Caption = Editl->Text + ' ' + Edit2->Text; 


В данном случае в свойстве Labell->Caption отображается текст, введенный 
пользователем в окне редактирования Editl1, затем записывается символ пробела, 
а затем — текст, введенный в окне редактирования Edit2. 

Как видите, склеивание строк типа AnsiString легко осуществляется перегру- 
женной операцией сложения «+». Сравните это с теми вложенными вызовами 
функций strcat, которые приходилось делать в предыдущем разделе для Tex же 
операций со строками типа (char *), и вы почувствуете преимущества AnsiString. 
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Теперь попробуем повторить рассмотренный в предыдущем разделе поиск в 
строке 51 фрагмента, заданного строкой 52, и замену его текстом строки $33. Код, 
осуществляющий эти операции, может иметь вид: 


Ansigstring 51, 952,53; 
// операторы занесения текста в 51, $2, $3 


int i = $1.Роз (52); 

en (2) 

Labell->Caption = S1.SubString(1,i-1) + S3 + 
S1.SubString(i+S2.Length(),255); 

else Labell->Caption = "Текст не найден"; 


В этом коде использован ряд функций-элементов класса AnsiString: Pos, Sub- 
String, Length. Обратите внимание Ha то, что доступ к ним осуществляется опера- 
цией точка (.), вместо более привычной в C++Builder операции доступа к методам 
компонентов стрелка (->). Дело в том, что к методам компонентов доступ осущест- 
вляется через указатель на объект, а в данном случае к методам AnsiString доступ 
осуществляется через сами объекты — строки. 

Первый выполняемый оператор приведенного кода использует функцию Pos. 
Эта функция ищет в строке, к которой она применена (в нашем случае в 51), пер- 
вое вхождение подстроки, заданной ее параметром (в нашем случае $2). Если по- 
иск успешный, функция возвращает индекс первого символа найденного вхожде- 
ния подстроки. Индексы начинаются с 1. Если подстрока не найдена, возвращает- 
ся 0. 

Следующий оператор с помощью структуры if...else проверяет, не равно ли 
нулю (false) возвращенное функцией Pos значение. Если не равно, то производится 
формирование строки с заменой найденной подстроки. Строка формируется склеи- 
ванием трех строк: начальной части строки 51, расположенной до найденного вхож- 
дения подстроки, строки 53, заменяющей найденное вхождение, и заключительной 
части строки $1, расположенной после найденного вхождения. Для получения 
фрагментов строки $1 использована функция SubString. Эта функция возвращает 
подстроку, начинающуюся с символа в позиции, заданной первым параметром 
функции, и содержащую число символов, не превышающее значение, заданное вто- 
рым параметром функции. Таким образом, выражение S$1.SubString(1, i - 1) возвра- 
щает подстроку строки 51, начинающуюся с первого символа и содержащую i - 1 
символов, т.е. часть строки 51, расположенную до найденного вхождения подстро- 
ки 52. Аналогично, выражение S1.SubString(i + S2.Length(), 255) возвращает под- 
строку строки 51, расположенную после найденного вхождения подстроки 32. При 
этом для определения начала этой подстроки использована функция Length, воз- 
вращающая число символов в строке (в нашем случае — в строке 532, содержащей 
заменяемый фрагмент). В приведенном выражении в качестве второго параметра 
функции SubString задано число 255, которое, Kak ожидается, превышает длину 
подстроки. В действительности будет возвращено менее 255 символов, столько, 
‚ сколько имеется до завершающего 31 нулевого символа. 

Сравнение данного кода с приведенным в предыдущем разделе для типов 
строк (char *), как мне кажется, показывает большую прозрачность действий со 
строками AnsiString. 

Если нам надо не отображать измененную строку в виде сообщения, а ЗВ 
произвести замену фрагмента в исходной строке S1, это еще более упрощает кой, 
который в этом случае сводится всего к двум операторам: 

int 1 = S1.Pos(S2); 

$1 = S1.SubString(1, i-1) > +: 53 + S1.SubString (1+32. Length (), 255); 


Подобная задача для строк (char *) была бы более сложной и потребовала бы 
объявления дополнительного буфера для временного хранения формируемой стро- 
ки. | 
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Давайте еще более усложним задачу: пусть в строке 81 надо заменить все вхо- 
ждения 52 на строку 53. Эту задачу можно было бы решить следующим кодом: 
АС: 10. = 0, i = S1.Pos ($2) 
while (i) 
{ 
Se Si 3 Substring (1,1. '4°10' = 17 +. 33 А 
§1:..SubString(i +. 10 +:S2.Length() / 295) 
£0 +=.:3.- 1. -+.83.Length(); 
i: = 61::SubString (i0. :+.51 4-255) <Pos ¢S2) ; 
} 


Приведенный код мало отличается от рассмотренного ранее и не содержит Ka- 
ких-то новых функций. Основные отличия заключаются в следующем. Во-первых, 
вводится переменная 1© — индекс, предшествующий первому символу еще не обра- 
ботанной части строки 51. Значение 10 изменяется после обработки очередной час- 
ти строки. Во-вторых, очередное вхождение строки 52 в 51 определяется не по 
всей строке $1, а только по ее еще не meee geinr части : $1.SubString(i0 + 1, 
255). 

Рассмотренную задачу контекстного поиска и замены в строке можно было бы 
решить иначе, воспользовавшись функциями Delete и Insert класса AnsiString. 
Функция Delete удаляет из строки, начиная с позиции, заданной первым парамет- 
ром функции, число символов, заданное вторым параметром функции. Функция 
Insert вставляет в строку подстроку, заданную первым параметром функции, в по- 
зицию, заданную вторым параметром функции. 

Применение этих функций позволяет выполнить контекстную замену с помо- 
щью, например, следующего кода: 

int 10 = 1, i = S1.Pos(S2); 

while(i > i0) 


{ 
S1.Delete(i,S2.Length()); // удаление вхождения $2 
S1..insernt.($3,4).; // вставка S3 
10 = 1 + $3.Length(); 
Тит 1 Se ST eSupetring (10, 255) .Fostsaly 
} 


Мы проиллюстрировали применение только малой части методов, имеющихся 
в классе AnsiString. Полный перечень этих методов вы найдете в соответствую- 
щем разделе главы 16. В заключение отметим только метод, позволяющий перехо- 
дить от типа AnsiString к типу (char *). Несмотря на то, что применение Ansi- 
String практически всегда удобнее (char *), такие переходы приходится делать 
при передаче параметров в некоторые функции, требующие тип параметра (char 
*). Чаще всего это связано с вызовом функций API Windows или функций 
C++Builder, инкапсулирующих такие функции. Например, на протяжении этой 
книги многократно использовалась функция Application->MessageBox, требую- 
щая в качестве двух своих первых параметров (сообщения и заголовка окна) тип 
(char *). Аналогичные преобразования требуются для функции PlaySound для пе- 
редачи в нее имени файла и для многих других функций. 

Преобразование строки AnsiString в строку (char *) осуществляется функци- 
ей c_str() без параметров, возвращающей строку с нулевым символом в конце, со- 


‚ держащую текст той строки AnsiString, к которой она применена. Например, если 
‚вы имеете строки 51 и 52 типа AnsiString, которые хотите передать в функцию 


Application->MessageBox в качестве сообщения и заголовка окна, то вызов Appli- 
cation->MessageBox может иметь вид: 


Application->MessageBox(Sl.c_str(),S2.c str(), MB OK); 


Возможно и обратное преобразование строки (char *) в строку ОВНА: Для 
этого используется функция 
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AnsiString(char *S) 


которая возвращает строку типа AnsiString, содержащую текст, записанной в 
строке $, являющейся аргументом функции. 


13.5 Перечислимые типы 


Перечислимые типы определяют упорядоченное множество идентификаторов, . 
представляющих собой возможные значения переменных этого типа. Вводятся эти 
типы для того, чтобы сделать код более понятным. В частности, многие типы 
C++Builder являются перечислимыми, что упрощает работу с ними, поскольку 
дает возможность работать не с абстрактными числами, а с осмысленными значе- 
ниями. : 

Приведем пример, который покажет смысл введения пользователем своего пе- 
речислимого типа. Пусть, например, в программе должна быть переменная Mode, 
в которой зафиксирован один из возможных режимов работы приложения: чтение 
данных, их редактирование, запись данных. Можно, конечно, дать переменной 
Mode тип int и присваивать этой переменной в нужные моменты времени одно из 
трех условных чисел: 0 — режим чтения, 1 — режим редактирования, 2 — режим 
записи. Тогда программа будет содержать операторы вида 


1Е (Моае == 1) 

Через некоторое время уже забудется, что означает значение Моде, равное 1, и 
разбираться в таком коде будет очень сложно. А можно поступить иначе: опреде- 
лить переменную Моде как переменную перечислимого типа и обозначить ее воз- 


можные значения как MRead, mEdit, mWrite. Тогда приведенный выше оператор 
изменится следующим образом: 


if (Mode == mEdit) 


Конечно, такой оператор понятнее, чем предыдущий. 


Хороший стиль программирования 


Не вводите в свои программы числовые константы, отображающие какие-то режимы работы 
или состояния объектов. Пользуйтесь для этого перечислимыми типами. Тогда код программы 
становится намного понятнее и легче осуществлять его модификацию и сопровождение. 


Переменные перечислимого типа могут определяться предложением вида: 


enum {<константа 1>, ..., <константа n>} <имена переменных>; 


Например 
enum {mRead, mEdit, mWrite} Mode; 


Этот оператор вводит именованные константы mMRead, mEdit, mWrite и пере- 
менную Моде, которая может принимать значения этих констант. В момент объяв- 
ления переменная инициализируется значением первой константы, в нашем при- 
мере — mRead. В дальнейшем вы можете присваивать ей любые допустимые зна- 
чения. Например: 


Mode = mEdit; 


Значение переменной перечислимого типа можно проверять, сравнивая ее ве- 
личину с возможными значениями. Кроме того, надо учитывать, что перечисли- 
мые типы относятся к целым порядковым типам и к ним применимы любые опера- 
ции сравнения: al < ит.п. Например, вы можете писать операторы: 

if (Mode > mRead) i 


if (Mode < mWrite) ...; 
if (Mode == mEdit) ; 
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Вы можете также использовать Mode в структуре switch: 


Switch (Mode) 
{ 
case mRead: 5 
break; 
case mEdit: 
break; 
case mWrite: 


} 


По умолчанию перечислимые значения, указанные в объявлении enum, ин- 
терпретируются как целые числа, причем первое значение эквивалентно 0, вто- 
рое — 1 ит.д. Именно эти значения рассматриваются в операциях отношения >, < 
и др. Значения по умолчанию можно изменить, если после имени константы ука- 
зать знак равенства (=) и задать присваиваемое целое значение, как положитель- 
ное, так и отрицательное. Например: 


enum {mRead = -1, mEdit, mWrite = 2} Mode; 


Если после каких-то констант не задано их целое значение, OHO считается на 1 
больше предыдущего. Поэтому в приведенном примере mRead эквивалентно -1, 
mEdit эквивалентно 0, mWrite эквивалентно 2. 

После ключевого слова епат может следовать тэг — имя объявляемого типа. 
Например: 

enum regim {mRead = -1, mEdit, mWrite = 2} Mode, Model; 


Этот оператор объявляет две переменные Mode и Model перечислимого типа, 
и кроме того определяет тип regim. В дальнейшем вы можете воспользоваться име- 
нем regim для объявления каких-то новых переменных, например: 


regim Mode3; 


13.6 Множества 


Множество — это группа элементов, которая ассоциируется с ее именем и с KO- 
торой можно сравнивать другие величины, чтобы определить, принадлежат ли они 
этому множеству. Как частный случай, множество может быть пустым. 

Множество реализовано в C++Builder как шаблон класса, определенный в го- 
ловном файле vel/sysdefs.h. 

Объявляется множество оператором: 


Set <type, minval, maxval> переменные; 


Параметр type определяет тип элементов множества. Обычно это порядковые 
типы int, char или перечислимый. Параметры minval и maxval типа unsigned 
char определяют минимальное и максимальное значения элементов множества. 
Минимальное значение должно быть не меньше 0, максимальное — не более 255. 

Приведем примеры объявления множеств. 

Объявление переменной $1 как множества всех заглавных латинских букв 
имеет вид: 


Sat.cchar,. A‘ 3. :2’> a1) 
Следующий оператор объявляет множество Ch, содержащее все символы: 
Set: <char;’ 0,/.255>СНн; 


Следующие операторы объявляют тип UPPERCASESet множества всех 3a- 
главных латинских букв и объявляют переменные $2 и $3 этого типа: 


typedef Set <char, 'А','2'> UPPERCASESet; 
UPPERCASESet sl, s2; 
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Следующие операторы определяют множество S, элементами которого явля- 
ются данные перечислимого типа Е: red, yellow, green: 


enum Е { white, red, yellow, green }; 
Set <E, red, green> S; 


Объявление переменной типа множества Set не инициализирует ее какими-то 
значениями. Инициализацию можно делать с помощью описанной ниже опера- 
ции << — добавление элемента в множество. 

Для множества определены следующие операции (в описании операций слова- 
ми «данное множество» обозначается левый операнд): 


зева a ыы им 


Set __fastcall operator -(const Set& Ais данное множество равно 
разности двух множеств: 
данного и rhs (операция 
хог с их элементами) 


Set& __ ГазфсаП operator -=(const создание нового множе- 
Set& rhs); ства, определенного раз- 

ностью двух множеств: 
данного и rhs (операция 

хог с их элементами). 


Set& __fastcall operator *=(const создание нового множе- 
Set& rhs); ства, определенного пе- 
ресечением двух мно- 
жеств: данного и rhs 
(операция and с их эле- 
ментами) 


Set __fastcall operator *(const Set& rhs) | данное множество равно 
const; пересечению двух MHO- 
жеств: данного и rhs 
(операция and с их эле- 
ментами) 


Set __ fastcall operator +(const Set& rhs) | создание нового множе- 
const; ства, определенного объ- 
единением двух мно- 
жеств: данного и rhs 
(операция ог с их эле- 
ментами) 


Set& _ fastcall operator +=(const данное множество равно 
Set& rhs); объединению двух MHO- 
жеств: данного и rhs 
(операция ог с их эле- 
ментами) 


friend ostream& operator <<( поместить множество arg 
ostream& os, const Set& arg); в поток ostream (выво- 
дится 0 или 1 для каж- 
дого элемента в зависи- 
мости от его наличия в 
множестве). 
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[Операция |Опрделене [Общее | 


Set& __fastcall operator >>(const T el); |удаление элемента el из | 
данного множества | 


| 

| 

friend istream& operator >>(istream& is, | извлечь множество arg | 
Set& arg); |из потока istream (вво- | 

дится 0 или 1 для каж- 
дого элемента в зависи- 
мости от его наличия в 
множестве) 


Set& __fastcall operator =(const 
Set& rhs); 


присваивание данному 
множеству содержимого 
множества rhs 


bool __fastcall operator ==(const 
Set& rhs) const; 


эквивалентность двух 
множеств: данного и rhs 
(совпадение всех элемен- 
тов) 


bool __fastcall operator !=(const неэквивалентность двух | 
Set& rhs) const 3 | множеств: данного и rhs | 


| 
| 
| 
| 
| 
| 
| 


>> 


Все операции можно применять только к множествам одного типа, то есть к 
таким, при объявлении которых все аргументы объявления (type, minval и тах- 
val) совпадают. В операциях, создающих новое множество (операции +, - и *), пе- 
ременная, в которую заносится результат, также должна быть того же типа, что и 
операнды. Операция эквивалентности возвращает true в случае, когда оба операн- 
да содержат только совпадающие элементы. Соответственно только в этом случае 
операция неэквивалентности возвращает false. 

Для множеств Set определены также два метода: 


~ = ———=—— = —. > —=—- = ——- : -— -==—-=-- == = 


Clear Set& __fastcall Clear(); 


Contains {bool _ fastcall Contains(const T el) const; | проверка наличия в 
множестве элемента el | 


Рассмотрим примеры работы с множествами. Пусть вы задаете пользователю в 
программе некоторый вопрос, подразумевающий ответ типа «Yes/No». Тогда воз- 
можные символы, вводимые пользователем в качестве ответа, являются множест- 
вом, содержащим символы «у», «У», «п» и «№». Сформировать такое множество 
можно операторами: | 


Set <char, 0, 255> TrueKey; 


| 
| 
| 
| 


Truekey..<<. 'y'. <<. 11 '-<< 101 << NS; 


Тогда проверить, принадлежит ли введенный пользователем символ Кеу MHO- 
жеству допустимых ответов, можно с помощью метода Contains: 
if (!TrueKey.Contains (Key) ) 


ShowMessge ("Вы ввели ошибочный ответ"); 
else 


Рассмотрим еще один пример. Пусть вы хотите, чтобы в окне редактирования 
Editl пользователь мог вводить только число, т.е. только цифры от 0 до 9. Это 
можно сделать, включив в обработчик события OnKeyPress этого окна операторы: 
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зёс <cna rr Олин РЕ 
Dig << ме << ух Ч ee 25 че Je a ex. г &. ca 151 
3$ 68. << 117; <<: 188: << #91; 
if (!Dig.Contains (Key) ) 
{Key = 0; Beep();} 
При попытке пользователя ввести символ, отличный OT цифры, раздастся 
звук (его обеспечит функция Веер) и символ не появится в окне. Подробнее этот 
пример рассмотрен в главе 4 в разделе 4.3.2.2. 


13.7 Указатели 


Указатель — это переменная, значение которой равно значению адреса памя- 
ти, по которому лежит значение некоторой другой переменной. В этом смысле имя 
этой другой переменной отсылает к ее значению прямо; а указатель — косвенно. 
Ссылка на значение посредством указателя называется косвенной адресацией. 

Указатели, подобно любым другим переменным, перед своим использованием 
должны быть объявлены. Объявление указателя имеет вид: 


type *ptr; 


где type — один из предопределенных или определенных пользователем типов, a 
ptr — указатель. Читается это объявление так: «ptr является указателем на значе- 
ние типа type». 

Например, 

int *countPtr, count; 
объявляет переменную countPtr типа int * (т.е. указатель Ha целое число) и пере- 
менную count целого типа. Символ * в объявлении относится только к countPtr. 
Каждая переменная, объявляемая как указатель, должна иметь перед собой знак 


звездочки (*). Если в приведенном примере желательно, чтобы и переменная count 
была указателем, надо записать: 


int *countPtr, *count; 


Символ * в этих записях обозначает операцию косвенной адресации. 
Может быть объявлен и указатель Ha Void: - 
void *Pv; 


Это универсальный указатель Ha любой тип данных. Ho прежде, чем ero ис- 
пользовать, ему надо в процессе работы присвоить значение указателя на какой-то 
конкретный тип данных. Например: 


Ру = countPtr; 


Хо ро LU и й стил b п Pp о гр а мм и ро ва H и я socsboaiecenedaeesbapociasseecocaciecosossscesstenscosaseesebeeeseugesieesconetestesstesccetseseseseasveceeeaiesesesscstsesisisipibocigiaettok eogpeingg mete ee 


Хотя это и не обязательно, включайте буквы Ptr или просто P в имена переменных указате- 
лей, чтобы и вам, и тем, кто будет сопровождать вашу программу, было ясно, что эти пере- 
менные являются указателями и требуют соответствующей обработки. 


SSE EE EEE LLL LRG EE EER me я В О о В В В ай 


чеки ь ия 


В C++Builder указатели используются очень широко. В частности, все компо- 
ненты, формы и т.д. объявляются именно как указатели на соответствующий объ- 
ект. Посмотрев заголовочный файл любого приложения, вы увидите в нем объяв- 
ления вида: 


TForml *Forml; 
TButton *Buttonl; 


Указатели должны инициализироваться либо при своем объявлении, либо с 
помощью оператора присваивания. Указатель может получить в качестве началь- 
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ного значения 0, NULL или адрес. Указатель с начальным значением 0 или NULL 
ни на что не указывает. NULL — это символическая константа, определенная спе- 
циально для цели показать, что данный указатель ни на что не указывает. Пример 
объявления указателя с его инициализацией: 


int *countPtr = NULL; 


Xo po LU WM й стил ib п ро гра MM и р Oo B a MH и ы эн 7 ПИЛИ ВЯ УНИКУМ SSO CTP: BOR И УЛИК DIRE CY SOE PEORISE ONG EE SALES 


Присваивайте указателям при их объявлении значение NULL или адрес. Неинициализиро- 
ванный указатель может при работе с ним приводить к самым неожиданным результатам. 


SNAPP HL ККИ ERE IEE LO IE RI ИКИ КИЖИ НИИ ХИМЕНА НИККО УНИАН ККНАЧАКИМЕ ИКАО ИКАМА ЕАК ИМИ -ИУКИЛИ ЧИ ННИХИКЕ SLES ADEE PGE КЕНИИ АКИ АЕ SEEELEEESLAE SSSA И ЛИЧКЕ ЧК ЧИК МЕЧА АКБ КАЧИАХЛИХНУМЮ, DOSE SADC LAPCL RIEL ЧИ ХАНА ESASSSSCA ACE: 


Rie 


Для присваивания указателю адреса некоторой переменной используется опе- 
рация адресации &, которая возвращает адрес своего операнда. Например, если 
имеются объявления 

int у = 5; 

tnt, *yPtry х; 


то оператор 
yPtr = &y; 


присваивает адрес переменной у указателю yPtr. 

Для того, чтобы получить значение, на которое указывает указатель, исполь- 
зуется операция *, обычно называемая операцией косвенной адресации или опера- 
цией разыменования. Она возвращает значение объекта, на который указывает ее 
операнд (т.е. указатель). Например, если продолжить приведенный выше пример, 
то оператор 


x = *yPtr 


присвоит переменной х значение 5, т.е. значение переменной у, на которую указы- 
вает yPtr. 


п р е ду п р ежд е H и eB LREORE LOOPED LEE LOL LES LLE LLL INL к о о в в LEAL ELALELLLALESABE ALLIES LEELA GAOL LEILA ии бб BA LAE, 


Операцию разыменования нельзя применять к указателю на void, поскольку для него неиз- 

вестно, какой размер памяти надо разыменовывать. 

Массивы и указатели в Си++ тесно связаны и могут быть использованы почти 
эквивалентно. Имя массива можно понимать как константный указатель на пер- 
вый элемент массива. Его отличие от обычного указателя только в том, что его 
нельзя модифицировать. 

Указатели можно использовать для выполнения любой операции, включая 
индексирование массива. Пусть вы сделали следующее объявление: 


ane OTS) “= {1,27 374,59, “РС; 


Tem самым вы объявили массив целых чисел b[5] и указатель на целое Pt. По- 
скольку имя массива является указателем на первый элемент массива, вы можете 
задать указателю Pt адрес первого элемента массива Ъ с помощью оператора 


Pt. = р; 


Это эквивалентно присваиванию адреса первого элемента массива следующим 
образом | 


Pt = &b[0); 


Теперь можно сослаться на элемент массива b[3] с помощью выражения *(Pt + 3). 

Указатели можно индексировать точно так же, как и массивы. Например, вы- 
ражение РЗ] ссылается на элемент. массива ШЗ]. 

Таким образом манипуляции, определенные для массивов, определены и для 
указателей на массивы. Но с точки зрения понятности программы лучше это без 
крайней необходимости не использовать. 
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Указатели могут применяться как операнды в арифметических выражениях, 
выражениях присваивания и выражениях сравнения. Однако, не все операции, 
обычно используемые в этих выражениях, разрешены применительно к перемен- 
ным указателям. 

С указателями может выполняться ограниченное количество арифметических 
операций. Указатель можно увеличивать (++), уменьшать (--), складывать с указа- 
телем целые числа (+ или +=), вычитать из него целые числа (- или -=) или вычи- 
тать один указатель из другого. 

Сложение указателей с целыми числами отличается от обычной арифметики. 
Прибавить к указателю 1 означает сдвинуть его на число байтов, содержащихся в 
переменной, на которую он указывал. Обычно подобные операции применяются к 
указателям на массивы. Если продолжить приведенный выше пример, в котором 
указателю Pt было присвоено значение b — указателя на первый элемент массива, 
то после выполнения оператора 


РЕ += 2; 


Pt будет указывать на третий элемент массива Ъ. Истинное же значение указа- 
теля Pt изменится на число байтов, занимаемых одним элементом массива, умно- 
женное Ha 2. Например, если каждый элемент массива b занимает 2 байта, то зна- 
чение Pt (т.е. адрес в памяти, на который указывает Pt) увеличится на 4. 

Аналогичные правила действуют и при вычитании из указателя целого значе- 
ния. 

Переменные указатели можно вычитать один из другого. Например, если Pt 
указывает на первый элемент массива Ъ, а указатель Ptl — на третий, то результат 
выражения Ptl - Pt будет равен 2 — разности индексов элементов, на которые ука- 
зывают эти указатели. И так будет, несмотря на то, что адреса, содержащиеся в 
этих указателях, различаются на 4 (если элемент массива занимает 2 байта). 

Арифметика указателей теряет всякий смысл, если она выполняется не над 
указателями на массив. Нельзя полагать, чтоб две переменные одинакового типа 
хранятся в памяти вплотную друг к другу, если только они не соседствуют в масси- 
ве. Сравнение указателей операциями >, <, >=, <= также имеют смысл только для 
указателей на один и тот же массив. Однако, операции отношения == и != имеют 
смысл для любых указателей. При этом указатели равны, если они указывают на 
один и тот же адрес в памяти. 

Указатель можно присваивать другому указателю, если оба указателя имеют 
одинаковый тип. В противном случае нужно использовать операцию приведения 
типа, чтобы преобразовать значение указателя в правой части присваивания к 
типу указателя в левой части присваивания. Исключением из этого правила явля- 
ется указатель на void (т.е. void*), который является общим указателем, способ- 
ным представлять указатели любого типа. Указателю на уо14 можно присваивать 
все типы указателей без приведения типа. Однако указатель на VOid не может быть 
присвоен непосредственно указателю другого типа — указатель Ha void сначала 
должен быть приведен к типу соответствующего указателя. 

Мы рассмотрели ранее указатели на массивы. Однако, соотношение между 
массивами и указателями может быть и обратным — могут использоваться масси- 
вы указателей. Подобные структуры часто используются в массивах строк или в 
массивах указателей на различные объекты. 

Например, вы можете сделать следующее объявление: 


char *ба[2] = {"Это первая строка", "Вторая"}; 


Вы объявили массив размером 2 элементов типа (char *). Каждый элемент та- 
кого массива — строка. Но в C++ строка является, по существу, указателем на ee 
первый символ. Таким образом, каждый элемент в массиве строк в действительно- 
сти является указателем на первый символ строки. Каждая строка хранится в па- 
мяти как строка, завершающаяся нулевым символом. Число символов в каждой 
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из строк может быть различным. Таким образом, массив указателей на строки по- 
зволяет обеспечить доступ к строкам символов любой длины. 

Указатели широко используются при передаче параметров в функции. Особен- 
ности использования указателей в этих целях см. в разделе 12.5.2 главы 12. 

В разделе 1.5.6 главы 1 подробно рассмотрены указатели на объекты и работа 
с ними. 


13.8 Ссылки 


Ссылки — это специальный тип указателя, который позволяет работать с ука- 
зателем как с объектом. Объявление ссылки делается с помощью операции ссыл- 
ки, обозначаемой амперсантом (&) — тем же символом, который используется для 
адресации. Если в вашей программе имеется указатель на объект какого-то типа 
MyObject: 

MyObject *P = new MyObject; 
то вы можете создать ссылку на этот объект оператором: 

MyObject & Ref = *P; 


Объявленная таким образом переменная Ref является ссылкой на объект 
MyObject. Она может рассматриваться как псевдоним объекта. Эта переменная ре- 
ально является указателем, а не самим объектом. Но работа с ней производится 
как с объектом. Например, если вы хотите получить доступ к некоторому свойству 
объекта X, то через указатель на объект вы обеспечиваете доступ выражением 
Р->х, т.е. через операцию стрелка. А через ссылку вы обеспечиваете доступ к свой- 
ству х выражением Ref.x, т.е. через операцию точка. 

Аналогичным образом вы можете получить доступ по ссылке и к любым ком- 
понентам. Например, если в вашем приложении имеется метка Labell, то вы мо- 
жет обращаться к его свойству Caption оператором 


Labell->Caption = "Это обращение по указателю"; 


А можете ввести соответствующую ссылку и обращаться через нее: 


TLabel & ref = *Labell; 
ref.Caption = "Это обращение по ссылке"; 


Чаще всего ссылки используются при передаче в функции параметров по 
ссылке. Этот вопрос подробно рассмотрен в главе 12 в разделе 12.5.2. 


13.9 Файлы и потоки 


Работа с файлами в C++Builder может производиться несколькими принципи- 
ально различными (с точки зрения пользователя) способами: 


Ш использование библиотечных компонентов 

Ш работа с файлами как с потоками в стиле С 

Ш абота с файлами как с потоками в стиле С++ 
Рассмотрим эти возможности. 


13.9.1 Файловый ввод/вывод с помощью компонентов 


Работа с текстовыми файлами может осуществляться с помощью методов 
LoadFromFile и SaveToFile, имеющихся у классов TStrings и TStringList. Эти 
классы описывают списки строк и обладают множеством методов, позволяющих 
манипулировать строками. 
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Если вы хотите в своем приложении прочитать содержимое некоторого тексто- 
вого файла, обработать текст и сохранить его в файле, вы можете сделать это сле- 
дующим образом. Объявите и создайте две глобальные переменные: список типа 
TStringList, в котором будет храниться текст файла, и строковую переменную 
типа AnsiString, в которой можете сформировать имя файла. Например: 

TStringList *List = new TStringList; 

AnsiString SFile = "Test.txt"; 


Не забудьте только, что если требуемый файл расположен не в текущем`ката- 
логе и вам надо указать путь к файлу, то обратные слеши в записи пути должны 
быть сдвоенные (см. раздел 12.3.1 главы 12). Например, если вам требуется файл 
«c:\MyTest\Test.txt», то вы должны записать его как «c:\\MyTest\\Test.txt». 

В момент, когда вы хотите загрузить в свой список файл, надо выполнить опе- 
ратор 

List->LoadFromFile(SFile) ; 

Впрочем, ограничиться таким оператором можно, если есть уверенность, что 


требуемый файл существует. В противном случае код надо несколько усложнить, 
чтобы можно было перехватить сгенерированное исключение. Например: 


try{ 

List->LoadFromFile(SFile); 

} 
Catena... ct 

ShowMessage ("Файл \"" + SFile +"\" не найден"); 


} 


Если файл нормально загрузился в список List, вы можете работать с его TeK- 
стом. Текст расположен в свойстве списка Strings[int Index], в котором каждая 
строка имеет тип AnsiString. Индексы начинаются с нуля; Для нашего примера 
List->Strings[0] — это первая строка, List->Strings[1] — вторая и т.д. 

Для списков типа TStringList предусмотрено множество методов, которые вы 
можете посмотреть в соответствующем разделе главы 16. При обработке отдель- 
ных строк вы можете использовать операции и методы, предусмотренные для 
строк типа AnsiString (см. раздел 13.4.2 и соответствующий раздел главы 16). 

Если вы хотите сохранить файл после проведенного редактирования, можно 
выполнить оператор 


List->SaveToFile(SFile) ; 


где SFile содержит прежнее или новое имя файла. 

Если при открытии и сохранении файла вы хотите воспользоваться стандарт- 
ными диалогами Windows, вы можете посмотреть раздел 3.8.2 главы 3, в котором 
подробно расписаны необходимые для этого действия. 

Если вы открываете файл для того, чтобы пользователь мог его просмотреть, 
что-то в нем отредактировать и сохранить, вы можете обойтись без описанного 
выше объекта типа TStringList. Для этих целей проще воспользоваться много- 
строчными окнами редактирования типов ТМето или TRichEdit. В последнем 
случае вы можете работать не только с обычными текстовыми файлами, HO и с 
файлами в обогащенном формате RTF. Свойства Lines этих компонентов имеют 
тип TStrings, что позволяет применять к ним непосредственно методы 
LoadFromFile и SaveToFile. Например: 


Memol->Lines->LoadFromFile(SFile) ; 
RichEdit1l->Lines->LoadFromFile(SFile); 


Работа с компонентами Memo и RichEdit подробно рассмотрена в главе 3 в раз- 
деле 3.2.4. 

Через компоненты C++Builder можно работать не только с текстовыми файла- 
ми, нои с файлами изображений и мультимедиа. Этим вопросам посвящена глава 5. 


752 Глава 13 


13.9.2 Файловый ввод/вывод с помощью потоков в стиле С 


13.9.2.1 Общие сведения 


В языках С и С++ файл рассматривается как поток (stream), представляющий 
собой последовательность считываемых или записываемых байтов. При этом по- 
ТОК «не знает», что и в какой последовательности в него записано. Расшифровка 
смысла записанных последовательностей байтов лежит на программе. 

Классический подход, принятый в С, заключается в том, что информация о 
потоке (файле) заносится в структуру типа FILE, определенную в файле stdio.h. 
Файл открывается с помощью функции fopen, которая возвращает указатель на 
структуру типа FILE. Этот указатель потока используется далее во всех операциях 
с файлами. 

Синтаксис функции Фореп: 


#include <stdio.h> 
FILE *fopen(const char *filename, const char *mode) ; 


Функция fopen открывает файл с именем в виде строки, на которую ссылается 
указатель filename, и связывает с ним поток. Аргумент Mode указывает на строку, 
которая определяет режим открытия. Она может содержать спецификаторы: 


ИРЕН ЕН ЕО ВИНЕ ие ел 


r открыть файл только для чтения 

r+ открыть существующий файл для чтения и записи 

а открыть или создать файл для записи данных в конец файла 

а+ | открыть или создать файл для чтения или записи в конец файла 
У создать файл для записи 

wt создать файл для чтения и записи 


К указанным спецификаторам в конце или перед символом «+» может добав- 
ляться символ «t» — текстовый файл, или «6» — бинарный, двоичный файл. На- 
пример, rt, rb, r+t, r+b ит.д. Если ни символ «t», ни символ «<b» не указаны, TO 
тип открываемого файла определяется значением глобальной переменной _fmode, 
определенной в файле #сп И.В. Она может принимать значения О_ТЕХТ — тексто- 
вый файл (по умолчанию) или O_BINARY — двоичный файл. Более подробное по- 
яснение режимов открытия файлов вы найдете в главе 15 в разделе 15.5.2. 

Открываемый функцией fopen поток буферизуется, т.е. обмен информацией 
происходит не непосредственно с файлом, а с промежуточным буфером, располо- 
женным в оперативной памяти. Информация переписывается из буфера в файл 
только при переполнении буфера или при закрытии файла. В главе 15 в разделе 
15.5.2 вы можете посмотреть функции, управляющие процессом буферизации. 

Функция fopen возвращает указатель на объект, управляющий потоком. Если 
попытка открыть файл закончилась неудачей, fopen возвращает нулевой указатель. 

После того, как необходимая работа с файлом (чтение или запись) завершена, 
файл должен быть закрыт функцией fclose(FILE *), в которую передается указа- 
тель потока. 


13.9.2.2 Текстовые файлы 


Рассмотрим сначала работу с текстовыми файлами. Открытие текстового фай- 
ла «Test.txt» может иметь вид: 


#include <stdio.h> 


FILE *F; 
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if ((F = fopen("Test.txt", "rt")) == NULL) 
{ 

ShowMessage ("Файл не удается открыть"); 
return; В 


} 

ее" // чтение из файла 

fclose(F); // закрытие файла 

Здесь объявляется переменная Е — указатель потока и связывается с файлом 
«Test.txt», открываемым как текстовый только для чтения. Если открыть файл не 
удалось (например, он не существует), появляется сообщение об ошибке. 

Из открытого таким образом файла можно читать информацию. После оконча- 
ния чтения файл должен быть закрыт функцией fclose(F). 

Если бы файл открывался функцией 


fopen("Test.txt", "rt+"™) 


то из такого файла можно было бы не только читать информацию, HO и записывать 
в него новые строки. 

Из текстового файла можно читать информацию по строкам или по символам. 
Чтение строки осуществляется функцией fgets: 


char *fgets(char *s, int п, FILE *stream) ; 


В вызове функции $ — указатель на буфер, в который читается строка, п — 
число читаемых символов. Чтение символов в строку происходит или до появле- 
ния символа конца строки «\п» (этот символ записывается в строку), или читается 
п-1 символ. В конце прочитанной строки записывается нулевой символ. 

Например, чтение и отображение в компоненте Memol всех строк файла мо- 
жет быть организовано следующим образом: 


char $[80]; 
Memol->Clear(); 
do 


{ 
fgets (3;80,Е); 
if(feof(F)) break; 


if(s[strlen(s)-1] == '\n') s{strlen(s)-1] = 0; 
Memol->Lines->Add(s); 

} 

fclose(F); // закрытие файла 


Функция fgets читает очередную строку. Функция feof проверяет, не прочи- 
тан ли символ конца файла. При чтении этого символа feof возвращает ненулевое 
значение и цикл прерывается. Если признака конца файла нет, то оператор 


if(s[strlen(s)-1] == '\n') s[strlen(s)-1] = 0; 


убирает из строки последний символ, если он оказывается символом перевода 
строки. Эта операция не обязательна, но наличие символа «\N» испортит вид стро- 
ки в окне Memol. Затем прочитанная строка заносится в окно редактирования. 

Чтение из текстового файла форматированных данных может осуществляться 
функцией fscanf. | 


int fscanf(FILE *stream, const char *format[, address, ...]); 


Ее параметр format определяет строку форматирования аргументов, заданных 
своими адресами. Подробно строка форматирования рассмотрена в главе 15 в раз- 
деле 15.1.4.2. Сейчас отметим только, что эта строка при чтении обычно состоит из 
последовательности символов «% », после которых следует символ типа читаемых 
данных. Ниже приведены некоторые наиболее часто используемые символы (под- 
робнее см. в разделе 15.1.4.2 главы 15): 
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Тип аргумента функции — 


Десятичное, восьмеричное или int *arg 
шестнадцатеричное целое 
long *arg 


Ка See ® Десятичное целое int *arg 
рая Десятичное целое long *arg 


Десятичное, восьмеричное или 
шестнадцатеричное целое 


———————————— ининенен 


Перед символом типа могут добавляться модификаторы. В частности, модифи- 
катор | расширяет тип целого до long int, а тип действительного до double. 

Пусть, например, вы знаете, что начиная с текущей позиции файла в нем за- 
писаны, разделенные пробелами, два целых и одно действительное число. Тогда 
прочитать эти числа можно операторами: 

tnt iat, дао 

double r; 

fscanf(F, "%а%а%1е", &1i1, &12, &r); 
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Обратите внимание, что в качестве аргументов, в которые заносятся читаемые функцией 
5 сай! данные; всегда указываются адреса переменных, а не сами переменные. Отсутствие 
операции адресации (&) — очень распространенная ошибка, которая приводит к самым нео- 
жиданным результатам. 
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При форматированном чтении могут возникать ошибки из-за достижения кон- 
ца файла или из-за неверного формата записанного в файле числа. Проверить, ус- 
пешно ли прошло чтение, можно по значению, возвращаемому функцией fscanf. 
При успешном чтении она возвращает число прочитанных полей. Поэтому в на- 
шем примере лучше организовать чтение следующим образом: 

“it (ЕзсапЕ(Р, “tdtdtle”, &11, &12, 4r) T= 3) 

{ 


ShowMessage ("Ошибка чтения"); 


ya 


Символ типа $ позволяет читать из файла отдельное слово, точнее — так назы- 
ваемую лексему — последовательность символов, завершающуюся пробельным 
символом. Пусть, например, мы хотим просмотреть файл, чтобы узнать, не встре- 
чается ли в нем слово, которое пользователь ввел в окне редактирования Editl. 
Для решения этой задачи после того, как файл открыт, можно выполнить, напри- 
мер, следующий код: 

char $[80], key[10]; 

strcpy (key, Editl->Text.c str()); // загрузка ключевой строки 

do 

{ 


Tecant tl...” ts"+: 63) 
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1Е (ЕеоЕ(Е)|| !stremp(s,key)) break; 
} 
while (true) ; 
fclose(F); 
if (!strcmp(s, key) ) 
ShowMessage("CnoBO найдено"); 


В этом коде вводится рабочая строка $ и строка key, в которую функцией 
strepy загружается ключевое слово. Далее в цикле функцией fscanf в строку $ чи- 
тается по одной лексеме из файла. Функция Strcmp сравнивает эту лексему с клю- 
чом. Она возвращает 0, если строки $ и Кеу совпадают. В этом случае, а также при 
достижении конца файла цикл прерывается. 

Мы рассмотрели вопросы чтения из текстового файла. Имеется также ряд 
функций записи в текстовый файл. Наиболее часто используемая из них — функ- 
ция fprintf: 


int fprintf(FILE *stream, const char *format[, argument, ...]); 


Эта функция подобна рассмотренной выше функции fscanf, только строка 
форматирования строится несколько иначе. В ней используются аналогичные рас- 
смотренным ранее символы типа, помещаемые после символа «%». Но имеется 
много возможностей по выбору формата печати данных в файл. Кроме того, все 
символы строки форматирования, не предваряемые символом «%», просто поме- 
щаются в выходной поток. Подробнее о функции fprintf и других функциях запи- 
си вы можете посмотреть в главе 15 в разделе 15.5.4. А пока приведем только ко- 
роткий пример. 

Пусть у вас имеется строка $ типа (char *), содержащая фамилию сотрудника, 
и целое число уеаг, содержащее год его рождения. Вы хотите создать текстовый 
файл и занести в него запись, первая строка которой содержит слово 
«ХАРАКТЕРИСТИКА», а вторая — текст «сотрудника ..., ... г.р.». Вместо точек в 
этом тексте подразумевается фамилия и год рождения. Это можно сделать следую- 
щим кодом: | 


FILE *F; 

if ((F = fopen("Test.txt", "wt")) == NULL) 
{ 

ShowMessage ("Файл не удается создать"); 
return; 

} 

char $[40]; 


int year = 1960; 

strcpy(s, "UBaHOoB") ; 

fprintf(F, "ХАРАКТЕРИСТИКА\псотрудник %s, %1 г.р.\п", &S, 
year); 

fclose(F); 


Файл открывается функцией fopen как текстовый файл для записи. Если фай- 
ла с указанным именем не было, он создается. Если такой файл был, все его содер- 
жимое уничтожается. Затем функцией fprintf в файл записывается требуемый 
текст. В строке форматирования этой функции записан текст первой строки, затем 
указан символ перехода на новую строку «\п»; далее следует начало второй стро- 
КИ — «сотрудник », затем символы «% 5$», задающие тип первого аргумента — ука- 
зателя на $, затем символы «%i», задающие THM второго аргумента — числа year, 
и наконец — заключительная часть второй строки. В результате в файл будут за- 
писаны строки: 


ХАРАКТЕРИСТИКА 
сотрудник Иванов, 1960 г.р. 


Рассмотренными функциями не ограничиваются возможности работы с тек- 
стовыми файлами. Подробнее все эти функции вы можете посмотреть в главе 15 в 
разделе 15.5.4. 
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13.9.2.3 Двоичные файлы 


Теперь остановимся коротко на работе с двоичными файлами. Двоичный файл 
представляет собой просто последовательность символов, в которой без каких-либо 
разделителей — пробелов, символов конца строки и т.п. хранятся символы, ото- 
бражающие самые различные объекты. Они совпадают с тем, как хранятся соот- 
ветствующие объекты в оперативной памяти. Что именно и в какой последователь- 
ности лежит в двоичном файле — должна знать программа. 

Двоичные файлы имеют немало преимуществ перед текстовыми при хранении 
каких-то числовых данных. Операции чтения и записи с такими файлами произ- 
водятся намного быстрее, чем с текстовыми, поскольку отсутствует необходимость 
форматирования: перевода в текстовое представление и обратно. Двоичные файлы, 
как правило, имеют существенно меньший объем, чем аналогичные текстовые 
файлы. В двоичных файлах вы можете перемещаться в любую позицию и читать 
или записывать данные в произвольной последовательности, в то время как в тек- 
стовых фалах практически всегда производится последовательная обработка ин- 
формации. Пожалуй, недостаток двоичного файла с точки зрения программиста 
только один — просматривая его с помощью какого-то текстового редактора, труд- 
но понять, где что в нем находится, и это в ряде случаев затрудняет отладку. 

О том, как открываются двоичные файлы, уже рассказывалось в разделе 
13.9.2.1. Запись и чтение в двоичные файлы чаще всего производятся соответст- 
венно функциями fwrite и fread: 

#include <stdio.h> 


size_t fwrite(const void *ptr, size t size, size t п, FILE *stream); 
size t fread(void *ptr, size t size, size_t п, FILE *stream); 


В обе функции передается указатель ptr Ha выводимые или вводимые данные. 
Параметр size задает размер в байтах передаваемых данных, а параметр п опреде- 
ляет число передаваемых данных. Применение этих функций иллюстрируется 
приведенным ниже примером. 

ие 3 = 1, 3 = 25; 11,31; 

double а = 25e6, al; 


gchar: 3110]... 81[10]; 
strcpy(s, "UBaHOoB"); 


PILE “РР; 

// запись в файл 

if ((F = fopen("Test.dat", "wb")) == NULL) 

{ 

ShowMessage("®aun не удается создать"); 

return; 

} 

fwrite (&i,sizeof(int),1,F); // запись i 
fwrite(&j,sizeof(int),1,F); // запись 7 
fwrite (&a,sizeof (double) ,1,F); // запись a 


fwrite(s,sizeof(char),strlen(s)+1,F); // запись строки $ 
Ес1озе (Е); 


// чтение из файла 


if ((F = fopen("Test.dat", "rb")) == NULL) 

{ = у 

ShowMessage ("Файл не удается открыть"); 

return; 

} 

fread(&il, sizeof (int),1,F); // чтение i 
fread(&j1,sizeof(int),1,F); // чтение 7 

Егеаа (&а1,512еоЕ (double),1,F); // чтение а 
fread(sl,sizeof(char),strlen(s)+1,F); // чтение строки $ 


fclose(F); 
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В данном примере создается двоичный файл «Test.dat» и в него записывается 
два целых числа 1 и }, действительное число а и строка $. Затем этот файл закрыва- 
ется, открывается для чтения и данные из него читаются в переменные il, jl, al 
и $1. 

В отношении записи и чтения чисел, вероятно, все понятно. А вопрос записи и 
чтения строк имеет смысл обсудить подробнее. 

В приведенном примере запись строки производится оператором 


fwrite(s,sizeof(char),strlen(s)+1,F); // запись строки $5 


Запись ведется по символам и указано число записываемых символов — 
strlen(s)+1 (единица добавляется на нулевой символ в конце). Читается трона 
аналогично: 


fread(sl,sizeof(char),strlen(s)+1,F); // чтение строки s 


При этом чтение тоже идет по символам и читается Strlen(s)+1 символов. 

Тут внимательный читатель может увидеть некоторую подтасовку. В данном 
учебном примере мы знаем длину строки, которую записали в файл, и можем про- 
читать требуемое число символов. Но как быть в реальных задачах, когда мы, ско- 
рее всего, не будем знать длину записанной строки? Эту проблему можно решить 
несколькими путями. Проще всего записывать и читать весь массив символов как 
единое целое: 

fwrite(s,sizeof(s),1,F); 

fread(sl,sizeof(s),1,F); 


Этот путь простой, HO имеет один недостаток: записывается всегда весь массив 
символов $, даже если содержащаяся в нем строка много короче размера массива. 
Приведенные операторы в нашем примере эквивалентны операторам 


fwrite(s,sizeof (char)*10,1,F); 
fread(sl,sizeof(char)*10,1,F); 


Таким образом, при частичном заполнении массива в файле будут храниться 
лишние байты. Если в файле много строк разной длины, а все они будут храниться 
как максимальная из них, то размер файла будет значительно больше действи- 
тельно необходимого. 

Другой путь — записывать по-прежнему по символам, но при чтении прове- 
рять каждый символ, чтобы при появлении нулевого символа закончить чтение 
строки. Это может быть реализовано следующим образом: 


// запись строки 
fwrite(s,sizeof (char),strlen(s)+1,F); 


// чтение строки 

for(int ind = 0; ind < 10; ind++) 

{ 

Егеаа ($1+1па, sizeof (char),1,F); 
if(sl{ind] == '\0') break; 

} 

Здесь в цикле for читается за раз по одному символу и при обнаружении нуле- 
вого символа цикл прерывается. Обратите внимание, что адрес чтения очередного 
символа в данном случае задается выражением $1-+т4. Нельзя было бы вместо это- 
го использовать выражение $1119], так как функция fread требует указания 
именно адреса, а не значения переменной, в которую осуществляется чтение. 

Функцию fread в этом примере можно было бы заменить на fgetc, которая чи- 
тает один символ из потока: 


$1 [11а] = fgetc(F); 
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И, наконец, еще один вариант чтения строк неизвестной длины из двоичного 
файла. Можно перед строкой записывать в файл целое число, равное числу симво- 
лов в строке. Тогда чтение строки не встретит затруднений: 

// запись строки 

int it = strlen(s) +1; 

fwrite(&it,sizeof(int),1,F); 

fwrite(s,sizeof(char),it,F); 


// чтение строки 
fread(&it,sizeof(int),1,F); 
fread(sl,sizeof(char),it,F); 


В приведенных примерах чтение происходило последовательно. Ho, работая с 
двоичными файлами, можно организовать произвольное чтение данных. Для этого 
служит указатель (курсор) файла, который определяет текущую позицию в файле 
для чтения и записи. При чтении или записи указатель автоматически смещается 
на число обработанных байтов. Узнать позицию указателя можно функцией ftell, 
которая возвращает текущую позицию: 


long int ftell(FILE *stream) ; 


Изменить позицию указателя можно функцией fseek: 


int fseek(FILE *stream, long offset, int whence) ; 


Эта функция задает сдвиг на число байтов offset относительно точки отсчета, 
определяемой параметром whence. Параметр whence может принимать значения: 


whence [Точка отчета 
SEEKSET 10 [Начало файла 

ПР ee 
[SEEK-END р  (Кщеа 


ники 


Если задано значение whence = 1, то offset может быть положительным (сдвиг 
вперед) или отрицательным (сдвиг назад). 

Функция rewind перемещает указатель на начало файла (позиция 0). Впро- 
чем, то же самое можно сделать оператором 


Езеек (г, OL, 0); 


Возможность перемещать указатель особенно полезна в файлах, которые со- 
стоят из однородных записей одинакового размера. Например, если в файле запи- 
саны только действительные числа типа double, то для того, чтобы прочитать i-oe 
число, достаточно выполнить операторы 


Езеек (Е, sizeof (double)*(i-1), 0); 
Егеаа (ба, sizeof (double),1,F); 


Таким образом можно читать любые записи в любой последовательности. 

С помощью перемещения указателя можно редактировать записи в файле. 
Пусть, например, вы хотите одно из чисел, записанных в файле, изменить, умно- 
жив его на 10. Это можно сделать, если открыть файл в режиме чтения и записи 
(например, «rb+>»), установить позицию, соответствующую изменяемому числу, и 
выполнить операторы: 

fread(&a,sizeof (аоаю1е),1,Е); 

а; *= 10; 

fseek(F,-sizeof (double),1)4 

fwrite(é&a, sizeof (double),1,F); 
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Первый из этих операторов читает число в переменную а, второй — умножает 
его на 10. Третий оператор возвращает текущую позицию на одну запись назад, по- 
скольку после выполнения fread позиция сдвинулась вперед. Последний оператор 
пишет в ту позицию, в которой было прочитано число, новое значение. | 

Ту же задачу можно решить иначе: 


long int pos = ftell(F); // запоминание позиции 
fread(&a,sizeof (double),1,F); 

a *= 10; 

fseek(F,pos,0); // восстановление позиции 


fwrite(&a,sizeof (double),1,F); 


Здесь функция ftell запоминает позицию, из которой читается число, a функ- 
ция fseek восстанавливает эту позицию перед записью измененного числа. 
| С помощью двоичных файлов можно записывать и читать не только числа и 
строки, но и гораздо более сложные объекты, например, структуры. Ниже приве- 
ден пример, в котором определяется тип структуры зрег$, объявляются перемен- 
ные этого типа pers и persl, поля структуры pers заполняются, а затем она цели- 
ком записывается в файл. После того, как файл закрывается, он открывается для 
чтения и данные из него читаются в структуру persl. 


struct spers 

{ 
char Name[20]; 
int year; 


}; 


struct spers pers, pers]; 
strcpy (pers.Name, "Иванов"); 
pers.year = 1960; 


FILE *F; 

if ((F = fopen("Test2.dat", "wb")) == NULL) 
{ 

ЗпомМе$засе ("Файл не удается создать"); 
return; 

} 

fwrite (&pers,sizeof(spers),1,F); 

fclose(F); 

if ((F = fopen("Test2.dat", "rb")) == NULL) 


{ 
ShowMessage ("Файл не удается открыть"); 
return; 


} 
fread(&persl,sizeof(spers),1,F); 
fclose(F); 


13.9.2.4 Ввод/вывод, использующий дескрипторы 


В С предусмотрен еще один механизм работы с файлами, основанный не на 
указателях на структуру типа FILE, а на дескрипторах. Файлы, открываемые по- 
добным образом, не работают.с буферами и с форматированными данными. 

В начале работы любой программы автоматически открывается три потока со 


своими дескрипторами: 

поток ___ дескриптор | 
| 

eidin so би A стандартный входной поток — обычно клавиатура | 

Free | ree стандартный выходной поток — обычно экран | 

FeO en стандартный поток сообщений об ошибках | 
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Но программа может и явным образом открывать любые новые файлы с деск- 
рипторами. 
Функции, работающие с дескрипторами файлов, описаны в файле io.h. Ряд ис- 
пользуемых флагов и констант описан также в файлах stdio.h, {сп И.В, sys\types.h 
и sys\stst.h. 
Файл открывается функцией Open, которая возвращает дескриптор файла: 
#include <fcntl.h> 


#include<io.h> 
int open(const char *path, int access, unsigned mode) ; 


Параметр path указывает имя открываемого файла. Параметр access опреде- 
ляет режим доступа к файлу. Параметр mode является не обязательным и задает 
режим открытия файла. 

Параметр access формируется операцией ИЛИ (|) из ряда Е Вот некото- 
рые из них (полный список см. в главе 15 в разделе 15.5.1): 


O WRONLY только для записи 

O_RDWR для чтения и записи 

O_CREAT создание нового файла 

O_TRUNC если файл существует, OH урезается до 0 
O_BINARY двоичный файл 

О TEXT текстовый файл 


Параметр mode может принимать значения: 


ИИ НИНЫ, 


S_IREAD разрешение чтения 
S_IREAD | S_IWRITE разрешение записи и чтения 


Например, операторы 
int handle; 
if ((handle = open("Test.txt", О CREAT | О TEXT)) == -1) 
{ 
ShowMessage ("Файл не удается создать"); 
return; 


} 


пытаются создать новый текстовый файл, а в случае неудачи (функция Open верну- 
ла -1) отображают сообщение об ошибке. 
_ Имеется также функция _creat, осуществляющая примерно те же функции, 
что и ореп. 
Закрывается файл функцией close: 


int close(int handle); 
Запись и чтение при работе с файлами, определяемыми дескрипторами hand- 
le, осуществляется функциями write и read: 


#include <io.h> 
int write(int handle, void *buf, unsigned len); 
int read(int handle, void *buf, unsigned len); 
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В этих функциях buf — указатель на буфер, из которого записывается в файл 
или в который читается из файла len байтов. 

Чтобы продемонстрировать работу с файлами, определенными своими деск- 
рипторами, давайте воспроизведем пример, приведенный в разделе 13.9.2.3, в ко- 
тором осуществлялась запись и чтение двух целых числе i u }, действительного 
числа а и строки $: 

#include <stdio.h> 

#include <stdlib.h> ¢ 

#include <fcntl.h> 

#include <sys\stat.h> 

#include <io.h> 

#include <string.h> 


int “Lae у t SSP NLT Assy 
double a = 25e6, al; 
char 3[101, 621107; 
strcpy(s, "UBaHOB") ; 


int handle; 
// запись в файл 


if ((handle = open("Test.txt", О ИВОМЬУ | О СВЕАТ | О BINARY)) == -1) 
{ 
ЗпомМез5засве ("Файл не удается создать"); 
return; 
} 
write(handle, &i, sizeof(int)); // запись i 
write(handle, &j, sizeof(int)); // запись j 
write(handle, &a, sizeof (double) ); // запись a 
write(handle, s, strlen(s)+1); // запись строки $ 


с1о$е (handle); 


// чтение из файла 


if ((handle = open("Test.txt", О RDONLY | О BINARY)) == -1) 

{ 

ShowMessage ("Файл не удается открыть"); 

return; 
} 

read(handle, &il, sizeof(int)); // чтение i 

read(handle, &j1, sizeof(int)); // чтение 7 

read(handle, &al, $12еоЕЁ (double) ); // чтение a 

read(handle, sl, strlen(s)+1); // чтение строки $ 


close (handle); 


Если вы сравните этот код с тем, который был приведен в разделе 13.9.2.3, то 
увидите, что они практически идентичны и различаются только синтаксисом. Со- 
ответственно, и все приемы записи и чтения строк произвольной длины, рассмот- 
ренные в разделе 13.9.2.3, могут применяться и в данном случае. 

Для работы с файлами, имеющими дескрипторы, могут использоваться функ- 
ции tell и Ilseek, аналогичные рассмотренным в разделе 13.9.2.3 функциям ftell и 
fseek, производящими операции с указателями файлов. Имеются также функции 
dup и dup2, производящие операции непосредственно с дескрипторами, позволяю- 
щие создавать дубли дескрипторов или, например, перенаправлять стандартные 
потоки. Описания этих и иных функций вы найдете в главе 15 в разделе 15.5.3. 
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13.9.3 Файловый ввод/вывод с помощью потоков в стиле С++ 


13.9.3.1 Ввод и вывод потоков 
В С++ определены три класса файлового ввода/вывода: 


|ifstream входные файлы для чтения | 


| ofstream выходные файлы для записи 
stream | ato gt чтения и записи 


При работе с файлами этих классов можно использовать ряд присущих им Me- 
тодов, но, пожалуй, основным достоинством использования этих классов является 
возможность применять очень удобные операции поместить в поток (<<) и взять 
из потока (>>). 

Создаются объекты потоков, связанные с файлами, конструкторами соответст- 
вующих классов. Например, операторы 


ofstream outfile("Test.dat"); 

if (!'outfile) 

{ 

ShowMessage ("Файл не удается создать"); 
return; 


} 


создают выходной поток outfile, связанный с файлом «Test.dat», создавая одно- 
временно сам файл или, если он уже существует, урезая его длину до нуля. Если 
по каким-то причинам операция не может быть выполнена, значение Outfile равно 
0 и оператор if прерывает работу. 

Аналогично может создаваться входной поток, связанный с файлом: 


ifstream infile("Test.dat") ; 

if (!infile) 

{ 

ShowMessage ("Файл не удается открыть"); 
return; 


} 


К созданным таким образом потокам можно применять операции поместить в 
поток (<<) и взять из потока (>>), подробно рассмотренные в главе 12 в разделе 
12.7.14. Преимущество этих операций, работающих с текстовыми файлами, по 
сравнению с рассмотренными в предыдущих разделах функциями является про- 
стота использования и автоматическое распознавание типов данных. Рассмотрим, 
например, следующий код: 

int a ea '25, 11 91 

double а = 25e6, al; 


char s[40], $1[40]; 
strcpy(s,"UBaHOoB") ; 


// создание файла как выходного потока 

ofstream outfile("Test.dat") ; 

if (!outfile) 

{ 

ShowMessage("®amn не удается создать"); 

return; 

} 
8321 <<: i qc *"%. <4 <¢ 0S В... 
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// ‘закрытие файла 
outfile.close(); 


// открытие файла как входного потока 
ifstream infile("Test.dat"); 

if (!infile) 

{ 

ShowMessage ("Файл не удается открыть"); 
return; 


} 

infile >>oil: >>: jd: 2> а >> 81; 
// закрытие файла 
infile.close(); 


В этом коде создается файл «Test.dat» и в него записываются в текстовом виде 
два целых числа1и j, действительное число а и строка $, содержащая одно слово, 
после чего манипулятором потока endl (см. раздел 12.7.14 главы 12) осуществля- 
ется перевод строки. Причем, запись всех этих данных осуществляется одним опе- 
ратором, содержащим сцепленные операции поместить в поток. Если вы сравните 
это с аналогичными кодами, приведенными в предыдущих разделах, то убедитесь 
в компактности и простоте применения этой операции. | 

После того, как файл закроется, в нем будет записан текст «1 25 2.5е+07 Ива- 
нов». Дальнейшие операторы создают входной поток, связанный с этим файлом и 
одним оператором, содержащим сцепленные операции взять из потока читает все 
эти данные. 

Особенности применения операций << и >> детально рассмотрены в главе 12 в 
разделе 12.7.14. Отметим только, что возможности операции поместить в поток 
можно существенно расширить использованием манипуляторов потока, которые 
будут обсуждаться в следующем разделе 13.9.3.2. Помимо этой операции выво- 
дить данные в поток можно еще двумя способами: методом риф и методом write. 

Метод put выводит в поток один символ. Например, оператор 


outfile.put('A'); 


выведет в поток символ «Я». Функции put допускают сцепленный вызов. Напри- 
мер, оператор 


outfile.put('A').put('\n'); 


выведет в поток символ «Я» и символ перевода строки. 

Метод write выводит в файл из символьного массива, на который указывает 
его первый параметр, число символов, указанных вторым параметром. Например, 
оператор 


outfile.write(s,5); 


записывает в поток Outfile 5 символов из массива $. Причем эти символы никак не 
обрабатываются, а просто выводятся в качестве сырых байтов данных. Среди этих 
символов, например, может встретиться в любом месте нулевой символ, но он не 
будет рассматриваться как признак конца строки. 

Аналогичный метод read может затем прочитать эти символы в какой-то дру- 
гой символьный массив и тоже без всякой обработки. Функция gcount сообщает о 
количестве символов, действительно прочитанных последней операцией ввода. 

Теперь остановимся подробнее на вводе данных из файлового потока. 

Операция взять из потока (>>) обладает особенностью, которую надо учиты- 
вать при вводе строк в массивы символов. Она читает не всю строку, а только одну 
лексему — последовательность символов до первого пробельного или разделитель- 
ного символа. Иначе говоря, она читает не строку до символа перевода строки, а 
только одно слово. Это удобно, если надо производить анализ текста или искать в 
нем какое-то ключевое слово. Но это становится недостатком, если надо просто 
прочесть строку целиком. 


ae Глава 13 


В классе ifstream имеется еще два метода чтения из потока: get и getline. Me- 
тод get имеет три модификации: get(), get(char) и get(char *, int п, char delim). 

Функция get без аргументов вводит одиночный символ из указанного потока 
(даже, если это символ разделитель) и возвращает этот символ в качестве значения 
вызова функции. Этот вариант функции get возвращает EOF, когда в потоке встре- 
чается признак конца файла. 

Следующий код использует функцию get без аргумента, чтобы построчно чи- 
тать и обрабатывать весь текст файла: 

Ghar s[{80],..cs 

ifstream infile("Test.dat"); 

if (!infile) 

{ 

ShowMessage("®amn не удается открыть"); 


return; 
} \ 
neg we Oe 
while((c = infile.get()) != EOF) 
{ 
if(c == "\n') 


{ 


// занесение нулевого символа в конец строки 
$[1] = 0; 
// обработка строки 


// Формирование строки 
else $[1++] = с; 

} 
// закрытие файла 
infile.close(); 


Здесь символы файла поочередно читаются в символьную переменную с. Если 
прочитанный символ не является символом перевода строки «/п», то символ до- 
бавляется в строку $. Если же символ равен «/п», то в конец строки заносится ну- 
левой символ строка подвергается какой-то обработке, после чего начинает форми- 
роваться следующая строка. Отметим, что этот код имеет один недостаток: если 
символу конца файла не предшествует символ перевода строки, то последняя стро- 
ка оказывается без завершающего нулевого символа и остается необработанной. 
Нетрудно придумать дополнение кода, которое ликвидировало бы этот недостаток. 

Функцию get() удобно использовать для поиска в файле какого-то ключевого 
символа. Например, цикл поиска в файле символа «$» можно организовать сле- 
дующим образом: 

while((c = infile.get()) != EOF) 

if(c == '$') break; 

if(c == )'5*) 

Другой вариант функции-элемента get с символьным аргументом вводит оче- 
редной символ из входного потока (даже, если это символ разделитель) и сохраня- 
ет его в символьном аргументе. Этот вариант функции get возвращает ложь, когда 
встречается признак конца файла; в остальных случаях этот вариант функции get 
возвращает ссылку на тот объект потока, для которого вызывалась функция-эле- 
мент get. 

При использовании этого варианта функции get приведенные ранее примеры 
можно оставить практически без изменений, переписав только заголовки структур 
while: 

while(infile.get(c)) 
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Третий вариант функции-элемента #е принимает три параметра: символьный 
массив 5, максимальное число символов N и ограничитель delim (по умолчанию 
символ перевода строки ‘'\п'). Этот вариант читает символы из входного потока до 
тех пор, пока не достигается число символов, на 1 меньше указанного максималь- 
ного числа п, или пока не считывается ограничитель. Затем для завершения вве- 
денной строки в символьный массив, используемый в качестве буфера программы, 
помещается нулевой символ. Ограничитель в символьный массив не помещается, а 
остается во входном потоке (он будет следующим считываемым символом). Таким 
образом, результатом второго подряд использования функции get явится пустая 
строка, если только ограничитель не удалить из входного потока. 

Приведенный ранее пример чтения всего файла по строкам в данном случае 
реализуется проще: 

char s[80]; 

ifstream infile("Test.dat") ; 

if(!infile) 

{ 

ShowMessage ("Файл не удается открыть"); 
return; 


} 
while(!infile.eof()) 


{ 

infile.get(s, 80); 
infile.get(); 

// обработка строки 


} 
// закрытие файла 
infile.close(); 


В данном случае третий аргумент в вызове get не указан. Значит подразумева- 
ется по умолчанию ограничитель «\п» и каждый вызов get читает одну строку 
(подразумевается, что ее длина не более 80 символов). Обратите внимание на то, 
что после оператора 


infile.get(s,80); 
добавлен оператор 
infile.get(); 


Этот оператор удаляет из потока ограничитель. Если этого не сделать, про- 
грамма зациклится. 

Функция get с тремя параметрами не всегда удобна, поскольку оставляет ог- 
раничитель в потоке, и для повторного вызова функции его приходится убирать 
отдельным оператором. Часто более удобна другая функция — getline. Эта функ- 
ция действует подобно третьему варианту функции get и помещает нулевой сим- 
вол после строки в символьном массиве. Но в отличие от get функция getline уда- 
ляет символ ограничитель из потока (т.е. читает этот символ и отбрасывает его); 
этот символ не сохраняется в символьном массиве. 

С помощью getline рассмотренный выше цикл чтения файла по строкам мо- 
жет быть записан следующим образом: 


while(!infile.eof ()) 
{ 
infile.getline(s, 80); 
// обработка строки 
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13.9.3.2 Манипуляторы потоков 


В разделе 13.9.3.1 и в главе 12 в разделе 12.7.14 рассматривался один из мани- 
пуляторав потоков — манипулятор endl, переводящий поток на новую строку. 
Имеется еще много манипуляторов потока, позволяющих форматировать вывод в 
файл операцией вывода в поток <<. 

Чтобы посмотреть возможности манипуляторв, вы можете построить прило- 
жение, аналогичное рассмотренным в предыдущих разделах и содержащее окно 
Memol и кнопку, обработчик события OnClick которой имеет следующий вид: 


#include <fstream.h> 
#include <iomanip.h> 


char s[40]; 


// создание файла как выходного потока 
ofstream outfile("Test.dat") ; 
if (!outfile) 
{ 
ShowMessage ("Файл не удается создать"); 
return; 


} 


// операторы, использующие операция вывести в поток 


// закрытие файла 
outfile.close(); 


ifstream infile("Test.dat"); 
if ('‘infile) 
{ 


ShowMessage ("Файл не удается открыть"); 
return; 


} 
Memol->Clear(); 
while(!infile.eof()) 


{ 
infile.getline(s, 80); 
Memol->Lines->Add(s) ; 
} 


// закрытие файла 
infile.close(); 


Манипуляторы dec, oct, hex и зе фазе определяют систему счисления, в KOTO- 
рой выводятся целые числа — соответственно десятичную, восьмеричную, шестна- 
дцатеричную и с заданным основанием. По умолчанию целые числа выводятся как 
десятичные. Послав в поток один из перечисленных модификаторов вы можете пе- 
рейти к другой системе счисления и она будет действовать до тех пор, пока вы не 
примените новый модификатор. Модификатор setbase относится к параметризиро- 
ванным модификаторам потоков. В качестве параметра в него передается основа- 
ние системы счисления. Для применения этого и других параметризованных мо- 
дификаторов надо включить в проект заголовочный файл <iomanip.h>. Приведем 
пример использования рассмотренных модификаторов. Операторы 

int. +=: 315 

Ot ti le: << 1. <<, << Лен << <<. * Se Sat. << Re ЖЖ 

<< setbase(10) << i << endl; | 


приведутк записи текста «31 1f 37 31". Сначала число 31 отображается в десяти- 
чном виде, потом в восьмеричном, затем в шестнадцатеричная и в заключение 
опять в десятичном. 
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Можно управлять точностью выводимых чисел с плавающей запятой, т.е. чис- 
лом разрядов справа от десятичной точки, используя манипулятор потока 
setprecision или метод precision. Вызов любой из этих установок точности дейст- 
вует для всех последующих операций вывода до тех пор, пока не будет произведе- 
на следующая установка точности. 

Чтобы посмотреть возможности способов управления точностью, вы можете 
записать оператор: 

for (ant 1 Os) > <1037* 14+) 

outfile << setprecision(i) << sqrt(3.0) << endl; 

Этот оператор изменяет в цикле параметр манипулятора setprecision от 0 до 9 
и тем самым изменяет точность вывода в файл значения корня квадратного из 3. 
Значение параметра 0 приводит к установке точности по умолчанию, которая рав- 
на 6. Результат работы приведенного оператора следующий: 


. 73205 


$ 
‚23 

. 732 

. 7321 

. 73205 

. 732051 

. 7320508 

. 73205081 


+ > > > на на № + 


Аналогичный результат даст следующий код, использующий метод precision: 


for tint 2 = 0; & < 10;:-1++) 

{ 

outfile.precision (i); 

outfile << sqrt(3.0) << endl; 
} 


Если в функции precision He задавать параметров, например, 
int i = outfile.precision(); 


то она вернет текущую установку точности. 

Манипулятор потока setw и метод width устанавливают ширину поля (т.е. 
число символьных позиций, в которые значение будет выведено, или число симво- 
лов, которые будут введены) и возвращает предыдущую ширину поля. Если обра- 
батываемые значения имеют меньше символов, чем заданная ширина поля, то для 
заполнения лишних позиций используются заполняющие символы. По умолча- 
нию заполняющими символами являются пробелы и вставляются они перед знача- 
щими символами, т.е. происходит выравнивание вправо. Если число символов в 
обрабатываемом значении больше, чем заданная ширина поля, то лишние симво- 
лы не отсекаются и число будет напечатано полностью. Установка ширины поля 
влияет только на следующую операцию поместить в поток; затем ширина поля ус- 
танавливается неявным образом на 0, т.е. поле для представления выходных зна- 
чений будут просто такой ширины, которая необходима. Функция width, не имею- 
щая аргументов, возвращает текущую установку ширины поля. 

Заполняющие символы могут устанавливаться манипулятором setfill(char) 
или методом fill. 

Например, следующие операторы демонстрируют влияние ширины поля на 
результат вывода числа 25: 

ТАС + = 25; 

FOL (ant 18, OF 2 OF ae) 

outfile << setw(i) << j << endl; 
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Результат работы этих наи следующий: . 


25 
25 
25 
2 
25 


- 


Из этого результата видно, что пока ширина поля меньше числа символов в 
выводимом числе, она ни на что не влияет, а при большой ширине поля происхо- 
дит выравнивание числа вправо. 

Такой же результат дает и следующий цикл, использующие метод width: 

for(int i = 0;1 < 5; itt) 

{ 

outfile.width (i); 
outfile << j << endl; 

} 


Если вывести в поток модификатор setfill, то заполняющие символы изменят- 
ся. Например, оператор 


for{taat 1.= 0; Ех 9; i++) 
outfile << setfill('*') << setw(i) << 1 << endl; 


приведет к результату: 


#5 
25 
25 
г. 
ж*25 


Мы рассмотрели многие (но еще не все) манипуляторы потоков. Пользователи 
могут создавать собственные манипуляторы потоков. В качестве примера того, как 
это делается, ниже приводится код функции, создающей манипулятор, названный 
tab, который выводит в поток символ табуляции «\%». 


//Создание манипулятора tab 
ostreamé tab(ostreamé& output) 
{ 

return output << '\t'; 
} 


Если вы ввели в приложение такую функцию, TO в дальнейшем можете ис- 
пользовать этот манипулятор. Например, оператор 


ournfijie «<< ‘А’ << tab <<. “В! << tab. <<. *C* << endl; 


выведет символы «А», «В» и «С», разделенные символами табуляции: 
} ee ЗА + 


13.9.3.3 Флаги состояния формата 


В классе 105 — базовом классе всех потоков ввода/вывода определены следую- 
щие флаги формата. 


В а а оао ай 


ios::skipws пропуск символов разделителей во входном потоке’ 

ios::left выравнивание по левой границе поля 

ios::right выравнивание по правой границе поля 

ios::internal выравнивание знака или основания системы счисления по ле- 


вой, а числа — по правой границам поля 
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105:: dec десятичная система счисления, устанавливается манипулято- 
ром dec 

ios::oct восьмеричная система счисления, устанавливается манипуля- 
тором oct 

ios::hex шестнадцатеричная система счисления, устанавливается Ma- 


нипулятором hex 


ios::showbase вывод основания системы счисления 

ios::showpoint обязательная печать десятичной точки и нулевых младших 
разрядов 

ios::uppercase вывод в верхнем регистре символов Х и Е в шестнадцатерич- 
ном и экспоненциальном форматах 

ios::showpos вывод символа «+» перед положительным числом 

ios::scientific экспоненциальное представление действительных чисел 

ios::fived формат действительных чисел с фиксированной точкой 


Флаги состояния формата управляются методами flags, зе и unsetf, или ма- 
нипуляторами потоков setw, setiosflags и resetiosflags. 

Метод flags используется для задания сразу всех флагов. При этом те флаги, 
которые должны быть установлены, объединяются операцией поразрядного 
ИЛИ (|) в одно значение типа long, передаваемое методу как параметр. Метод 
flags возвращает значение типа long, содержащее предыдущие значения опций. 
Это значение часто сохраняется с тем, чтобы можно было впоследствии вызвать 
функцию flags с этим сохраненным значением и восстановить предыдущие значе- 
ния опций. 

Метод setf и параметризованный манипулятор потока setiosflags имеют един- 
ственный аргумент, который устанавливает один или более флагов, соединенных 
операцией |, и может использовать текущие установки флагов для создания нового 
состояния формата. Например, манипулятор 


setiosflags(ios::showpos | ios::showpoint) 


устанавливает флаги ios::showpos и ios::showpoint. 

Манипулятор потока resetiosflags и метод unsetf наоборот, сбрасывают флаги, 
которые указаны их параметром. Чтобы использовать перечисленные параметри- 
зованные манипуляторы потока, надо в приложение включить директиву 
#include <iomanip.h>. 

Приведем примеры использования перечисленных флагов состояния формата. 

Оператор, использующий флаг showpoint: 


по фт ме, 9 ri Wile xe ec at < А ре ча. ГР 
setiosflags(ios::showpoint) << 1. <<" " << 1.1 << endl; 


дает результат: 
т 4.2 2.99009’ а. ач9 


Оператор, использующий флаги right, left и internal: 


outfile << setw(6) << -1.1 << endl 
<< setw(6) << resetiosflags(ios::right) 
<< setiosflags(ios::left) << -1.1 << endl 
<< setw(6) << resetiosflags(ios::left) 
<< setiosflags(ios::internal) << -1.1 << endl; 


25 зак. 322 
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дает результат: 


at | 
> ok 
tate ЗУ 


Обратите внимание на то, что надо сбрасывать модификатором resetiosflags 
ранее установленный флаг, чтобы при каждом выводе только один из флагов right, 
left u internal был установлен. 

Оператор, использующий флаг showbase: 


ОТ << 63: << oct <<". И: << 63 кхе. кс". ПКЕ BS 
<< setiosflags(ios::showbase) << dec << endl 
<< (63° << oct: Se) букве" 248 KEES O<< ей; 


дает результат: 


oo! д К ВЫ 
63 077 Ox3f 


Обратите внимание, что флаги системы счисления устанавливаются не моди- 
фикатором setiosflags, а модификаторами dec, oct, hex. 
Оператор, использующий флаги scientific и fixed: 


outfile << "По умолчанию:" << endl 


Ce A O12 <е. Ot: eS 1.2306. 66, в091 650001 

<< "Флаг scientific:" << setiosflags(ios::scientific) 
<< endl 

<< 0.0123 << ' ' << 1.23e6 << endl << endl 


<< "Флаг fixed:" << resetiosflags(ios::scientific) 
<< setiosflags(ios::fixed) << endl 
700123 <<< 112306 <<"enal> 


дает результат: 
По умолчанию: 
0.0123 1.23е+06 


Флаг scientific: 
1.230000е-02 1.230000e+06 


Флаг fixed: 
0.012300 1230000.000000 


Обратите внимание, что по умолчанию значения чисел с плавающей запятой 
сами выбирают формат представления и он, пожалуй, наиболее привлекателен. 
Оператор, использующий флаги showpos и showpoint: 


outfile << setprecision(4) << зем (3) << 60. << endl 
<< setiosflags(ios::showpos | ios::showpoint) << 60. 
<< endl; 


дает результат: 


60 
+60.00 


В этом примере один манипулятор setiosflags устанавливает сразу два флага. 


13.10 Массивы 


13.10.1 Одномерные массивы 


Массив представляет собой структуру данных, позволяющую хранить под од- 
ним именем совокупность данных любого, но только одного какого-то типа. Мас- 
сив характеризуется своим именем, типом хранимых элементов, размером (числом 
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хранимых элементов), нумерацией элементов и размерностью. В данном разделе 
мы ограничимся одномерными массивами, т.е. массивами с размерностью 1. 
Объявление переменной как одномерного массива имеет вид: 


тип переменная [константное выражение] 
Например, ‘оператор | 
int А[ 10]; 


объявляет массив с именем А, содержащий 10 целых чисел. Доступ к элементам 

этого массива осуществляется выражением Afi], где 1 — индекс, являющийся в 

данном примере, как видно из объявления, целым числом в диапазоне 0 - 9. На- 

пример, A[O] — значение первого элемента, A[1] — второго, А] 9] — последнего. 

Обратите внимание, что индекс последнего элемента на 1 меньше размера массива. 

Это связано с тем, что индексы начинаются с 0. | 
Приведем примеры использования этого массива. Код 


А[ 0] = 1; я 
А[1] = 1; 
for(int i = 2; 1 < 1001++)САТЫ = Ali-2)}4+A fist}; 


заполняет массив так называбмыми числами Фибоначчи, первые 2 из которых 
равны 1, а каждое последующее равно сумме двух предыдущих. 
Элементы массива могут иметь любой тип. Например, предложение 


char $[10]; 


объявляет массив символов. Массив символов — это фактически строка (см. раз- 
дел 13.4.1) и сним можно во многом обращаться как со строкой, хотя можно обра- 
щаться и как с массивом. При использовании массива символов как строки надо 
только иметь в виду, что это строка фиксированной допустимой длины. И число 
символов, помещаемых в строку, не должно превышает объявленного размера мас- 
сива п-1, поскольку строка кончается нулевым символом. 

Объявление переменной массива можно совмещать с заданием элементам мас- 
сива начальных значений. Эти значения перечисляются в списке инициализации 
после знака равенства, PeSnenamrca запятыми и заключаются в фигурные скобки. 
Например: 

Int ЗО @ Г Е АМ РИ РТ. 

char $[10] = {"“abcdefghi\0")}; 


Если начальных значений меньше, чем элементов в массиве, оставшиеся эле- 
менты автоматически получают нулевые начальные значения. Например, опера- 
тор cohen. 


int А[10] = {1,2,3); | 
задает значения первым трем элементам, а остальные будут равны 0. Оператор 
int A[10] = {0}; 


присваивает нулевые значения всем элементам массива. 


POORER ORE: 


PEORIA EE IEE LEE ERE GILDA ИАА орк ELA SERS GES AGILE OG PERE ATE: 


Предупреждение 
Если массив при его бмв ений не инициализирован, то его элементы имеют случайные зна- 
чения. Элементы такого массива нельзя использовать в выражениях, пока им не будут при- 
своены какие-нибудь значения. 


В массивах символов задание нулей элементам, не указанным в списке ини- 


циализации, равносильно заданию нулевых символов, означающих конец. строки. 
Поэтому приведенное выше объявление переменной $ с ее инициализацией избы- 
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точно. Нулевой символ в конце можно не указывать. Например, нормально будут 
восприняты такие объявления: 


char $[10] = {"abcdefghi"}; 
char $1[10] = {"abc"}; 


Последнее объявление выделяет место под массив из 10 элементов, но ини- 
циализирует его строкой из трех элементов. 

В объявлении со списком инициализации размер массива можно не указы- 
вать. Тогда количество элементов массива будет равно количеству элементов в спи- 
ске начальных значений. Например, объявление 


ое Ам БН, ay. as SEs 
создает массив из пяти элементов. Объявление 
char $1[ |] = {"аьс"}; 


создает массив из четырех элементов — три значащих символа плюс нулевой сим- 
вол. 

В объявлении массива в качестве размера лучше всегда использовать имено- 
ванные константы. Например, ниже приведено объявление массива и оператор, 
подсчитывающий сумму его элементов: 

int A[10]; 

// операторы заполнения массива 


// подсчет суммы 
int Sum = А[ 0]; 
for(int $1=11;: 1 <. 10; i++) Sum += A[i}; 


Если в дальнейшем вы решите, что вам требуется массив А He из 10 элементов, 
а, например, из 100, вы должны будете изменить размер массива и в объявлении 
А, и во всех операторах, работающих с этим массивом (в данном случае в операто- 
ре for). А ведь таких операторов в разных частях программы может быть очень 
много. О такой программе говорят, что она плохо масштабируется. 

Грамотнее реализовать этот пример следующим образом: 

const Амах = 10; 

int A[Amax]; 

// операторы заполнения массива 


// подсчет суммы 
int Sum = А[0]; 
for(int 1 = 1;\1 < Amax; i++) Sum += А[1]; 


В этом случае вы вводите именованную константу Атах и используете ее BO 
всех операторах, в которых вам требуется размер массива. Тогда при необходимо- 
сти изменить размер массива вам достаточно изменить его только в одном операто- 
ре, объявляющем Атах. Программа сразу становится масштабируемой. А объяв- 
ление Атах как константы гарантирует, что объявленное значение не будет слу- 
чайно. изменено где-то в программе. 

Аналогичный результат можно получить, если заменить объявление констан- 
ты директивой компилятора #define (см. главу 12 раздел 12.2.2). 


#define Amax 10 


Хороший стиль программирования nemo 


LOSI FLOR EY ROALD LES Fp PEDIC POLI ИКАО LIPO RE PELOLLLE LR PLE AREER ALON 


Все размеры массивов ‘в программе следует определять именованными константами или 
макросами. Это делает программу более понятной и существенно облегчает ее отладку и 
сопровождение. 


Hy LER IIASA OOLEE ALESSI EAELG EPG SPSCDRPED PEA SEL LSIVSEGESAEESL SCD УЕЗД ССОРА ЛАНЧИ SARE RE ЗИК МИНИ SSEGA SESE УКАЗУ ИКОНА ИКЕА ИРИ SERA ASEDESCISEASELEE SEES PER EIOCLES AAMAS SEA SDI, 
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В ряде случаев требуются константные массивы, данные из которых програм- 
ма может только читать. Такие массивы обязательно должны инициироваться в 
момент объявления. Например: 


const AnsiString Day[] = {"понедельник", "втроник", "среда", "четверг", 
"пятница", "суббота", "воскресенье" }; 


13.10.2 Многомерные массивы 


Можно объявлять и многомерные массивы, т.е. массивы, элементами которых 
являются массивы. Например, двумерный массив можно объявить таким образом: 


int А2 [10] [3]; 


Этот оператор описывает двумерный массив, который можно представить себе 
как таблицу, состоящую из 10 строк и 3 столбцов. 

Доступ к значениям элементов многомерного массива обеспечивается через 
индексы, каждый из которых заключается в квадратные скобки. Например, 
A2[3][2] — значение элемента, лежащего на пересечении четвертой строки и 
третьего столбца (помните, что индексы начинаются с 0). 

Если многомерный массив инициализируется при его объявлении, список зна- 
чений по каждой размерности заключается в фигурные скобки. Приведенный 
ниже оператор объявляет трехмерный массив АЗ размерностью 4 на 3 на 2. 

int АЗ[4] [3] [2] = {{{0,1},{2,3},{4,5}}, 

{{6,7},{8,9},{10,11}}, 
Ааа 
L116, 29 РУС РУПЕРТ hit 


Этот оператор создает массив АЗ, четыре строки которого являются матрица- 
ми вида 


Например, элемент A3[O]{1][0] равен 2, элемент АЗ ЗО] !] равен 19 ит.д. 
Если в списке инициализации в какой-то из размерностей не хватает данных, 
то все дальнейшие не перечисленные элементы считаются равными нулям. 


13.10.3 Операции с массивами, передача массивов 
‘как параметров 


Имя массива является константным указателем на первый элемент массива. 
Взаимосвязь массивов и указателей подробно рассмотрена в разделе 13.7. Посколь- 
ку имя массива — константный указатель, оно не может модифицироваться и к 
нему не применимы все операции присваивания. 

К имени массива можно применять операцию sizeof, которая в этом случае 
возвращает значение, равное общему объему памяти, отведенному под все элемен- 
ты массива. Таким образом, число элементов массива А можно определить выра- 
жением 


sizeof(A) / 512еоЕЁ (А[0]) 
поскольку под каждый элемент массива отведен одинаковый объем памяти. 


Подобное вычисление размера массива выполняет макрос ARRAYSIZE. При- 
веденное выше выражение эквивалентно выражению 


ARRAYSIZE (А) 
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При передаче массива в функцию в качестве параметра заголовок функции Co- 
держит тип и имя массива с последующими пустыми квадратными скобками. На- 
пример, если функция Е должна принимать массив как параметр, ее прототип мо- 
жет иметь вид: 


void F(int Ar[]); 


Обращение к такой функции может быть записано так: 


const Amax = 10; 
int А[Амах]; 


F(A); 

Как видно, в вызове функции указывается просто имя массива. Внутри функ- 
ции к элементам этого массива можно обращаться обычным образом, например, 
Ат|[2]. С++ передает имя массива в функцию по ссылке (см. главу 12 раздел 
12.5.2). Это значит, что если функция изменяет значения элементов массива, то 
изменяются элементы исходного массива, который передавался в функцию. 

В большинстве случаев только имени массива мало, чтобы провести в функ- 
ции обработку его элементов. Внутри функции требуется знать размер массива, 
чтобы можно было организовать его циклическую обработку. Поэтому обычно в 


функцию передается не только массив, но и его размер. При этом заголовок функ- 
ции может иметь вид: 


void F(int Ак[], int М); 
а вызов функции: 
F(A, Amax); 


Чаще библиотечные функции требуют в качестве второго параметра не размер 
массива, а значение его последнего индекса, которое на единицу меньше размера. 
В этом случае вызов функции может иметь вид: 


F(A, Amax - 1); 


В частности, такого вызова требуют все функции Object Pascal, использующие 
так называемый открытый массив. Поскольку подобные вызовы функции встреча- 
ются довольно часто, в файле sysdefs.h определен макрос EXISTINGARRAY, ко- 
торый позволяет оформить передачу массива более компактно. При использовании 
этого макроса приведенный выше вызов можно оформить так: 


Е (EXISTINGARRAY (А)); 


При развертывании макрос EXISTINGARRAY передаст в функцию имя мас- 
сива как первый параметр и значение последнего индекса как второй параметр. 
При этом макрос использует приведенное ранее выражение для подсчета числа 
элементов массива через операцию sizeof. 

Некоторые функции Object Pascal, используемые и в C++Builder, могут вос- 
принимать в качестве параметров так называемые открытые массивы констант, в 
которых могут содержаться элементы разных типов. В файле sysdefs.h описан 
макрос OPENARRAY, позволяющий обращаться к таким функциям. Без дополни- 
тельных разъяснений приведем форму записи такого макроса: 


ОРЕМАВВАУ (ТУагВес, (элемент 1, элемент_2, ...)) 
Число передаваемых элементов может достигать 19. 
Передача массива по ссылке не гарантирует защиты от несанкционированного 


изменения программой значений элементов массива. Если необходимо защитить 
массив от подобных изменений, его надо передать в функцию как константный: 


void F(const int Ar[], int №); 


Пусть, например, вы хотите написать функцию, подсчитывающую сумму эле- 
ментов массива целых. Тогда вы можете оформить ее следующим образом: 
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int Sum(const int А[],. ре. М) / 
{ 

// М - размер массива 

int $ =А[0]; 

for(int i= 1:1 < М; i++) S += Afi]; 
return S; 


} 

Ниже приведен пример тестирования этой функции. 

#define Bmax 10 

int В10 = 61,2, 5,8. 3eOe le Se 9,20] 

ShowMessage("Cymma равна " + IntToStr(Sum(B, Bmax) )); 

При вызове функции не обязательно. передавать весь массив. Можно передать 
только какую-то его часть. Например, вы можете передать в функцию параметр 
размера массива, меньший истинного. Если вы в приведенном примере в качестве 
второго параметра передадите в функцию He Bmax, а Bmax - 2, то функция будет 
обрабатывать только восемь первых элементов с индексами от 0, до 7. Можно. и в 
качестве начала массива передать в функцию указатель на какой-то элемент мас- 
сива. Например, если вы обратитесь к функции так: 


Sum(B + 2, Bmax - 2) 


то вы передадите в нее указатель не на первый, а на третий элемент. Поэтому, ког- 
да функция будет обращаться к элементам массива от 0 до Т, в действительности 
она будет работать с элементами, индексы которых от 2 до 9. Т.е. сумма будет по- 
считана по элементам, начиная с третьего. 

Если в функцию передается многомерный массив, то в заголовке только квад- 
ратные скобки первой размерности остаются пустыми, а в скобках следующих раз- 
мерностей должны указываться константами их размеры. Например, если функ- 
ция Е2 должна принимать двумерный массив размером 3 на 3, то ее заголовок мо- 
жет иметь вид: | 


void F(const int Аг[)][3]); 


Вызов этой функции производится обычной передачей в нее имени массива. 
Например, F(A). | 


13.11 Структуры 
13.11.1 Структуры в стиле С 


Структуры — это составные типы данных, построенные с использованием дру- 
гих типов. Они представляет собой объединенный общим именем набор данных 
различных типов. Именно тем, что в‚.них могут хранится данные разных типов, 
они и отличаются от массивов, хранящих данные одного типа. 
Отдельные данные структуры называются элементами или полями. Все это на- 
поминает запись в базе данных, только хранящуюся в оперативной памяти компь- 
ютера. | 
Простейший вариант объявления структуры может выглядеть следующим о0б- 
разом: 
struct TPers { 
AnsiString Fam,Nam, Par; 
unsigned Year; 
bool Sex; 
AnsiString Dep; 

}; 
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Ключевое слово struct начинает определение структуры. Идентификатор 
TPers — тег (обозначение, имя-этикетка) структуры. Тэг структуры используется 
при объявлении переменных структур данного типа. В этом примере имя нового 
типа — TPers. Имена, объявленные в фигурных скобках описания структуры — 
это элементы структуры. Элементы одной и той же структуры должны иметь уни- 
кальные имена, но две разные структуры могут содержать не конфликтующие эле- 
менты с одинаковыми именами. Каждое определение структуры должно заканчи- 
ваться точкой с запятой. 

Определение TPers содержит шесть элементов. Предполагается, что такая 
структура может хранить данные о сотруднике некоего учреждения. Типы данных 
разные: элементы Fam, Nam, Par и Dep — строки, хранящие соответственно фа- 
милию, имя, отчество сотрудника и название отдела, в котором он работает. Эле- 
мент Year целого типа хранит год рождения, элемент Sex булева типа хранит све- 
дения о поле. Элементы структуры могут быть любого типа, но структура не может 
содержать экземпляры самой себя. Например, элемент типа ТРег$ не может быть 
объявлен в определении структуры ТРег$. Однако, может быть включен указатель 
на другую структуру типа ТРег$. Структура, содержащая элемент, который явля- 
ется указателем на такой же структурный тип, называется структурой с самоадре- 
сацией. Такие структуры очень полезны для формирования различных списков 
(см. раздел 13.11.2). 

Само по себе объявление структуры не резервирует никакого пространства в 
памяти; оно только создает новый тип данных, который может использоваться для 
объявления переменных. Переменные структуры объявляются так же, как пере- 
менные других типов. Объявление 


TPers Pers, РегзАггау [10], *Ppers; 


объявляет переменную Pers типа TPers, массив PersArray — с 10 элементами типа 
TPers и указатель Ppers на объект типа TPers. 

Переменные структуры могут объявляться и непосредственно в объявлении 
самой структуры после закрывающейся фигурной скобки. В этом случае указание 
тега не обязательно: 


stract: { 
AnsiString Fam,Nam, Par; 
unsigned Year; 
bool Sex? 
AnsiString Dep; 
}Pers, PersArray[10], *Ppers; 


Для доступа к элементам структуры используются операции доступа к элемен- 
там: операция точка (.) и операция стрелка (->). Операция точка обращается к эле- 
менту структуры по имени объекта или по ссылке на объект. Например: 


Pers.Fam = "Иванов"; i 
Pers.Nam = "Иван"; 
Pers.Par = "Иванович"; 


Pers.Year 1960; 
Pers.Sex = true; 
Pers.Dep = "Бухгалтерия"; 


Операция стрелка обеспечивает доступ к элементу структуры через указатель 
на объект. Допустим, что выполнен оператор 


Ppers = &Pers; 


который присвоил указателю Ppers адрес объекта Pers. Тогда указанные выше 
присваивания элементам структуры можно выполнить так: | 


Ppers->Fam = "Иванов"; 
Ppers->Nam = "Иван"; 
Ppers->Par = "Иванович"; 
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Ppers->Year = 1960; 
Ppers->Sex true; 
Ppers->Dep = "Бухгалтерия"; 


13.11.2 Самоадресуемые структуры 


Теперь рассмотрим еще один вид структур — самоадресуемые структуры. Не- 
редко в памяти надо динамически размещать (см. главу 12 раздел 12.9) последова- 
тельность структур, как бы формируя некий фрагмент базы данных, предназна- 
ченный для оперативного анализа и обработки. Поскольку динамическое размеще- 
ние проводится в непредсказуемых местах памяти, то такие структуры надо снаб- 
дить элементами, содержащими указатели на следующую аналогичную структу- 
ру. Такие структуры со ссылками на аналогичные структуры и называются само- 
адресуемыми. Ниже приведена схема связи таких структур в последовательность. 
Полю указателя в последней структуре обычно присваивается значение NULL, что 
является признаком последней структуры при организации поиска в списке. 


Рис. 13.1 
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Если мы хотим структуру, рассмотренную в разделе 13.11.1, сделать самоад- 
ресуемой, следует изменить ее объявление следующим образом: 


struct TPers { 
AnsiString Fam,Nam, Par; 
unsigned Year; 
bool Sex; 
AnsiString Dep; 
TPers * pr; 

}; 


Приведем пример формирования в памяти списка таких структур. Для этого 
надо определить три переменные, являющиеся указателями на структуры: 


TPers *РО = NULL, *Pnew, *Pold; 


Первая из этих переменных будет всегда указывать на первую структуру в 
списке. Две остальные переменные — вспомогательные. Если в некоторый момент 
возникла необходимость динамически разместить в памяти очередную структуру и 
вставить ее в конец списка, это можно сделать следующим кодом: 


// Выделение памяти под новую структуру 
Pnew = new TPers; 


// Заполнение элементов структуры 
Pnew->Fam = "O>BRT>"; 

Pnew->Nam "O>BR"; 

Pnew->Par "O>BRT>P) "; 
Pnew->Year = 1960; 

Pnew->Sex = true; 

Pnew ->Dep = "Бухгалтерия"; 
Pnew->pr = NULL; 


if (PO == NULL) PO = Pnew; // PO - указатель на первую структуру 
else Pold->pr = Pnew; // указатель на очередную структур 
Pold = Pnew; 
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Если список еще не начат (PO = NULL), то указателю РО присваивается ссыл- 
ка на вновь размещенную структуру (Рпем). В противном случае ссылка на новую 
структуру присваивается полю pr предыдущей структуры в списке (Pold). Таким 
образом новая структура включается в общий список. Полю рг этой структуры 
присваивается значение NULL. Это является признаком того, что данная структу- 
ра является последней в списке. 

Сформировав список. в памяти далее легко его просматривать, проходя в цик- 
ле по указателям. Например: 


Pnew = PO; 

while(Pnew != NULL) 

{ 

ShowMessage(Pnew->Fam + " " + Pnew->Nam + " " + Pnew->Par) ; 
Pnew =. Pnew->pr; // переход к новой структуре 


} 


‚ Легко также делать в. списке перестановки структур, их удаление и т.п. Для 
всех этих.операций не надо ничего перемещать в памяти. Достаточно только изме- 
‘нять соответствующие ссылки'в полях pr. 

Раньше подобные списки широко использовались для создания в памяти сте- 
‘ков, очередей и других упорядоченных списков. Однако, в C++Builder введены 
специальные типы данных ТЫ $ и TStringList, которые ведут подобные списки и 
имеют множество удобных методов для управления ими. Изучите эти типы, рас- 
смотренные в главе 16. 


13.11.3 Структуры в стиле С++ 


Все, что рассмотрено в предыдущих разделах, относится как к языку С, так и 
к С++. Но в С++ понятие структуры существенно расширено и приближено к по- 
нятию класса (см. раздел 13.13). 

В частности, в структурах кроме рассмотренных ранее данных-элементов раз- 
решается описывать функции-элементы. Рассмотрим это на примере использован- 
ной в предыдущих разделах структуры TPers. Давайте введем в эту структуру 
функцию-элемент Show, отображающую информацию, хранящуюся в структуре: 

struct ТРегз { 

AnsiString Fam,Nam, Par; 

unsigned Year; 

bool Sex; 

AnsiString Dep; 

Tr@ers * pr; ь 

void Show() Sey 

{ 

: showNes Sage.{ " Co™py Abas отдела \""+Dep+"\" "+Fam+" "+Nam+" "+ 
rare; зоо (rear) +": Tap," пол 7+ 
(Sex ? "мужской" : "менскый! is 

} 

}; 

Функция Show отображает информацию вида: «Сотрудник отдела «Бухгалте- 
рия» Иванов Иван Иванович, 1960 r.p., пол мужской». 

Обращение к этой функции-элементу производится через переменную струк- 
туры операцией точка или через указатель на переменную операцией стрелка. На- 
пример: 

Pers.Show(); 

Pnew->Show() ; 


6 использованием введенной функции Show приведенный в разделе 13.11.2 
пример просмотра списка можно упростить: 
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Рпем = РО; 
while(Pnew != NULL) 
{ 

Pnew->Show(); 

Pnew = Pnew->pr; 


} 


В С++ можно вводить спецификаторы доступа к данным-элементам и функци- 
ям-элементам так же, как это делается в классе. Разрешаются спецификаторы 
public (открытый) и private (закрытый). Закрытые элементы структуры могут 
быть доступны только для функций-элементов этой структуры. Ни через объект, 
ни через указатель на объект доступ к ним невозможен. Закрытыми объявляются 
какие-то вспомогательные данные-элементы, не представляющие интереса для 
пользователя, а также вспомогательные функции (утилиты), требующиеся для ра- 
боты основных функций-элементов структуры. 

Открытые элементы структуры могут быть доступны для любых функций в 
программе. Основная задача открытых элементов состоит в том, чтобы дать клиен- 
там структуры представление о возможностях, которые она имеет. Это открытый 
интерфейс структуры. 

По умолчанию доступ к элементам структуры public — открытый. Если вам 
надо спрятать от пользователя какие-то элементы, укажите спецификатор private, 
завершающийся двоеточием, и помещайте после него объявления закрытых эле- 
ментов. Все, что помещено после спецификатор private до конца структуры или до 
спецификатора public, будет скрыто от пользователя. Например, в следующем 
объявлении структуры 

struct MyStr { 

int ‘ny; iy} 

int Get(); 
private: 

int a, №; 

void F(); 
}; 


данные хиуи функция Get — открытые и могут использоваться при работе со 
структурой, а данные а и b u функция Е — закрытые и ими может пользоваться 
только функция Get. 

Есть еще ряд особенностей, сближающих в С++ структуры и классы. Они бу- 
дут рассмотрены в разделе 13.13, посвященном классам. 


13.11.4 Битовые поля 


Язык Си++ предоставляет возможность задавать количество битов, в которых 
хранятся элементы типов unsigned или int структуры (а также класса и объедине- 
ния — см. разделы 13.13 и 13.12). Такие элементы называются битовыми полями. 
Битовые поля позволяют рационально использовать память с помощью хранения 
данных в минимально требуемом количестве битов. 

В структуре TPers, использовавшейся в предыдущих разделах, можно, напри- 
мер, сократить затраты на хранение года рождения и пола сотрудника. Если ориен- 
тироваться на даты до 2047 года, то для хранения года рождения достаточно 11 би- 
тов. Если вы рассчитываете, что ваша программа просуществует дольше, то можете 
даже выделить под год 12 битов — этого хватит на ближайшие две тысячи лет. А 
под хранение сведений о поле вполне достаточна 1 бита. Таким образом, под эти два 
элемента вам достаточно 2 байтов, а в описанной ранее версии структуры под эти 
элементы отводилось 5 байтов: 4 под год плюс один под пол. Выигрыш 3 байта. Ко- 
нечно, немного, но если при выполнении вашей программы в памяти формируются 
списки из тысяч структур, то такой выигрыш уже может быть заметен. 
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При объявлении битового поля вслед за указанием типа элемента ставится 
двоеточие (:) и пишется целочисленная константа, задающая ширину поля (т.е. 
число битов, в которых хранится этот элемент). Ширина поля должна быть цело- 
численной константой в диапазоне между 0 и заданным общим числом битов, ис- 
пользуемых для хранения целого значения типа int в вашей системе. Например: 

Struct TPers { 


AnsiString Fam,Nam, Par; 
AnsiString Dep; 


TPers, * pry 
unsigned ae a ae Oe 
bool Зах 3-.13 


та 


Можно задавать неименованное битовое поле. Такое поле используется в 
структуре как заполнение. Дело в том, что при работе с битовыми полями надо 
учитывать длину машинного слова. Если следующий элемент структуры не явля- 
ется битовым полем, то место его хранения должно начинаться с нового машинно- 
го слова. Для округления объемов памяти до слова, т.е. для заполнения оставших- 
ся неиспользованными битов и вводятся неименованные битовые поля. В приве- 
денном ниже примере неименованное поле шириной в 3 бита используется как за- 
полнение: 


struct Example { 


unsigned a : 13; 
unsigned i aad 
unsigned b ; 4; 


}; 


Можно использовать неименованное битовое поле нулевой ширины, которое 
воспринимается как указание выровнять следующее битовое поле по границе ново- 
го элемента памяти. 
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Манипуляции с битовыми полями являются машинно-зависимыми. Например, в некоторых 
компьютерах битовые поля могут пересекать границы машинного слова, тогда как в других 
компьютерах это недопустимо. 
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13.12 Объединения 


Объединение (union) — это область памяти, в которой в разные моменты вре- 
мени могут находиться объекты разных типов. В любой момент времени объедине- 
ние может содержать максимум один объект, потому что элементы объединения 
совместно используют одну и ту же область памяти. На программиста возлагается 
обязанность следить за тем, чтобы к данным в объединении обращались по имени 
элемента соответствующего типа данных. Если тип ссылки на элемент объедине- 
ния не соответствует типу данных, хранящемуся в этот момент в объединении, то 
возникает ошибка, последствия которой зависят от реализации системы. 

В разные отрезки времени выполнения программы некоторые объекты могут 
быть не нужны, т.е. программе требуется только часть ее объектов. Вместо того, 
чтобы впустую растрачивать память на объекты, которые используются не посто- 
янно, можно поместить их в объединение, где они будут делить между собой одну 
и ту же область памяти. Число байтов памяти, выделяемых для объединения, 
должно быть не меньше, чем размер самого большого элемента объединения. 
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Предупреждение 
Не всегда объединение может быть легко перенесено на другие компьютерные платформы. 
Перенесется ли объединение, или нет, часто зависит от соглашений о выравнивании в памя- 
ти типов данных элементов объединения. Так что использование объединений снижает моби- 
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Объединения объявляются при помощи ключевого слова uNniON в таком же 
формате, как структуры и классы (см. разделы 13.11.1 и 13.13). Например: 

union Tunion { 

int т? 
double d; 
char * в; 

}; 

Это объявление создает тип объединения с именем Tunion, которое хранит в 
одной и той Же области памяти или целое значение i, или действительное значе- 
ние 4, или указатель на строку $. 

Само по себе объявление объединения создает новый тип, но не объект. В даль- 
нейшем для использования объединения надо объявить переменную этого типа, 
например: 

Tunion М; 


К элементам переменной типа объединения можно обращаться так же, как к 
элементам структуры или класса. Например, вы можете записать операторы: 


N.i = 5; 

NG: Sole 

char *S = "объединение"; 
N.s = $; 


Но учтите, что при использовании объединения вам надо все время знать, ка- 
кое значение вы занесли в эту переменную последней операцией присваивания. 
Если, например, вы выполнили первый из приведенных выше операторов, а затем 
обратились к элементу 4, то вы получите бессмысленное значение. А если вы по 
ошибке обратились в этом случае к элементу $, то вас ждут крупные неприятности, 
поскольку неизвестно, на что будет указывать $. 
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Предупреждение 
Использование объединений позволяет экономить ресурсы, но существенно усложняет про- 
граммирование и затрудняет отладку. Так что решайте, что вам важнее, и не увлекайтесь из- 
лишне объединениями. 
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13.13 Классы 


13.13.1 Объявление класса 


Класс — это тип данных, определяемый пользователем. То, что в C++Builder 
имеется множество предопределенных классов, не противоречит этому определе- 
нию — ведь разработчики C++Builder тоже пользователи С++. Понятия класса, 
структуры (см. раздел 13.11) и объединения (см. раздел 13.12) в С++ довольно 
близки друг к другу. Поэтому почти все, что будет далее говорится о классах, при- 
менимо также к структурам и объединениям. 
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Класс' должен быть объявлен до того, как будет объявлена хотя бы одна пере- 
менная этого класса. Т.е. класс He может объявляться внутри объявления перемен- 
ной. Ses Ses | м 

Синтаксис объявления класса следующий: 
class <имя класса> : <список классов - родителей» 


{ 


pubi ies); // доступно всем 
<данные, методы, свойства, события> 
__ published // видны в Инспекторе Объекта и изменяемы 
<данные, свойства> 
protected: // доступно только потомкам 
<данные, методы, свойства, события> 
private: // доступно только в классе 


<данные, методы, свойства, события> 
} <список переменных>; 


Например: д 


class MyClass : public Classl, Class2 

| 

public: 

MyClass(int = 0); 
void SetA(int); . и | 
int СесА (уо1а); 

private: 

int FA; 

double B, C; 
protected: 

int F(int); 

}; 

Имя класса может быть любым допустимым идентификатором. Идентифика- 
торы классов, наследующих классам библиотеки компонентов C++Builder, приня- 
то начинать с символа «Т». 

Класс может наследовать поля (они называются данные-элементы), методы 
(они называются функции-элементы), свойства, события от других классов — сво- 
их предков, может отменять какие-то из этих элементов класса или вводить но- 
вые. Если предусматриваются такие классы-предки, то в объявлении класса после 
его имени ставится двоеточие и затем дается список родителей. В приведенном 
выше примере предусмотрено множественное наследование классам Classl и 
Class2. Если среди классов-предков встречаются классы библиотеки компонентов 
C++Builder или классы, наследующие им, то множественное наследование запре- 
щено. | 
Если объявляемый класс не имеет предшественников, то список классов-роди- 
телей вместе с предшествующим двоеточием опускается. Например: 


class MyClassl 
{ 


}; 


Доступ к объявляемым элементам класса определяется тем, в каком разделе 
они объявлены. Раздел public (открытый) предназначен для объявлений, которые 
доступны для внешнего использования. Это открытый интерфейс класса. Раздел 
published (публикуемый) содержит открытые свойства, которые появляются в 
процессе проектирования на странице свойств Инспектора Объектов и которые, 
следовательно, пользователь может устанавливать в процессе проектирования. 
Раздел private (закрытый) содержит объявления полей`и функций, используемых 
только внутри данного класса. Раздел protected (защищенный) содержит объявле- 
ния, доступные только для потомков объявляемого класса. Как и в случае закры- 
тых элементов, можно скрыть детали реализации защищенных элементов от ко- 
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нечного пользователя. Однако, в отличие от закрытых, защищенные элементы ос- 
таются доступны для программистов, которые захотят производить от этого класса 
производные классы, причем не требуется, чтобы производные классы объявля- 
лись в этом же модуле. 

В приведенном выше примере через объект данного класса можно получить 
доступ только к функциям MyClass, SetA и GetA. Поля РА, В, С и функция F — 
закрытые элементы. Это вспомогательные данные и функция, которые использу- 
ют в своей работе открытые функции. Открытая функция MyClass с именем, сов- 
падающим с именем класса, это так называемый конструктор класса, который 
должен инициализировать данные в момент создания объекта класса. Присутст- 
вие конструктора в объявлении класса не обязательно. При отсутствии конструк- 
тора пользователь должен сам позаботиться о задании начальных значений дан- 
ным — элементам класса. 

Перед именами классов-родителей в объявлении класса также может указы- 
ваться спецификатор доступа (в примере public). Смысл этого спецификатора TOT 
же, что и для элементов класса: при наследовании public (открытом наследовании) 
можно обращаться через объект данного класса к методам и свойствам клас- 
сов-предков, при наследовании private подобное обращение невозможно. Подроб- 
нее этот вопрос рассмотрен в разделе 13.13.5. 

По умолчанию в классах (в отличие от структур) предполагается специфика- 
тор private. Поэтому можно включать в объявление класса данные и функции, не 
указывая спецификатора доступа. Все, что включено в описание до первого специ- 
фикатора доступа, считается защищенным. Аналогично, если не указан специфи- 
катор перед списком классов-родителей, предполагается защищенное наследова- 
ние. 

Объявления данных-элементов (полей) выглядят так же, как объявления пе- 
ременных или объявления полей в структурах: 


<тип> <имена полей>; 


В объявлении класса поля запрещается инициализировать. Для инициализа- 
ции данных служат конструкторы, о которых упоминалось выше и которые рас- 
сматриваются подробно в разделе 13.13.4. 

Объявления функций-элементов в простейшем случае не отличаются от обыч- 
ных объявлений функций (см. главу 12 раздел 12.5.1). 

После того, как объявлен класс, можно создавать объекты этого класса. Если 
ваш класс не наследует классам библиотеки компонентов C++Builder, то объект 
класса создается как любая переменная другого типа простым объявлением. На- 
пример, оператор 


MyClass МС, МС10[10], *Pmc; 


создает объект МС объявленного выше класса MyClass, массив MC10 из десяти 
объектов данного класса и указатель Ртс на объект этого класса. 

В момент создания объекта класса, имеющего конструктор, можно инициали- 
зировать его данные, перечисляя в скобках после имени объекта значения данных. 
Например, оператор 


MyClass МС (3); 


не только создает объект МС, но и задает его полю FA значение 3. Если этого не 
сделать, то в момент создания объекта поле получит значение по умолчанию, ука- 
занное в содержащемся в объявлении класса прототипе конструктора. 

Создание переменных, использующих класс, можно совместить с объявлени- 
ем самого класса, размещая их список между закрывающей класс фигурной скоб- 
кой и завершающей точкой с запятой. Например: 
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Если создается динамически размещаемый объект класса (cM. главу 12, раз- 
дел 12.9), то это делается операцией new. Например: 


MyClass *PMC = new MyClass; 


или 
MyClass *РМС1 = new MyClass (3); 


Эти операторы создают где-то в динамически распределяемой области памяти 
сами объекты и создают указатели на них — переменные РМС и РМС1. 

Создание объектов класса простым объявлением переменных возможно толь- 
ко в случае, если среди предков вашего класса нет классов библиотеки компонен- 
тов C++Builder. Если же такие предки есть, то создание указателя на объект этого 
класса возможно только операцией new. Например, если класс объявлен так: 


class MyClass2 : public TObject 
{ 


}; 
то создание указателя на объект этого класса может осуществляться оператором 
MyClass2 *Р2 = new MyClass2; 


13.13.2 Функции-элементы, дружественные функции, 
константные функции 


Поля данных, исходя из принципа инкапсуляции (см. главу 1 раздел 1.2), все- 
гда должны быть защищены от несанкционированного доступа. Доступ к ним, как 
правило, должен осуществляться только через функции, включающие методы чте- 
ния и записи полей. В этих функциях должна осуществляться проверка данных 
чтобы не записать случайно в поля неверные данные или чтобы не допустить их не- 
верной трактовки. 

Поэтому данные всегда целесообразно объявлять в разделе private — закры- 
том разделе класса. В редких случаях их можно помещать в protected — защи- 
щенном разделе класса, чтобы возможные потомки данного класса имели к ним 
доступ. 


a 
Хороший стиль программирования еее ооо ооо ото 


Как правило, делайте данные-элементы класса защищенными, снабжая их при необходимо- 
сти открытыми функциями чтения и записи. Функции записи позволят вам проверять записы- 
ваемые данные и обеспечивать тем самым непротиворечивость данных. А функции чтения 
позволят вам не переписывать программу, даже если вы решили изменить что-то в типе, спо- 
собах хранения и размещения данных в классе. 
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Приведем пример. Пусть класс имеет следующее объявление: 


class MyClass 
{ 


public: 
void SetA(int); // Функция записи 
int GetA(void); // Функция чтения 
private: 
int FA; 


double B, C; 
}; 


Типы данных в языке С++ | 785 


Реализация функций записи и чтения может иметь вид: 


void MyClass::SetA(int Value) 
{ 
eee // проверка корректности данных 
КА = Value; 


} 


ynt MyClass::GetA(void) {return FA; } 


В данном случае функция чтения просто возвращает значение поля, HO в более 
сложных классах может потребоваться какая-то предварительная обработка дан- 
ных. Обратите внимание, что все описания функций-элементов содержат ссылку 
на класс с помощью операции разрешения области действия (::). 

В приведенном примере объявление класса содержит только прототипы функ- 
ций, а их реализация вынесена из описания класса. Для простых функций реали- 
зация может быть размещена непосредственно в объявлении класса. Например: 


class MyClass 
{ 


public: 
MyClass(int = 0); | 
void SetA(int Value) {FA= Уа1ае;}; // Функция записи 
int GetA(void) {return FA;}; // функция чтения 
private: 
int FA; 


double B, C; 

}; 

Функции, описание которых содержится непосредственно в объявлении клас- 
са, в действительности являются встраиваемыми функциями inline (см. главу 12, 
раздел 12.5.6, в котором обсуждаются достоинства и недостатки таких функций). 

Введение описания функций в объявление класса — это плохой стиль про- 
граммирования: следует избегать смешения открытого интерфейса класса, содер- 
жащегося в его объявлении, и реализации класса. Если уж вы хотите реализовать 
встраиваемые функции, то лучше поместить в объявлении класса их прототип со 
спецификатором inline: 


inline void SetA(int) ; // Функция записи 


и отдельно дать реализацию функции. При этом в реализации спецификатор inline 
не указывается. 


~ 


Объявления классов следует размещать в заголовочном файле модуля, а реализацию функ- 

ций — элементов в отдельном файле реализации. При этом в объявлении класса должны со- 

держаться только прототипы функций. Это следует из принципа скрытия информации — од- 
ного из основных в объектно-ориентированном программировании. Такая организация про- 
граммы обеспечивает независимость всех модулей, использующих заголовочный файл с объ- 
явлением класса, от каких-то изменений в реализации функций-элементов класса. 


У О О А НЫ ОВ Оо С С ао 


Функции-элементы класса имеют доступ к любым другим функциям-элемен- 
там и к любым данным-элементам, как открытым, так и закрытым. Клиенты 
класса (какие-то внешние функции, работающие с объектами данного класса) име- 
ют доступ только к открытым функциям-элемен гам и данным-элементам. Но в не- 
которых случаях желательно обеспечить доступ ‹ закрытым элементам для функ- 
ций, не являющихся элементами данного класса. Это можно сделать, объявив со- 
ответствующую функцию как друга класса с помощью спецификации friend. Ha- 
пример, если в объявление класса включить оператор 


friend void IncFA(MyClass *); 
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то функция IncFA, не являясь элементом данного класса, получает доступ к его за- 
крытым элементам. Например, функция IncFA может быть описана где-то в про- 
грамме следующим образом: 


void IncFA(MyClass *P) {P->FA++;} 


Дружественными могут быть не только функции, HO и целые классы. Напри- 
мер, вы можете поместить в объявление своего класса оператор 


friend С]а$$1; 


и все функции-элементы класса Classl получат доступ к закрытым элементам ва- 
шего класса. 

Иногда программист может захотеть создать объект вашего класса как кон- 
стантный с помощью спецификатора const. Например: 


const Classl МС] (3); 


Если при этом ваш класс содержит не только функции чтения, HO и записи 
данных, то реакция на такой оператор, введенный пользователем, зависит от вер- 
сии и настройки компилятора. Компилятор может выдать сообщение об ошибке и 
отказаться от компиляции, а может просто выдать предупреждение и проигнори- 
ровать спецификатор пользователя const. Если же ваш класс содержит только 
функции чтения, то все должно бы быть нормально. Но компилятор подойдет к 
этому чисто формально и все равно выдаст предупреждение, а может и отказаться 
компилировать программу. 

Чтобы избежать этого, можно объявить функции чтения как константные. 
Для этого и в прототипе, и в реализации после закрывающей список параметров 
круглой скобки надо написать спецификатор const. Например, вы можете вклю- 
чить в объявление класса оператор 


int GetA(void) const; 
а реализацию этой функции оформить как: 
int, MyClass::GetA(void) const {return РА; } 


Тогда неприятные замечания компилятора о константных объектах исчезнут. 


SATE Re: 


PPAR LI LCTESL DELLE EE ALLEN OIA A ARE AES FEISE 
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Если предполагается, что объект вашего класса может быть объявлен константным, снаб- 
жайте все функции-элементы класса, предназначенные для чтения данных, спецификаторами 
const. 


$5: 


Ник ЗИК 


LRA ЖИ TOLLE BLIGE ЗАУР СЕМ ИЮН ОИК, 


13.13.3 Данные-элементы, статические данные, 
константные данные 


Теперь рассмотрим несколько подробнее данные-элементы. Обычно каждый 
объект класса имеет свою собственную копию всех данных-элементов класса. Но в 
определенных случаях во всех объектах класса должна фигурировать только одна 
копия некоторых данных. Например, это может быть счетчик числа созданных 
объектов класса. 

Единственную копию данных полезно иметь и во многих иных случаях. На- 
пример, если в классе имеются некоторые константы, одинаковые для всех объек- 
тов класса, то нерационально хранить в каждом объекте собственные копии этих 
констант. Рациональнее иметь единственные экземпляры этих констант для всех 
объектов. 

Для введения в класс подобных данных используются статические данные, 
кг `орые содержат информацию «для всего класса». Объявление статических эле- 
ментов в классе начинается с ключевого слова Static. Например: 
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Static int D; 


WARE SOMES MRE CE LOT SL RE IIE LIE LICE LES LIE ELLE ыы 
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Данные, общие для всех объектов класса, надо объявлять как статические данные-элементы. 

Это сократит затраты памяти и гарантирует единство данных во всех объектах: 

Статические элементы могут быть открытыми, закрытыми или защищенны- 
ми (protected). Доступ к открытым статическим элементам класса возможен по- 
средством любого объекта класса или посредством имени класса с помощью бинар- 
ной операции разрешения области действия. Например: 


MyClass::D = 10; 


LEHR ФИ ЗК REGRESS НУЮ ИФИКА DENG SOLERISED МУ КФК ИФ НИИ ОКР LRA SE ALA LEREPC EEL CREREP AER НК SE SCENE REA PCED ALG 4 ИЕ 


Закрытые и защищенные статические элементы класса должны быть доступ- 
ны открытым функциям-элементам этого класса или друзьям класса. 

Статические элементы класса существуют даже тогда, когда не существует ни- 
каких объектов этого класса. В этом случае доступ к открытому статическому эле- 
менту обеспечивается так же, как указано выше: с помощью имени класса и би- 
нарной операции разрешения области действия. Для обеспечения. доступа в OTCYT- 
ствие объектов к закрытому или защищенному элементу класса должна быть пре- 
дусмотрена открытая статическая функция-элемент, которая должна вызываться 
с добавлением перед ее именем имени класса и бинарной операции разрешения об- 
ласти действия. 

Начальные значения статических элементов (как открытых, так и закрытых) 
должны задаваться вне объявления класса. Для этого достаточно разместить 
где-то в файле, например, после объявления класса или среди реализаций функ- 
ций-элементов (но не внутри их) оператор вида 


int MyClass::D = 0; 


ых 


Предупреждение 
Статическим данным-элементам можно задать начальные значения один и только один раз в 
области действия файл. Если вы нигде не инициализировали статический элемент данных, бу- 
дет выдано сообщение компилятора о неразрешенной внешней ссылке и программа не. бу- 
дет скомпилирована. Если вы дважды инициализируете/статический элемент, будет выдано 
сообщении о дублировании инициализации и ‚проги также не ®: будет скомвивировано. 


Приведем пример, и каний все сказанное относительно статических 
данных-элементов: 


class MyClass 


{ 
public: | 
static ‘int’ De 
static int GetD1 (void); 


private: 
static int .Dl; 


}; 

int MyClaSs::GetD1(void) {return 11;} 
int MyClass::D = 0; 

int МуС1а$$::01 = 1; 


В этом примере имеются два статических элемента данных: открытый р и за- 
крытый 01. Если пользователь должен иметь возможность получать значение за- 
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крытой статической переменной D1, то должна быть предусмотрена функция ее 
чтения, названная в примере GetD1. Она должна быть объявлена открытой 
(public) и статической (co спецификатором static). Статической может быть объяв- 
лена любая функция, работающая только со статическими данными. 

После объявления класса в примере расположена реализация функции GetD1. 
В реализации не требуется указывать спецификатор static. Далее приведены пред- 
ложения, инициирующие открытые и закрытые статические данные. На этом все, 
связанное с объявление и инициализацией статических данных завершается. В 
дальнейшем вы можете из любой внешней функции обращаться к ним с помощью 
операции разрешения области действия. Например: 


MyClass::D; 
MyClass::GetD1(); 


i 

2 

Среди данных — элементов могут быть объявлены именованные константы. 
Например: 


static const int МахА = 10; 
const int MinA; 


Значения статических именованных констант могут задаваться в момент их 
объявления в классе, как показано в предыдущем примере. Инициализация неста- 
тических констант — вопрос более сложный, связанный с построением конструк- 
торов. Он рассматривается в разделе 13.13.4. 


13.13.4 Конструкторы и деструкторы 


Остановимся теперь на конструкторах класса. Прежде всего отметим, что на- 
личие конструктора в классе не обязательно. Но если конструктор отсутствует, то 
клиенты класса (внешние функции, использующие класс) должны сами заботить- 
ся 06 инициализации данных, т.е. о задании им некоторых начальных значений. 
Это не всегда возможно. Например, если класс имеет закрытые данные, предназна- 
ченные только для чтения, то для этих данных не предусматриваются открытые 
функции записи. И клиент не в состоянии присвоить данным какие-то начальные 
значения. 

Конструктором класса называется открытая функция-элемент, которая вызы- 
вается в момент создания объекта класса и должна инициализировать данные ука- 
занными в вызове значениями или значениями по умолчанию. Конструктор имеет 
то же имя, что и сам класс. . 

Пример объявления и реализации конструктора: 


class MyClass 


{ 
public: 

MyClass(void); // конструктор класса 
private: 

int A; 


}; 


MyClass::MyClass(void) {А = 0;} 


В этом примере объявлен конструктор MyClass без параметров, который при 
создании объекта задает начальное значение поля А равным 0. Обратите внимание 
на то, что в отличие от других функций в объявлении конструктора не указывает- 
ся тип возвращаемого значения. 
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Простое задание в конструкторе значений данных в общем случае не гаранти- 
рует их целостность. Обычно нужна еще проверка допустимости данных. Напри- 
мер, если в классе есть. функция записи SetA, осуществляющая такие проверки, 
то лучше обратиться к ней и при задании начального значения. В этом случае pea- 
лизация конструктора может иметь вид: 


MyClass::MyClass(void) { SetA(0); } | 

Создание объекта описанного класса MyClass в программе должно осуществ- 
ляться или объявлением соответствующей переменной: 

MyClass MC; 


или динамическим размещением переменной в памяти: 
MyClass *PMC = new MyClass; 


В момент выполнения каждого из этих операторов неявным образом вызыва- 
ется конструктор, устанавливающий начальные значения данных. 

Недостатком конструкторов показанного типа является то, что все начальные 
значения данных задаются в них конструктором. Вызывающая функция никак не 
может вмешаться в этот процесс и задать какое-то другое значение. 

Другой крайностью являются конструкторы, в которых все начальные значе- 
ния задаются как параметры. Например, прототип конструктора может иметь вид 


МуС1а$$ (int); 
а его реализация: 
MyClass::MyClass(int a) { SetA(a); } | 
В этом случае поле FA инициализируется параметром, передаваемым в конст- 
руктор. Создание объекта подобного класса должно выполняться операторами 
MyClass МС (1); 


или 
MyClass *РМС = new МуС1аз$ (1); 


в которых подразумевается, что начальное значение поля FA должно быть равно 1. 
Такой конструктор обычно тоже неудобен, поскольку в классе может быть 
много параметров и задавать значения их всех при создании объекта очень гро- 
моздко и чревато ошибками. 
Чаще всего используются конструкторы с параметрами по умолчанию (см. 
главу 12 раздел 12.5.4). В этом случае объявление конструктора может иметь вид: 


MyClass(int = 0); 
а его реализация: 

MyClass::MyClass(int а) { SetA(a); } 

Объект такого класса можно создавать любым из приведенных ранее операто- 
ров создания объекта. Если при создании указывается аргумент, то его значение 
присваивается полю. Если аргумент не указывается, то присваивается значение по 


умолчанию (в нашем примере 0). Этот вариант конструктора наиболее гибкий. По- 
этому он чаще всего используется при построении классов. 


SEGRE EL OES ELE LEE LLL LEE О на 


Хороший стиль программирования ------- 
Как правило, в классе надо предусматривать конструктор с параметрами по умолчанию. 


В объявлении класса могут быть определены не только поля переменных, HO и 
некоторые именованные константы. Например: 


Е УИ ОСИ РИСКИ ОУН ОЧКО НИИ ИЕН 


const int MaxA; 
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Подобная константа может служить, в частности, предельно допустимым зна- 
чением поля FA. 

Если такая константа объявлена как статическая (см. раздел 13.13.3), то в ее 
объявление в классе можно непосредственно включить инициализацию: 


Static const int МахА = 10; 


Но тогда это значение клиент при желании не сможет изменить. А задать зна- 
чение такой константы в конструкторе невозможно, поскольку компилятор не раз- 
решает присваивать значения константам. Выходом из положения является спе- 
циальный синтаксис конструктора с инициализатором элементов. Инициализа- 
тор элементов записывается после заголовка конструктора в его реализации, пред- 
варяется двоеточием и содержит имена константных данных, после которых в 
скобках указываются их значения. Например, если в объявлении вашего класса 
MyClass имеются строки 


const int MaxA; 
const int MinA; 


вводящие две константы — максимальное и минимальное значения переменной А, 
то реализацию конструктора такого класса с описанным ранее прототипом 
MyClass(int = 0); 
надо дополнить инициализатором элементов: 
MyClass::MyClass(int а) : МахА (10), MinA(1) {SetA(a);}; 
В данном случае инициализатор задает константе МахА начальное значение 
10, а константе MinA — значение 1. 
Можно предоставить пользователю возможность изменять значения констант 


в момент создания объекта. В этом случае в конструкторе с умолчанием надо пре- 
дусмотреть для констант соответствующие значения по умолчанию: 


MyClass(int А = 0, int МахА = 10, int MinA = 1); 
или 
MyClass(int = 0, int = 10, int = 1); 
(второй вариант менее удобен, так как не позволяет по прототипу функции понять, 


в какой последовательности должны задаваться параметры). 
Тогда реализацию конструктора можно оформить так: 


MyClass: :МуС1а$$ (11$ a, int i, int 7) : МахА (1), MinA(j) { SetA(a); } 


Создание объектов такого типа может осуществляться, например, такими опе- 
раторами: 


MyClass MC; // умолчание: А = 0, MaxA = 10, МПА = 1 
MyClass MC(20); // задано: А = 20, МахА = 10, MinA = 1 
MyClass МС (20,15); // задано: А = 20, МахА = 15, МПА = 1 
MyClass МС (20,15,2); // задано: А = 20, МахА = 15, МПА = 2 


Теперь остановимся на деструкторах. Это специальные функции-элементы, 
срабатывающие при уничтожении динамически размещенного объекта класса и 
освобождающие занимаемую им память. Имя деструктора совпадает с именем 
класса, но перед ним записывается символ тильда (-). Как и для конструктора, в 


деструкторе не указывается возвращаемый тип. Например: 
Class MyClass 


{ 
public: 
~MyClass(); // деструктор класса 


}; 
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Деструкторы необходимы, если конструктор или какие-то функции-элементы 
класса динамически распределяют память, создавая в ней какие-то объекты. Тогда 
деструктор должен эти объекты удалять. В остальных случаях можно обычно 
обойтись без деструктора. 

Если деструктор явным образом в классе не объявлен, компилятор сам генери- 
рует необходимые коды освобождения памяти. 


13.13.5 Наследование и полиморфизм, виртуальные функции, 
абстрактные классы 


При описании нового класса, производного от какого-то одного или несколь- 
ких базовых классов, можно добавлять новые функции-элементы и данные-эле- 
менты, сохраняя при этом все элементы родителей, а можно родительские элемен- 
ты переопределить или перегрузить. В производном классе доступны открытые и 
защищенные элементы базового класса (прямого или косвенного предшественни- 
ка). Закрытые элементы базового класса в производном классе недоступны. 

Производный класс может наследоваться от базового класса как public, 
protected или private (см. синтаксис такого наследования в разделе 13.13.1). За- 
щищенное и закрытое наследования встречаются редко и каждое из них нужно ис- 
пользовать с большой осторожностью. 

При порождении класса как public открытые элементы базового класса стано- 
вятся открытыми элементами производного класса, а защищенные элементы базо- 
вого класса становятся защищенными элементами производного класса. Закрытые 
элементы базового класса никогда не бывают доступны для производного класса. 

При защищенном наследовании открытые и защищенные элементы базового 
класса становятся защищенными элементами производного класса. При закрытом 
наследовании открытые и защищенные элементы базового класса становятся за- 
крытыми элементами производного класса. При закрытом и защищенном наследо- 
ваниях не справедливо отношение, что объект производного класса является объ- 
ектом базового класса. 

В целом доступ к элементам базового класса из производного класса можно 
представить следующей таблицей. 


| Tam васледовашия 


| Спецификатор 
| доступа к эле- 
| ментам в базо- 
| вом классе 


public 


открытое наследова- 
ние 


public в производ- 
ном классе 


Может быть досту- 
пен непосредственно 
любым нестатиче- 
ским функциям-эле- 
ментам, дружествен- 
ным функциям и 
функциям, не явля- 
ющимся элемента- 


protected 


защищенное насле- 
дование 


protected в произ- 
водном классе 


Может быть досту- 
пен непосредственно 
любым нестатиче- 
ским функциям-эле- 
ментам и дружест- 
венным функциям. 


private 


закрытое наследо- 
вание 


private в производ- 
ном классе 


Может быть досту- 
пен непосредствен- | 
но любым нестати- 
ческим функци- 
ям-элементам и 
дружественным 
функциям. 
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protected 


protected в произ- 


водном классе 


| private 


Может быть досту- 
пен непосредственно 
любым нестатиче- 
ским функциям-эле- 
ментам и дружест- 
венным функциям. 


невидим в производ- 
ном классе 


Может быть досту- 
пен нестатическим 
функциям-элемен- 
там и дружествен- 
ным функциям че- 
рез открытые или 
защищенные функ- 
ции-элементы базо- 
вого класса. 


protected в произ- 
водном классе 


Может быть досту- 
пен непосредственно 
любым нестатиче- 
ским функциям-эле- 
ментам и дружест- 
венным функциям. 


невидим в производ- 
ном классе 


Может быть досту- 
пен нестатическим 
функциям-элемен- 
там и дружествен- 
ным функциям че- 
рез открытые или 
защищенные функ- 
ции-элементы базо- 


вого класса. 


private в производ- 
ном классе 


Может быть досту- 
пен непосредствен- 
но любым нестати- 
ческим функци- 
ям-элементам и 
дружественным 
функциям. 


невидим в произ- 
водном классе 


Может быть досту- 
пен нестатическим 
функциям-элемен- 
там и дружествен- 
ным функциям че- 
рез открытые или 
защищенные фун- 
кции-элементы ба- 
зового класса. 


Если в классе-наследнике переопределить функцию-элемент (ввести новую 
функцию с тем же именем), то для объектов этого класса новая функция отменит 
родительскую. Если обращаться к объекту этого класса, то вызываться будет но- 
вая функция. Если все-таки нужно вызвать именно функцию базового класса, 
надо использовать операцию разрешения области действия. 

Пусть, например, вы создали класс форм Shape: 

class Shape 

{ 

public: 

void Draw (void) ; 


$ о 
и наследующий ему класс кругов Circl: 


class Circl 
{ 


public: 
void Draw(void); 
}; 
в каждом из классов объявили метод рисования Draw, а затем в программе выпол- 
нили операторы 


public Shape 


Shape *PQ1 = new Shape; 
PQ1->Draw(); // вызов Draw класса Shape 
Circl *PQ2 = new Circl; 
PQ2->Draw(); // вызов Draw класса Circl 
PQ2->Shape: :Огам (); // вызов Draw класса Shape 
((Shape *)PQ2)->Draw(); // вызов Draw класса Shape 


В комментариях к коду указано, функции Draw каких классов вызывают эти 
операторы. Как видно, если мы обращаемся через указатель к самому объекту 
типа Circl, то вызывается переопределенная в нем функция. Но если мы обраща- 
емся к нему как к объекту базового класса (последний из приведенных операторов) 
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или соответствующим образом используем prepaitass разрешения области, TO вы- 
зывается функция базового класса. 

Если бы в классе-наследнике Cirel отсутствовала функция Draw, то все приве- 
денные операторы вызывали бы функцию базового класса. 

Таким образом, механизм наследования позволят использовать функции базо- 
вого класса или переопределять их. 

Теперь рассмотрим другую задачу. Пусть мы имеем несколько классов, насле- 
дующих Shape: Circl (круг), Rectangle (прямоугольник), Square (квадрат) и т.п. 
Каждый из этих классов имеет свою функцию Draw, которая умеет рисовать COOT- 
ветствующую форму. Мы хотим работать с объектами этих фигур, как с объектами 
базового класса Shape, не разбираясь в истинной природе каждого объекта. И при 
этом хотим, чтобы программа сама понимала, что это за объект и как его рисовать. 
Например, мы хотим создать массив указателей на объекты различных форм: 


Shape *ShapeArray([10]; 
загрузить его указателями на объекты разных фигур: 


ShapeArray[0] = new Circl; 
ShapeArray([1] new Rectang; 
ShapeArray[2] = new Square; 


и затем в цикле выполнять рисование этих фигур: 
for(int.i = O¢ 1< 3}. 14+) | 
ShapeArray[i]->Draw() ; 

Рассмотренный ранее механизм наследования такую задачу решить не может. 
Поскольку ко всем объектам мы обращаемся через тип их базового класса Shape, 
то только функция этого класса и будет вызываться. 

Поставленную задачу полиморфизма позволяют решить виртуальные функции. 
Они не связаны с другими функциями с тем же именем в классах — наследниках. 
Если в классах — наследниках эти функция переопределены, то при обращении к 
такой функции во время выполнения будет вызываться та из виртуальных функций 
с одинаковыми именами, которая соответствует классу объекта, указанного при вы- 
зове. Поэтому, если в базовом классе Shape объявить функцию Draw как виртуаль- 
ную, то задача будет решена и каждая фигура будет рисоваться своей функцией. 

Синтаксически это оформляется следующим образом. В базовом классе Shape 
функция объявляется следующим образом: 


virtual void Draw(void); 


И это все! Если функция была однажды объявлена виртуальной, она остается 
виртуальной и во всех классах наследниках. Таким образом для решения задачи 
полиморфизма хватило одного спецификатора virtual. Правда, обычно предпочи- 
тают для большей ясности программы в классах-наследниках тоже вводить специ- 
фикатор virtual, чтобы была ясна суть этих функций для тех, кто будет строить 
наследников данного класса. Но с точки зрения языка С++ это не обязательно. 

Иногда в базовом классе определяют чистую виртуальную функцию (абст- 
рактную функцию). Это функция, для которой не указана реализация. Для того, 
чтобы определить такую функцию, достаточно указать, что ее тело равно нулю: 


virtual void Draw(void) =0; 


В нашем примере именно Tak целесообразно объявить функцию Draw в базо- 
вом классе Shape, поскольку непонятно, как можно нарисовать просто абстракт- 
ную фигуру. Реализация для чистой полиморфной функции не пишется. 

Класс, в котором имеется хоть одна чистая виртуальная функция, называется 
абстрактным. Для абстрактного класса невозможно создать объект. Такие клас- 
сы предназначены только для построения на их основе конкретных классов-на- 
следников. 
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13.13.6 Особенности классов, наследующих классам 
библиотеки компонентов C++Builder — 


13.13.6.1 Свойства 


О некоторых особенностях построения классов, наследующих класса \! библио- 
теки компонентов C++Builder, уже говорилось ранее. К этим особенно ям OTHO- 
сится невозможность для таких классов множественного наследованихл :! необхо- 
димость создавать объекты только с помощью операции new. Теперь ос^ановимся 
на других особенностях, связанных с понятиями свойства и события. 

Понятие свойства (property), объединяет поле данных и функции (методы) его 
записи и чтения. В рассматриваемых классах сами поля объявляются как обычно, 
но, как правило, в разделе private. Традиционно идентификаторы полей совпада- 
ют с именами соответствующих свойств, но с добавлением в качестве префикса 
символа 'Е”. 

Свойство объявляется оператором вида: 

__ property <тип> <имя> = {геаа=<имя поля или метода чтения> 

write=<umMaA поля или метода записи> 


<директивы запоминания 
и значения по умолчанию>; 


Если в разделах read или write этого объявления записано имя поля, значит 
предполагается прямое чтение или запись данных. 

Если в разделе read записано имя метода чтения, то чтение будет осуществ- 
‚ ляться только функцией с этим именем. Функция чтения — это функция без пара- 
метра, возвращающее значение того типа, который объявлен для свойства. Имя 
функции чтения принято начинать с префикса Get, после которого следует имя 
свойства. 

Если в разделе write записано имя метода записи, то запись будет осуществ- 
ляться только процедурой с этим именем. Процедура записи — это процедура с од- 
ним параметром того типа, который объявлен для свойства. Имя процедуры запи- 
си принято начинать с префикса Set, после которого следует имя свойства. 

Если раздел write отсутствует в объявлении свойства, значит это свойство 
только для чтения и пользователь не может задавать его значение. 

Директивы запоминания определяют, как надо сохранять значения свойств 
при сохранении пользователем файла формы .dfm. Чаще всего используется ди- 
ректива 


default <значение по умолчанию> 


Она не задает начальное значение. Это дело конструктора. Директива просто 
говорит, что если пользователь в процессе проектирования не изменил значение 
свойства по умолчанию, то сохранять значение свойства не надо. 

Приведем пример. Пусть требуется объявить класс с именем MyClass, насле- 
дующий непосредственно TObject и имеющий свойство целого типа с именем А. 
Тогда объявление этого класса может иметь вид: 


class MyClassl : public TObject 
{ 
private: 

int FA; 
protected: . 

void _fastcall SetA(int); // функция записи 
published: 

__ property int A = {read = FA, write = SetA, default = true}; 
}; | 


Здесь вводится закрытое поле FA, объявляется защищенная функция SetA, 
используемая для записи значения в это поле, и вводится опубликованное свойст- 
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во А, оперирующее этим полем. В объявлении свойства после ключевого слова 
read записано просто имя поля. Это означает, что функция чтения отсутствует и 
пользователь может читать непосредственно значение поля. После ключевого сло- 
Ba write следует ссылка на функцию записи SetA, с помощью которой будут запи- 
сываться в поле А новые значения. В этой функции можно предусмотреть какие-то 
проверки допустимости вводимого значения А. 

Описание этой функции может иметь вид: 


void _fastcall MyClass1::SetA(int Value) 


if(...) FA = Value; 


В приведенном примере описание свойства А помещено в раздел published. 
Следовательно, если этот класс описывает создаваемый вами новый компонент, то 
после его установки в систему свойство А будет появляться в окне Инспектора 
Объектов при использовании этого компонента. Если перенести объявление свой- 
ства в раздел public, то свойством по-прежнему можно будет пользоваться, HO 
только во время выполнения приложения, поскольку в окне Инспектора Объектов 
оно появляться не будет. Если удалить из определения свойства слово write с по- 
следующей ссылкой на функцию записи, то свойство станет свойством только для 
чтения, т.к. изменить его непосредственно будет невозможно. | 

Для свойств типа массивов приведенный ранее оператор __ property изменяет- 
ся следующим образом: 

__ property <тип> <имя> <список размерностей> = 

{геаа=<имя поля или метода чтения> 
write=<umMaA поля или метода записи> 


<директивы запоминания 
и значения по умолчанию>; 


‘Список размерностей представляет собой последовательность квадратных ско- 
бок, в которых записывается тип размерности и может записываться идентифика- 
тор. Приведем в качестве примера возможный выриант описания класса матриц 
действительных чисел размером М x М: 

// Класс матриц действительных чисел 
class Matrix 


{ 
float *data; 


int N; // число строк 

int М; // число столбцов 
public: 

Matrix(int,int); 

~Matrix( ) { delete[ ] data; } 


__ property float Items [int i] [int j].= 
{ read=GetItems, write=SetItems }; 
private: | 
float fastcall GetItems(int i, int j); 
void _fastcall SetItems(int i, int j, float value); 
}; 


Matrix::Matrix(int п, int м) // конструктор 
{ 
data = new float [п*м]; // создание экземпляра класса 
for(int i = 0; i < n*m; i++) // инициализация 
data[i] = 0.; 
М = п; 


М = m; 
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void  fastcall Matrix::SetItems(int i, int j, float value) 


{ 


a: запись значения value в элемент (1,7) 


Е ((1<1) | 1.(i>N) 11 (3<1) 11 (3>М)) 
ЗпомМеззаае ("Недопустимые индексы (" + IntTostr (i) + 
nS MT HET SS tr (9p? SoU 8) 7 
else data[(i-1) * M+ j3- 1] = value; 


} 


float fastcall Matrix::GetItems(int i, int j) 
{ 


// чтение значения элемента (1,7) 


if ((1<1) || (1>М) 11 (3<1) 11 (5>М)) 
ShowMessage("Henonyctumpie индексы (" + IntToStr(i) + 
pe”: SRC TOOL АВ ый 9 
else return data[(i-1) * M+ - 1]; 


} 


В приведенном коде создается класс матриц Matrix. Класс имеет открытое 
свойство Items, к которому можно обращаться как к двумерному массиву. Об этом 
говорит его определение в операторе __ property: float Items [int i] [int j]. Указание 
в списке размерностей идентификаторов i и } не является обязательным. Список 
мог бы иметь вид: [int] [int]. 

Задание размерностей изменяет вид функций чтения и записи. В функцию 
чтения GetItems передаются два целых параметра, определяющих индексы читае- 
мого элемента матрицы. В приведенном примере индексы матриц отсчитываются 
от 1, а не от нуля, что, вероятно, более удобно пользователю. В функцию записи 
SetItems помимо записываемого значения Value также передаются индексы того 
элемента, в который должно быть записано это значение. 

Создание экземпляра матрицы в программе может, осуществляться, напри- 
мер, оператором: 


Matrix x(4,5); 


Этот оператор создает матрицу х размерностью 4x5. Запись и чтение элемен- 
тов матрицы в программе осуществляется через свойство Items. Например: 


x.Items[2] [3] = 1.5; 
float у = x.Items[2] [3]; ' 


Первый из этих операторов заносит значение 1,5 в 3-ий элемент 2-ой строки, а 
второй оператор читает это значение. 

Дополнительные примеры описания свойств при создании нового класса см. в 
главе 7 в разделе 7.3.3. 


13.13.6.2 События ` 


Событие — это специальное свойство, являющееся указателем функции. В 
C++Builder тип обобщенного указателя на функцию, которой передается один па- 
раметр типа TObject (обычно this), — TNotifyEvent. Подобный тип используется в 
C++Builder для событий типа OnClick и многих других, которые передают в обра- 
ботчик только один параметр — TObject *Sender. Если требуется ввести в класс 
подобное событие, достаточно определить в объявлении класса соответствующее 
поле и метод работы с ним. Например: 


private: 
TNotifyEvent FMyEvent; 
__ published: 


_ property TNotifyEvent MyEvent = {read= FMyEvent,write= FMyEvent}; 
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Остается только вызвать в нужный момент обработчик событий пользователя, 
если пользователь его предусмотрел. Проверка, имеется ли обработчик пользовате- 
ля, осуществляется проверкой соответствующего события как булевой величины, 
возвращающей true, если пользователь предусмотрел свой обработчик. Значит, 
при возникновении события надо проверять, имеется ли обработчик пользователя, 
и, если имеется, то вызывать его. Для этого можно использовать оператор вида: 


if (ЕМуЕуеп®) OnMyEvent (this) ; 


Функция OnMyEvent, которая вызывается этим оператором, это и есть обра- 
ботчик пользователя. Его имя совпадает с именем свойства, перед которым добав- 
ляется префикс «Оп». 

Место, куда надо включать подобный оператор, зависит от вида события. Если 
событие вызывается каким-то из ваших методов, то вызов обработчика пользовате- 
ля надо осуществлять из этого метода. Если событие связано с какими-то сообще- 
ниями, поступающими от других приложений или от Windows, то надо предусмот- 
реть обработчик соответствующего сообщения (это подробно рассмотрено в главе 6 
в разделе 6.3.3) и из него вызывать обработчик пользователя. 

Если в обработчик события надо передать какие-то параметры помимо this, то 
тип функции TNotifyEvent уже не подходит и надо объявить свой собственный 
тип. Это объявление делается с помощью ключевого слова ___<юозиге. Например: 


typedef void _fastcall (__closure *TMyEvent) 
(System: :TObject *Sender, boolé MyParam) ; 


class T : public TObject 
{ 
private 
TMyEvent FMyEvent; 
published 
_ property TMyEvent FMyEvent = {read= FMyEvent, write= FMyEvent}; 


} 


Примеры объявления и использования событий вы можете посмотреть в главе 
7 в разделе 7.3.5. 

Выше было рассмотрено введение в класс какого-то нового события. Если же 
вам надо переопределить одно из традиционных событий, связанных с клавиату- 
рой, мышью и т.п., то это можно сделать, переопределив соответствующий стан- 
дартный обработчик родительского класса. 


13.13.7 Шаблоны классов 


C++ позволяет определять шаблоны классов, называемые также родовыми 
(generic) классами или генераторами классов. Иногда их называют параметризо- 
ванными типами, так как они имеют один или большее количество параметров 
типа, определяющих настройку шаблона класса на специфический тип данных 
при создании объекта класса. 

Для того, чтобы использовать шаблонные классы, программисту достаточно 
один раз описать шаблон класса. Каждый раз, когда требуется реализация класса 
для нового типа данных, программист, используя простую краткую запись, сооб- 
щает об этом компилятору, который и создает исходный код для требуемого клас- 
са. 

Шаблоны классов задаются аналогично шаблонам функций (см. раздел 12.5.8 
главы 12). Описание шаблона отличается от описания класса первой строкой 


template <class идентификатор> class имя класса 


В этой строке идентификатор является произвольным именем формального 
типа, который используется далее в описании шаблона. Например: 


Ee eee +) мази п XM apes 


template <class T> class :Matrix Ух 
{ 
у 
ae Этот заголовок объявляет о создании шаблона класса Matrix и задает иденти- 
фикатор Т для формального типа данных. Этот идентификатор следует использо- 
вать в описании класса вместо указания типа соответствующих данных. Приведем 


в качестве примера шаблон класса матриц, аналогичных классу, описанному в 
разделе 13.13.6.1. 


// Шаблон класса матриц 
-template <class T> class Matrix 


{ 


T *data; 

int N; // число строк 

int М; // число столбцов 
public: 


Matrixtint, int); 
~Matrix( ) { delete[ ] data; } 
. property..T. Item {int i]. [int 3] = 
{ read=GetItem, write=SetItem }; 
private: | 
т. .‘fastcall GetItem(int 1, int 4); 
void  fastcall SetItem(int 1, int j, T value); 


}3 


// конструктор 
template <class T> Matrix МАХ (int n,- int №) 
{ 


data = new T[n*m]; 


for(int 1 =O; i < п: i++) 
data[i] = 0; 

N = n; 

М = m; 


template <class T> void _ fastcall 
Matrix ::SetItem(int i, int j, T value) 
{ 


// запись значения value в элемент (1,7) 


if ( (1<1) 11 (i>N) 11 (3<1) 11 (3>™)) 
ShowMessage ("Недопустимые индексы (" + IntToStr(i) + 
eyo PRETOSEE (4) 7) Fh 
else data[(i - 1) * + ) - 1] = value; 


} 


template <class T> Т _ fastcall 
Matrix >::GetItem(int i, int 3) 

{ 
// чтение значения элемента (i,j) 

if ((i<1) 11 (1>м№) 1) (3<1) 11 (3>М)) 

ShowMessage ("Недопустимые индексы (" + IntToStr(i) + 
не” "> ВЕТОЗ ЕЕ (3d) hi BW) ye 
else return data((i - 1) *М+)3-1}; 


} 


Если вы сравните этот код с приведенным ранее в разделе 13.13.6.1, то увиди- 
те, что основное отличие заключается в замене типа float, который использовался 
в разделе 13.13.6.1, на формальный тип Т. Благодаря этому в самом шаблоне не 
указывается действительный тип хранимых данных. И при создании конкретного 


Типы данных в языке С++ 799 


экземпляра класса можно будет задавать любой тип: целый, действительный, ком- 
плексный и т.п. Другое отличие приведенного кода от рассмотренного в раз- 
деле 13.13.6.1 заключается в форме ссылок заголовков элементов-функций на 
шаблон класса. 

Создание экземпляра матрицы конкретного типа в программе может, осущест- 
вляться, например, оператором: 


Matrix<float> x(4,5); 


Этот оператор создает матрицу х действительных чисел размерностью 4 x 5. 
Отличие от приведенного в разделе 13.13.6.1 аналогичного оператора заключается 
в том, что после имени класса в угловых скобках указывается тип, для которого 
создается экземпляр класса. Компилятор заменит на этот тип (в данном случае 
float) формальный тип Т, использованный в описании шаблона. 

Запись и чтение элементов матрицы в программе осуществляется точно так 
же, как в разделе 13.13.5.1, через свойство Items. Например: 

x. items[{2] [3] = 1.5; 

float у = x.Items[2]) [3]; 


Первый из этих операторов заносит значение 1,5 в 3-ий элемент 2-ой строки, a 
второй оператор читает это значение. 
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Справочные данные 
по интегрированной среде 
разработки C++Builder 


14.1 Структура меню C++Builder 5 
14.1.1 Меню файлов File 


Меню файлов используется для открытия, сохранения, закрытия и печати но- 
вых или существующих проектов и файлов, а также для добавления новых форм и 
модулей в открытый проект. Меню имеет следующие разделы. 


New — создать новый объект из элементов Депозитария 


Создаваемый объект может быть любым элементом Депозитария (хранилища) 
объектов, включая новый проект. После выбора этого раздела меню появляется 
диалоговое окно New Items, которое позволяет выбрать вид элемента начиная OT 
окна и кончая сервером Web. Вы можете также воспользоваться услугами различ- 
ных Мастеров (Wizard) по созданию проектов и форм. Вид окна New Items вы Mo- 
жете увидеть на ряде рисунков в главе 2 и в главе 7. Там же обсуждаются вопросы 
работы с этим окном и заимствования проектов и форм из Депозитария. | 

Окно New Items имеет четыре предопределенных страницы, содержание кото- 
рых вы не можете изменять: 


АИК ИО ПИЛИ И И у ИА aa: ae ИХ 


New Страница стандартных. заготовок проектов и их элементов 
ActiveX Страница активных форм и компонентов ActiveX 
Multitier Страница компонентов для CORBA (Common Object Request Broker 


Architecture — стандарта построения приложений с распределен- 
ными объектами), MTS (Microsoft transaction server) и автоматных 
серверов 


Your project Страница, на которую автоматически заносятся все формы вашего 
текущего проекта 


Содержание остальных страниц может изменяться пользователем (см. раз- 
дел 7.4 главы 7). При поставке C++Builder в Депозитарии имеются дополнитель- 
ные страницы: 


ЗВ PLL PERI LE CE ERE BG SIE LT BEE LN I RE BEET REE ROC EO BTS, LE LBL EI RE ИНАЯ EE IER EIR REN Se SN EE И кН 


Forms Примеры различных форм, которые можно использовать как 3a- 
готовки для многих ваших приложений 


Dialogs Диалоговые окна различного назначения 


Data Modules Модули данных 


26 Зак 322 


802 3 taupe: ыы ТАава, 38 

Projects Проекты различного вида, которые могут служить прототипами 
для ваших разработок 

Business Мастера, облегчающие разработку ряда. форм специального назна- 
чения 

Основные элементы страницы New: 

ЖИРОВ И С И С ОНА АА АИ GEESE Е ВАЛА АЕ КО БОЕ Ф АЛИНА te Big! 

Application Создание нового приложения (файлов .cpp, „Ви .bpr) 

Batch file Создание командного файла .bat 

C File Создание программы Ha языке С. Если выбрать этот элемент, не 

открывая проект, то создастся проект программы на С 
Component Создание нового компонента 


Console Wizard 


Control Panel 
Application 


Control Panel 
Module 


CPP File 


Data Module 


DLL Wizbid 
Form 

Frame 
Header File 
Library 

MFC Wizard 


Package 
Project Group 
Report 


Resource DLL 
Wizard 


Text 
Unit 


Web Server 
Application 


Создание консольного приложения, работающего в окне DOS и 
использующего Win32 


Создание приложения, размещающего свою пиктограмму в окне 
«Панель управления» 


Создание нового модуля приложения, созданного ранее элемен- 
том Control Panel Application 


Создание программы Ha языке С++. Если выбрать этот элемент, 
не открывая проект, то создастся проект программы на С++ 


Создание и включение в проект нового модуля данных для свя- 
зи с базой данных. Позволяет графически документировать и 
визуально проектировать структуру модуля 


Создание новой библиотеки DLL 

Создание и включение в проект новой формы 
Создание и включение в проект нового фрейма 
Создание нового заголовочного файла .h 
Создание библиотеки 


Создание проекта, совместимого с Microsoft foundation classes 
(МЕС) 


Создание нового пакета 
Создание новой группы проектов 


Создание и включение в проект формы для разработки отчетов 
QuickReport. Имеется также элемент QuickReport Wizard на стра- 
нице Business, который позволяет решать аналогичную задачу в 
диалоге. 


Мастер DLL ресурсов, используемый при интернационализации 
приложения 


Создание текстового документа ASCIL . 
Создание и включение в проект нового модуля без формы 


Создание нового сервера Web 


Справочные данные по интегрированной среде разработки С++ВиЙдег = 803 


New Application — создать новый проект 


Если у вас в данный момент не открыт ни один проект или текущее состояние 
открытого проекта уже сохранено на диске, C++Builder закроет текущий проект и 
создаст новый. Это подразумевает создание новой пустой формы, нового файла ее 
модуля, соответствующего заголовочного файла и файла проекта. Если имеется не 
закрытый проект, то предварительно будет задан вопрос о его сохранении. ‹. 

По умолчанию новый проект создается с пустой формой. Но при настройке Де- 
позитария (см. раздел 14.2.3) вы можете изменить это, задав в качестве проекта по 
умолчанию какой-то из проектов, хранящихся в Депозитарии. 


New Form — создать новую форму 


По умолчанию будет создана новая пустая форма, в отличие от специальных 
форм, имеющихся в. Депозитарии объектов. Но при настройке Депозитария (см. 
раздел 14.2.3) вы можете изменить это, задав в качестве формы по умолчанию ка- 
кую-то форму из хранящихся в Депозитарии. 


New Frame — создать новый фрейм 


Данная команда создает и включает в текущий проект новый фрейм (см. раз- 
дел 3.7.8). 


Ореп — открыть существующий модуль, проект или текстовый файл 


В этом разделе можно открыть модуль, проект или текстовый файл. Если от- 
крывается модуль, то он появляется в окне Редактора Кода, становится видима 
связанная с ним форма, но в проект этот модуль не включается. Это можно исполь- 
зовать для просмотра каких-то модулей из других проектов, в частности, из по- 
ставляемых с C++Builder многочисленных примеров. Аналогично загружается в 
Редактор Кода открываемый текстовый файл. Закрыть открытый в окне Редакто- 
ра Кода модуль или текстовый файл можно щелчком правой кнопки мыши и выбо- 
ром команды Close Раде. При открытии проекта потребуется закрыть и при жела- 
нии сохранить ранее открытый проект. 


Open Project — открыть существующий проект или группу 


Этот раздел позволяет открыть существующий проект или группу проектов. 
Если вы открываете проект (файл .bpr), а в этот момент у вас открыт другой про- 
ект, то текущий проект закроется и откроется новый. То же произойдет, если вы 
откроете группу проектов (файл .bpg). Если у вас открыта группа проектов, TO OT- 
крытие нового проекта заменит проекты, содержащиеся ранее в группе. 


Reopen — открыть проект или модуль, с которыми работали раньше 


Этот раздел является списком нескольких последних проектов или файлов, 
которые вы открывали ранее. Чтобы открыть файл, содержащийся в этом списке, 
достаточно просто выделить его в списке. Это проще и быстрее, чем пользоваться 
разделами меню File | Open. Правда, еще проще воспользоваться соответствующей 
быстрой кнопкой (см. таблицу 2.1 в разделе 2.2.3). 


базе — сохранить текущий модуль 


На диске сохраняется текущий модуль, с которым вы работаете в окне Редак- 
тора Кода. Если ранее этот модуль уже был сохранен, то команда Save сохраняет 
его без дополнительных запросов под тем же именем. Если же он еще не сохранял- 
ся на диске, то команды Save работает как команда Save As, предлагая вам стан- 


дартный диалог Windows для задания имени сохраняемого файла. 


804 it? Глава 14 


Сохранение модуля означает не только сохранение файла .cpp, HO и всех фай- 
лов связанной с ним формы, ресурсов и т.п. 


Save Аз — сохранить текущий модуль под новым именем 


°При выборе этого раздела открывается стандартное диалоговое окно, которое 
позволяет сохранить текущий модуль под новым именем. Вы можете захотеть сде- 
лать это, если собираетесь вносить радикальные изменения во фрагмент кода. Это 
позволяет вам сохранить изменения и при необходимости вернуться к прежнему 
коду, если вы сделали ошибку в новом. Вы можете также для этих целей использо- 
вать Borland TeamSource (см. раздел 2.4.4.2), если эта система включена в вашу вер- 
сию C++Builder. 


Save Project As — сохранить текущий проект под новым именем 


При выборе этого раздела меню открывается стандартное диалоговое окно, ко- 
торое позволяет сохранить текущий проект под новым именем. Это позволяет со- 
хранить файл проекта под новым именем для какого-то последующего его исполь- 
зования. Для модулей, входящих в проект, имена файлов не изменяются. 


базе АП — сохранить текущий проект и все его файлы 


Выбор этого раздела меню сохраняет все, что в данный момент открыто — про- 
ект, группу проектов и все прочие файлы: модули, ресурсы и т.п. 


Close — закрыть текущий модуль или проект 


Выбор этого раздела закрывает файл, связанный с активным окном. Если ак- 
тивным было окно Редактора Кода с загруженным в него модулем, то закрывается 
этот модуль и связанная с ним форма. Если`же в окне Редактора Кода был выделен 
файл проекта или активным было окно Менеджера Проектов, то закрывается теку- 
щий проект вместе со всеми его файлами. Если вы не сохранили ваш модуль или 
проект в его текущем состоянии, C++Builder спросит, хотите ли вы сохранить вне- 
сенные изменения. 


Close АЦ — закрыть все файлы текущего проекта или группы 


Выбор этого раздела закрывает все файлы текущего проекта или группы. Если 
вы не сохранили какие-то из файлов в их текущем состоянии; C++Builder спросит, 
хотите ли вы сохранить внесенные изменения. 


Include Unit Hdr — связать активный модуль с другим модулем 
проекта 


Выбор этого раздела меню доступен только в проектах с несколькими модуля- 
ми. При выборе раздела открывается диалоговое окно, в котором вы можете вы- 
брать модуль, с которым хотите связать активный в данный момент модуль. В ре- 
зультате в текущий модуль будет вставлена директива #include, подключающая 
заголовочный файл указанного вами модуля. Тогда из текущего модуля можно бу- 
дет обращаться к открытым объектам, методам, функциям, переменным указан- 
ного модуля. Конечно, вы можете и без этого раздела меню вставить в код соответ- 
ствующую директиву. Этот раздел меню просто облегчает эту операцию. 


Print — напечатать текст модуля или форму 


Выбрав этот раздел меню, вы можете распечатать выбранный элемент проек- 
та. Если вы выделили в C++Builder форму и выполнили команды File | Print, то поя- 
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вится диалоговое окно печати формы (Print Form). В этом диалоговом окне вы мо- 
жете выбрать, как бы вы хотели напечатать форму. Имеются опции: 


Я BORER SERRE SE BO RID ISIE а В О В ое В о О НЫЙ 

Proportional Делается попытка напечатать изображение формы того же раз- 
мера, который виден на экране. При этом используется свойство 
формы PixelsPerInch — число пикселей на дюйм. В зависимо- 
сти от значения этого свойства форма может оказаться занима- 
ющей более одной страницы 


Print to fii page Увеличивает или уменьшает размер изображения, подгоняя его 
+» под размер страницы, -заданный при установке принтера. Про- 
порции формы сохраняются 


No scaling Масштабирование не используется. Размер изображения может 
изменяться в зависимости от используемого принтера и может 
занимать более одной страницы 


Если вы хотите напечатать программный код, то должны выделить окно с 
этим кодом, выполнить команду File | Рип! и на экране появится диалоговое окно пе- 
чати текста (Print Selection). В нем вы можете задать опции, определяющие фор- 
мат печати: Рип! selected block — печать только выделенного текста (предполагает- 
ся, что вы выделили фрагмент текста), Header/Page Number — печать вверху каж- 
OU страницы ее номера и имени файла, Line Numbers — печать слева от каждой 
строки ее номера, Syntax Print — печать выделений в окне редактирования (жирный 
шрифт, курсив, подчеркивание), Use Color — печатать в цвете (на цветном принте- 
ре), Wrap Lines — переносить строки (в противном случае строки, He помещающие- 
ся на странице, усекаются), Left Margin — левое поле, измеряемое числом символов. 


Exit — выход 


Выбор этого раздела меню приводит к выходу из MCP C++Builder. Если ваш 
проект не сохранен в текущем состоянии, C++Builder предложит вам сохранить 
его перед уходом. 


14.1.2 Меню редактирования Edit 


Раздел главного меню Edit включает меню редактирования для работы с тек- 
стом и компонентами в процессе проектирования. Меню имеет следующие разде- 
лы. 


Undo/Undelete — отменить предыдущую операцию 


Этот раздел появляется в меню в виде команды Undelete (восстановить удален- 
ное) или Undo (отменить предыдущее действие) в зависимости от того, какая ко- 
манда выполнялась перед этим. Если вы только’что удалили объект или какой-то 
код клавишей Delete или с помощью команды Delete в меню Edit, то данный раздел 
будет иметь название Undelete. Он позволит вам восстановить то, что вы непосред- 
ственно перед этим удалили. А если вы только что добавили в проект код, раздел 
будет называться Undo. Это позволит вам отменить последнее добавление. 


Redo — отменить предыдущую команду Undo 


Команда Redo противоположна команде Undo. Redo возвращает вас назад к со- 
стоянию, которое было до выполнения команды Undo или даже до выполнения 
ряда последовательных команд Undo. 
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Cut — вырезать в буфер обмена компоненты или фрагмент текста 


Эта команда вырезает выделенные элементы (компонент, группу компонентов 
на форме или фрагмент текста) и помещает их в буфер Clipboard. Выделенные эле- 
менты удаляются из текущей формы или текста. Эта команда в совокупности с ко- 
мандой Paste позволяет, в частности, переносить группу компонентов из одного кон- 
тейнера (например, панели) в другой (другую панель) — см. раздел 2.5.2 главы 2. 


Сору — копировать в буфер обмена компоненты или фрагмент текста 


Эта команда копирует выделенные элементы (компонент, группу компонентов 
на форме или фрагмент текста) и помещает их в буфер Clipboard. Выделенные эле- 
менты не удаляются из текущей формы или текста. Эта команда в совокупности с 
командой Paste позволяет, в частности, копировать группу компонентов из одного 
контейнера или формы в другой контейнер или форму, которая может находится в 
другом проекте. В совокупности с командой Paste позволяет также копировать 
фрагменты текста из других проектов или примеров, поставляемых с C++Builder. 


Paste — прочитать содержимое буфера обмена в форму или в текст 


Эта команда копирует содержимое Clipboard в текущую форму или в текст. Со- 
вместно с командами Cut и Copy может использоваться для перемещения и копиро- 
вания компонентов, групп компонентов и фрагментов кода. 


Delete — удалить компоненты или фрагмент текста 


Команда удаляет выделенные на форме или в тексте элементы. Если вы ошиб- 
лись, то имеется возможность восстановить ошибочно удаленные элементы с помо- 
щью команды Undelete. Помните, что удаленные выделенные на форме или в тексте 
элементы не помещаются в буфер Clipboard. 


Select All — выделить все 


Эта команда выделяет все компоненты на текущей форме или весь код в теку- 
щем модуле в зависимости от того, с чем вы в данный момент работаете. 


Align to Grid — выровнять по сетке 


Команда выравнивает размещенные на форме компоненты по узлам сетки. 
Правда, если вы установили опцию Snap to Спа на странице Preference с помощью 
команды Tools | Environment Options, то раздел меню Align to Спа не нужен. Все компо- 
ненты будут автоматически размещаться на форме в узлах сетки. 


Bring to Front — переместить наверх 


Команда помещает выделенный компонент сверху всех остальных (на верх 
2-последовательности, но с учетом того, что все неоконные компоненты располага- 
ются позади оконных). Это полезно, если вы разместили на форме ряд компонен- 
тов и они накладываются друг на друга. В этом случае вы можете решить, что ка- 
кой-то скрытый компонент, лежащий под другими, должен быть наверху. Для это- 
го надо выделить этот компонент и затем выполнить данную команду меню. 


Send to Back — переместить вниз 


Эта команда противоположна по смыслу команде Bring to Front. Она помещает 
выбранный компонент или компоненты позади всех других компонентов (в низ 
7-последовательности, но с учетом того, что все не оконные компоненты распола- 
гаются позади оконных). 
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Align — выровнять местоположение компонентов в группе 


При выборе этого раздела меню появляется диалоговое окно Alignment (Вы- 
равнивание). Опции этого окна позволяют выбрать ряд вариантов выравнивания 
компонентов на форме по горизонтали и вертикали (см. раздел 2.5.2.5).. 


Size — выровнять размеры группы компонентов 


Выбор этого раздела меню позволяет. изменять размеры компонента до задан- 
ных значений ширины и высоты. Если вы выделили несколько компонентов, дан- 
ный раздел позволяет увеличить размеры всех этих компонентов по горизонтали, 
вертикали или в обоих направлениях до размеров наибольшего из выделенных 
компонентов на странице или сократить их размеры до размера наименьшего из 
них (см. раздел 2.5.2.5). 


Scale — масштабировать все компоненты на форме 


Используя команду Scale, вы можете пропорционально изменить масштаб все- 
го расположенного на форме. Все размеры можно увеличивать или уменьшать 
вплоть до ста раз. В появляющемся диалоговом окне вам надо задать Scaling 
factor — масштабирующий коэффициент в %. Например, задав 200 вы увеличите 
все компоненты в 2 раза. 


Tab Order — установить последовательность табуляции, 


C++Builder позволяет установить последовательность смены активных компо- 
нентов, расположенных в данном контейнере — на форме, панели и т.п., при на- 
жатии пользователем клавиши табуляции Tab. Команда Tab Order высвечивает на 
экране диалоговое окно редактирования последовательности табуляции (Edit Tab 
Order). В окне помещен список имен всех компонентов, размещенных в данном 
контейнере. Вы можете изменить их последовательность, выделяя соответствую- 
щий элемент и нажимая кнопки со стрелками «вверх» или «вниз». Это удобнее, 
чем устанавливать свойства каждого компонента вручную. 


Creation Order — установить последовательность создания 
невизуальных компонентов 


Команда позволяет управлять последовательностью, в которой создаются невизу- 
альные компоненты. Эта последовательность может быть важна, если одни из этих 
компонентов используют свойства других, полагая, что те существуют и инициализи- 
рованы. Если эти компоненты не создаются в правильной последовательности, то об- 
ращение к несуществующему компоненту вызовет генерацию исключения. 


Flip Children — зеркальное отображение размещения 


Раздел позволяет зеркально преобразовать размещение (справа налево) компо- 
нентов формы или конкретного контейнера (панели), выбрав из подменю один из 
двух вариантов: All — все компоненты формы (при этом внутри каждого контейне- 
ра тоже происходит зеркальное отображение) или Selected — дочерние компоненты 
выделенного контейнера. Чаще всего это используется при разработке вариантов 
приложений, предназначенных для стран Востока. 


Lock Controls — зафиксировать компоненты 


После того, как вы разместили и выровняли компоненты, их местоположение 
полезно зафиксировать этой командой. Иначе в процессе последующей работы над 
проектом вы можете случайно сдвинуть тот или иной компонент, когда будете его 
выделять курсором, и всю работу по выравниванию придется начинать заново. 
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Команда Lock Controls зафиксирует расположение всех компонентов на форме и 
не позволит их перемещать. Если в дальнейшем у вас все-таки возникнет потреб- 
ность изменить расположение компонентов, то выполните повторно команду 
Edit | Lock Controls, и компоненты будут разблокированы. 


Add to Interface — добавить в интерфейс компонента ActiveX 


С помощью этого раздела вы можете добавить новый метод, событие или свой- 
ство в интерфейс компонента Асйуех. 


CORBA Refresh — обновить классы CORBA 


Команда обновляет классы CORBA (Common Object Request Broker 
Architecture — стандарт построения приложений с распределенными объектами), 
чтобы они отражали изменения в файлах IDL вашего проекта. 


Use CORBA Object — использовать объект CORBA 


Команда автоматически генерирует код для связи с объектом CORBA (Common 
Object Request Broker Architecture — стандарт построения приложений с распре- 
деленными объектами). 


14.1.3 Меню поиска Search 


Выпадающее меню Search используется для локализации текста, объектов, моду- 
лей, переменных и символов в Редакторе Кода. Меню содержит следующие разделы. 


Find — найти 


C++Builder выполняет поиск первого вхождения заданной последовательно- 
сти символов в тексте. При выполнении команды на экране появляется диалоговое 
окно поиска текста Find Text, предоставляя в распоряжение пользователя ряд оп- 
ций: учет регистра (Case sensitivity), поиск заданной последовательности символов 
только как целого слова (Whole words only), направление поиска (Direction), область 
поиска (Scope) — во всем файле (Global) или только в выделенном фрагменте 
(Selected text), от курсора (From cursor) или в заданной области независимо OT поло- 
жения курсора (Entire scope). 


Find in Files — найти в файлах 


Выбор раздела меню Find in Files (поиск в файлах) позволяет вам проводить по- 
иск заданного текста и. просматривать каждое его вхождение в нижней части окна 
Редактора Кода. Наличие списка всех вхождений делает во многих случаях эту ко- 
манду более удобной, чем Find. Опции диалогового окна позволяют вам проводить 
поиск во всех файлах текущего проекта (Search all files in project), во всех открытых, 
файлах (Search all open Нез) и во всех файлах заданного каталога (Search in 
directories). Остальные опции поиска аналогичны команде Find. 


Керасе — заменить 


Диалоговое окно этой команды подобно окну команды Find, но содержит окош- 
ко для ввода заменяемой последовательности символов — Text to find, и окошко 
Replace with, в котором вы задаете текст замены. 


Search Again — искать снова 


Эта команда повторяет последний проведенный вами поиск, который вы зада- 
вали в диалоговом окне Find Text. 
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Incremental Search — быстрый поиск по вводимым символам 


Выбрав этот раздел меню, начните печатать какое-нибудь слово. C++Builder® 
найдет в тексте первое вхождение печатаемой вами последовательности символов. 
Это прекрасный инструмент в тех случаях, когда вы только приблизительно знае- 
те, что именно хотите найти. 


Go to Line Number — перейти на строку с заданным номером 


Этот раздел меню позволяет вам ввести номер строки (в пределах числа строк, 
имеющихся в файле вашего приложения), на которую вы хотите перейти. 


Со to Address — перейти по заданному адресу 


Этот раздел меню доступен только во время отладки. Он позволяет в соответст- 
вующем диалоговом окне указать адрес команды в памяти, по которому вы хотите 
перейти. Это может быть, например, адрес, связанный с последней ошибкой в при- 
ложении. После указания адреса вы попадете в окно CPU на строку, соответствую- 
щую указанному адресу. 


14.1.4 Меню просмотра View 


Выпадающее меню просмотра View позволяет вывести на экран или скрыть 
различные элементы среды проектирования C++Builder и открыть окна, связан- 
ные с интегрированным отладчиком. Меню содержит следующие разделы. 


Project Manager — Менеджер Проектов 


Эта команда активизирует окно Менеджера Проектов — Project Manager (см. 
раздел 2.4.3). 


Translation Manager — Менеджер Трансляции 


Эта команда активизирует окно Менеджера Трансляции, используемое при 
интернационализации приложений (см. раздел 4.7.1.2). 


Object Inspector — Инспектор Объектов 


Эта команда активизирует Инспектор Объектов — Object Inspector. 


To-Do List — список планируемых задач проектирования 


Эта команда отображает окно списка To-Do List, содержащего список плани- 
руемых задач проектирования (см. раздел 2.4.4.1). 


Alignment Palette — палитра выравнивания 


Эта команда активизирует очень удобный инструмент — палитру выравнива- 
ния Alignment Palette (см. раздел 2.5.2.5). Это визуальный вариант диалогового 
окна выравнивания Alignment, которое вызывается командой меню Edit | Align. 


ClassExplorer — окно Исследователя Классов 


Этот раздел меню активизирует окно Исследователя Классов, помогающего 
анализировать текст модуля и вносить элементы в объявления классов (см. раз- 
дел 2.5.3.2). 


810 зади (esse AD ALM OANO?E ем ‚Глава 14 


Component List — список компонентов 


'Выбор этого раздела меню отобразит диалоговое окно алфавитного списка всех 
компонентов в библиотеке. Кнопка Add to Form позволяет разместить выбранный 
компонент на форме. 


Window List — список открытых окон 


Выбор этого раздела меню откроет диалоговое окно со списком всех открытых 
окон C++Builder. Вы можете выбрать в нем нужное вам окно, и оно будет активи- 
зировано. Этот раздел очень полезен, если у вас открыто много окон, перекрываю- 
щих друг друга, и вы «потеряли» нужное вам окно. 


Debug Windows — вспомогательное меню отладки 


Этот раздел имеет подменю, включающее в себя разделы: 


а в вый 


Breakpoints ! Активизирует диалоговое ‹ окно списка точек прерывания - — 
Breakpoint List. Оно показывает все заданные для отладки точ- 
ки прерывания. Если вы щелкнете правой кнопкой мыши в 
этом окне, появится меню, позволяющее вам добавлять, изме- 
нять и удалять отладочные точки прерывания, формулировать 
условия прерывания (см. раздел 2.6.7) 


а Вы С ЧИ ль а $ 


Call Stack Активизирует диалоговое окно стека вызовов — Call Stack. 
Оно показывает последовательность, в которой вызываются 
процедуры и функции в выполняемом приложении 


Watches Активизирует диалоговое окно наблюдения. С помощью этого 
окна можно наблюдать в процессе отладки программы задан- 
ное множество переменных или выражений, содержащих эти 
переменные (см. раздел 2.6.4) 


Local Variables Показывает значения локальных переменных выполняемой 
функции 


Threads Показывает список текущих процессов, которые в данный MO- 
мент выполняются. Так как Windows 95/98 и МТ являются 
многозадачными системами, вы можете организовать в своем 
приложении несколько ветвей, которые будут выполняться не- 
зависимо 


Modules Активизирует диалоговое окно списка модулей — Module List. 
Окно содержит перечень всех модулей, загруженных в память 
при выполнении данного проекта. Этот список включает вы- 
полняемые модули и библиотеки DLL 


Event Log Активизирует окно, отображающее произошедшие события 
(см. раздел 2.6.9) 


CodeGuard Log Отображает ошибки, обнаруженные CodeGuard (если CodeGu- 
| аг у вас установлен) 


CPU Активизирует окно CPU, позволяющее наблюдать процесс вы- 
полнения приложения на уровне ассемблера 


FPU Активизирует окно FPU, позволяющее наблюдать информа- 
цию Floating-Point Unit в CPU или ММХ — расширенную вер- 
сию Intel для процессоров Pentium 
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Desktops — управление конфигурациями OKOH 


Выбор конфигурации окон и установка конфигурации окон в режиме отладки 
(см. раздел 2.2.9). 


Toggle Form/Unit — переключение между формой и кодом модуля 


Данная команда переключает вас между формой и ее модулем. 


Units — список модулей проекта 


Выбор этого раздела меню вызовет диалоговое окно, которое покажет список 
всех модулей (units) вашего проекта. Вы можете щелкнуть на том модуле, который 
хотите посмотреть, и он появится в окне Редактора Кода. 


Forms — список форм проекта 


Выбор этого раздела меню вызовет диалоговое окно, которое покажет список 
всех форм. вашего проекта. Вы можете щелкнуть на имени той формы, которую хо- 
тите посмотреть, и она активизируется на экране. 


Туре Library — библиотека типов 


Используется при преобразовании компонентов C++Builder в элементы 
ActiveX, серверы автоматизации, объекты MTS и СОМ. Библиотека типов — Type 
Library является составным документом OLE, содержащим информацию о типах 
данных, функциях-элементах и классах объектов, предоставленную управляющи- 
ми активными элементами ActiveX или серверами. Когда выделяется Туре Library в 
панели списка объектов — Object List Panel, выполнение команды Туре Library делает 
доступными страницу атрибутов и страницу используемых модулей Uses. 

Страница атрибутов содержит информацию о текущей выбранной библиотеке. 
Когда Type Library выделена в главной панели списка объектов, то на странице атри- 
бутов присутствуют следующие атрибуты и флаги: Name, GUID, Version, (СЮ, 
HelpFile, Help String, Help Context и др. 


New Edit Window — новое окно Редактора Кода 


Выбор этого раздела меню открывает новое окно Редактора Кода, оставляя на 
месте прежнее. Текущий модуль вашего окна редактирования появится и в новом 
окне. Наличие на экране нескольких окон редактирования позволяет одновремен- 
но видеть коды двух модулей. 


Toolbars — панель быстрых кнопок 


Эта команда вызывает подменю, позволяющее выбрать состав инструменталь- 
ной панели быстрых кнопок (см. раздел 14.2.1). 


14.1.5 Меню проекта Project 


Раздел меню Project используется для компиляции и построения приложения. 
Меню содержит следующие разделы. 


Add To Project — добавить в проект 


Выбор этого раздела меню позволяет вам добавить в проект существующий мо- 
дуль и связанную с ним форму. Когда вы добавляете модуль в проект, C++Builder 
автоматически добавляет в файл проекта .bpr соответствующую директиву 
_ #include. 
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Remove From Project — удалить из проекта 


Выбор этого раздела меню позволяет вам удалить из проекта существующий 
модуль и связанную с ним форму. Когда вы удаляете модуль из проекта, 
C++Builder автоматически удаляет из файла проекта соответствующую директиву 
tHinclude. 


Import Type Library — импортировать в проект библиотеку типов 


Выбор этого раздела меню открывает диалоговое окно, позволяющее импорти- 
ровать в проект одну из зарегистрированных в системе библиотек типов. 


Add То Repository — добавить текущую форму, фрейм или проект 
в Депозитарий 


Этот раздел меню добавляет текущую форму, фрейм или проект в Депозита- 
рий объектов — Object Repository. Это позволяет использовать добавленный эле- 
мент повторно, что сокращает время на разработку новых проектов. 


View Source — смотреть исходный файл проекта 


Эта команда заносит в окно Редактора Кода головной файл проекта с функци- 
ей WinMain или main. 


Languages — языки 


Эта команда позволяет добавлять, удалять и обновлять DLL ресурсов, исполь- 
зуемые при интернационализации проектов (см. раздел 4.7.1.2), а также позволя- 
ет выбирать язык в процессе отладки интернационализированных приложений. 


Edit Option Source — открыть файл проекта 


Открывает в Редакторе Кода файл проекта .bpr. Этот файл содержит информа- 
цию об опциях проекта, о версии, об используемых пакетах и т.п. 


Add New Project — добавить новый проект в группу 


Эта команда создает выбором из Депозитария новый проект и добавляет его в 
текущую группу проектов. 


Add Existing Project — добавить ранее созданный проект в группу 


Эта команда открывает один из имеющихся проектов и добавляет его в теку- 
щую группу проектов. 


Compile Unit — компилировать 


Эта команда осуществляет компиляцию только того модуля, который выделен 
вами в окне Редактора Кода или в Менеджере Проектов. Команда позволяет наибо- 
лее быстро проверить наличие ошибок или замечаний при компиляции модуля, 
так как не осуществляется компоновка программы и не компилируются никакие 
другие модули. Если компиляция прошла`успешно, создается объектный файл .obj 
откомпилированного модуля. 


Make project — скомпоновать проект 


Эта команда выполняет компиляцию всех тех модулей, тексты которых были 
изменены с момента предыдущей компоновки проекта (см. раздел 2.6.1). Если 
компиляция прошла успешно, то создаются объектные файлы модулей .obj и ocy- 
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ществляется компоновка программы. Если и она прошла успешно, то создается 
выполняемый модуль .ехе. 


Build project — компилировать весь проект 


Эта команда компилирует все модули вне зависимости от того, изменялось ли 
в них что-нибудь с момента последней компиляции вашей программы (см. раз- 
дел 2.6.1). Этим данная команда отличается от Make project. Если компиляция про- 
шла успешно, то создаются новые объектные файлы всех модулей .obj и осуществ- 
ляется компоновка программы. Если и она прошла успешно, то создается выпол- 
няемый модуль .ехе. 


Information for project — информация о проекте 


Эта команда открывает окно, в котором содержится информация о компиля- 
ции проекта: число строк в кодах (Source Compiled), объем кода в байтах (Code 
Size), объем памяти в байтах, необходимый для хранения данных (Data Size), объ- 
ем памяти в байтах, необходимый для хранения локальных переменных (Initial 
Stack Size), общий объем выполняемого модуля в байтах (File size) и информацию 
об успешности последней компиляции. 


Make All Projects — скомпоновать все проекты группы 


Эта команда осуществляет компиляцию всех файлов проектов в группе, кото- 
рые были изменены с момента последней компиляции (см. раздел 2.6.1). Если 
компиляция прошла успешно, то создаются объектные файлы модулей .obj и осу- 
ществляется компоновка программ. Если и она прошла успешно, то создаются вы- 
полняемые модули .ехе. 


Build АП Projects — компилировать все файлы всех проектов 


Эта команда осуществляет компиляцию всех файлов всех проектов в группе 
независимо от того, изменялись они или нет (см. раздел 2.6.1). Компиляция ocy- 
ществляется в той последовательности, в которой проекты отображены в окне Ме- 
неджера Проектов. Изменить при желании эту последовательность можно, выде- 
лив проект в окне Менеджера Проектов, щелкнув правой кнопкой мыши и выбрав 
команду Build Sooner (построить раньше) или Build Later (построить позднее). 


Web Deployment Options — сделать установки для развертывания 
формы или элемента ActiveX на сервере Web 


Эта команда позволяет сделать необходимые установки для развертывания 
формы или элемента ActiveX на сервере Web. 


Web Deploy — развертывание формы или элемента Activex 
на сервере Web 


Когда вы закончили проектирование активной формы, выполните команду 
Web Deploy, чтобы развернуть ее на сервере Web. 


Options — опции проекта 


Этот раздел меню активизирует диалоговое окно опций проекта — Project 
Options, в котором вы можете установить опции компиляции, компоновки и за- 
дать каталоги. 
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14.1.6 Меню выполнения Кип 


Раздел меню Run содержит выпадающее меню с командами, обеспечивающими 
выполнение и отладку вашей программы. Меню содержит следующие разделы. 


Run — компилировать и выполнить проект 


Данный раздел меню запускает выполнение вашего приложения C++Builder. 
Если до этого не была осуществлена компиляция программы в ее текущем состоя- 
нии, то перед запуском эта компиляция выполняется. Если вы работаете с группой 
проектов, то команда относится к активному в данный момент проекту (см. раз- 
дел 2.4.3). 


Attach to Process — подключиться к отладке процесса 


Данный раздел меню открывает окно, в котором перечислены все процессы 
(программы), выполняемые на компьютере в данный момент. Выбрав процесс и 
сделав на нем двойной щелчок или нажав кнопку Анасй, вы можете подключиться 
к нему (появится соответствующее окно СРП). _ 


Parameters — параметры командной строки 


Этот раздел меню вызывает диалоговое окно, которое позволяет задать пара- 
метры командной строки, необходимые при запуске приложения, или указать 
хост (ведущее приложение) при отладке DLL, или указать компьютер при удален- 
ной отладке. 


Register ActiveX Server — зарегистрировать в Windows активный 
сервер Activex 


Этот раздел меню доступен, если текущий проект — ActiveX. Данный раздел 
дает возможность зарегистрировать ваш активный сервер ActiveX в реестре 
Windows 95/98. Если вы проведете подобную регистрацию, то ваш управляющий 
активный элемент можно будет вызывать, применяя программу просмотра Web 
или другие приложения. Прежде, чем использовать управляющий элемент в пер- 
вый раз, его надо зарегистрировать. 


Unregister ActiveX Server — снять с регистрации в Windows актив- 
ный сервер Activex 


Этот раздел меню доступен, если текущий проект — ActiveX. Данный раздел 
дает вам возможность снять ваш активный сервер ActiveX с регистрации в реестре 
Windows 95/98. Тем самым экземпляр вашего активного элемента удаляется из 
системы. 


Install MTS Objects — установка объекта MTS 


Эту команду можно использовать, если на вашем компьютере установлен 
Microsoft transaction server (MTS) и ваш проект является проектом MTS. Тогда эта 
команда устанавливает вап объект MTS в пакет MTS. 


Install COM+ Objects — установить объекты в приложение СОМ+ 


Эту команду можно использовать, если ваша система поддерживает COM+. То- 
гда эта команда вызывает диалоговое окно, позволяющее установить объекты те- 
кущего приложения в приложение СОМ+. 
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Step Over — выполнить по шагам без захода в функции 


Эта команда вызывает пошаговое выполнение приложения, по одному опера- 
тору за шаг, причем любая функция выполняется, как если бы она была одним 
оператором программы. Это удобно, если вы хотите смотреть поведение вашей про- 
граммы, не заходя внутрь каждой функции (см. раздел 2.6.6). | 


Trace Into — выполнить по шагам с заходом в функции 


Эта команда вызывает пошаговое выполнение приложения, по одному опера- 
тору за шаг, но любая функция выполняется тоже в пошаговом режиме (см. раз- 
дел 2.6.6). 


Trace to Next Source Line — выполнить до следующей команды 


Эта команда позволяет выполнить приложение до следующей выполняемой 
команды. Ее удобно применять при работе с окном CPU. 


Run to Cursor — выполнить до курсора 


Эта команда выполняет ваше приложение вплоть до той точки в исходном 1 тек- 
сте, где находится курсор (см. раздел 2.6.6). 


Run Until Return — выполнить Oo выхода из функции 


Эта команда выполняет ваше приложение до выхода из текущей функции и 
останавливается на операторе, следующем за вызовом этой функции. 


Show Execution Point — показать точку выполнения 


Выполните эту команду, если вы закрыли окно редактирования и находитесь 
в процессе пошаговой отладки программы. Это вернет вас в окно редактирования, 
причем курсор будет расположен на операторе, который будет выполняться сле- 
дующим. 


Program Pause — пауза в выполнении 


Эта команда вызывает паузу в выполнении приложения и вы можете спокойно 
поработать с окном Watch. 


Program Reset — завершение приложения 


Эта команда прекращает выполнение вашего приложения и выгружает его из 
памяти. 


Inspect — открыть окно Инспектора Отладки 


Команда доступна только во время выполнения приложения при останове. 
средствами отладки или вследствие генерации исключения. При останове вы мо- 
жете поставить курсор на имя интересующей вас переменной, или компонента, 
или функции и выполнить команду Run | Inspect. Инспектор Отладки позволяет ис- 
следовать различные данные: переменные, массивы, классы, функции, указатели. 
Причем, не только исследовать, но и изменять значения переменных и свойств 
компонентов (см. раздел 2.6.8). 


Evaluate/Modify — изменение значения переменной при выполнении 


Эта команда позволяет вам с помощью диалогового окна Evaluate/Modify (см. 
раздел 2.6.5) изменять значение переменной в процессе выполнения программы. 
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Более того, вы можете написать некоторое выражение, включающее переменные 
вашего приложения, и это выражение будет немедленно посчитано. 


Add Watch — добавить переменную в окно наблюдения 


Этот раздел дает вам один из способов добавить наблюдаемую переменную в 
список Watch (см. раздел 2.6.4). Другой способ — выполнить View | Watches, сде- 
лать щелчок правой кнопкой мыши на окне Watch List и выбрать раздел Add в вы- 
падающем меню. 


Add Breakpoint — добавить точку прерывания 


Эта команда предоставляет вам один из способов добавить новую точку в спи- 
сок точек прерывания или изменить существующую точку (см. раздел 2.6.7). Дру- 
гой способ сделать то же самое — выполнить View | Breakpoint, сделать щелчок пра- 
вой кнопкой мыши в окне ВгеаКро!т List и выбрать раздел Ада в выпадающем 
меню. 


14.1.7 Меню компонентов Component 


Раздел Component главного меню содержит выпадающее меню, которое позво- 
ляет работать с компонентами: создавать новые компоненты, изменять палитру 
компонентов и т.п. Меню содержит следующие разделы. 


New Component — создать новый компонент 


Этот раздел меню активизирует диалоговое окно, которое помогает создавать 
новые компоненты C++Builder. 


Install Component — установить новый компонент в пакет 


Этот раздел меню позволяет вам установить новый компонент C++Builder в 
новый или уже существующий пакет C++Builder. 


Import ActiveX Library — импортировать элемент ActiveX в пакет 


Этот раздел меню позволяет импортировать активный управляющий элемент 
ActiveX, который уже зарегистрирован в системе, в новый или уже существующий 
пакет C++Builder. 


Create Component Template — создать шаблон компонента 


Этот раздел меню становится активным, когда вы выделили на форме компо- 
нент или совокупность компонентов. Он позволяет вам выделить, например, Table 
и DataSource, и затем скомбинировать их в один компонент, который может pac- 
сматриваться на форме как единое целое и может быть помещен на какой-либо 
странице палитры компонентов. 


Install Packages — показать пакеты 


Этот раздел меню позволяет просмотреть список всех имеющихся пакетов и 
указать, какие пакеты должны компилироваться в ваше приложение (см. раз- 
дел 7.6). Вы можете видеть также текущий список компонентов каждого пакета, 
‘редактировать состав пакетов. 


Configure Palette — конфигурировать палитру компонентов 


Данная команда позволяет добавлять и удалять компоненты, видимые на эк- 
ране в палитре компонентов (см. раздел 14.2.2). 
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14.1.8 Меню баз данных Database 


Раздел меню Database содержит команды, позволяющие создавать, модифици- 
ровать и просматривать ваши базы данных. Меню содержит следующие разделы. 


Explore — вызвать SQL Explorer 


Этот раздел меню вызывает инструмент исследования баз данных — SQL 
Explorer. Он позволяет просматривать и редактировать структуры баз данных. 


SQL Monitor — вызвать SQL Monitor 


Этот раздел меню вызывает программу SQL Monitor. Монитор позволяет Ha- 
блюдать прохождение запросов SQL и то, как они обрабатываются в вашем прило- 
жении. 
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Form wizard — вызвать мастера разработки форм с базами данных 


Мастер форм баз данных поможет вам создать форму для работы с базами дан- 
ных. Он откроет базу данных, с которой вы хотите связаться, и поможет вам спро- 
ектировать экран для данных, содержащихся в файлах. 


14.1.9 Меню инструментов Tools 


Раздел Tools главного меню C++Builder предоставляет возможность просмат- 
ривать и изменять установки среды C++Builder, модифицировать список про- 
грамм в подменю Tools. Это частично формируемый вами раздел меню MCP, в со- 
став которого вы можете изменить исходя из наиболее часто решаемых вами за- 
дач. Вы можете вставить в это меню и какие-то свои собственные программы. По 
умолчанию меню содержит следующие разделы. 


Environment Options — опции окружения 


Этот раздел меню выводит диалоговое окно настройки окружения — 
Environment Options. В этом окне вы можете изменять установки многих опций. 


Editor Options — опции Редактора Кода 


Этот раздел меню выводит диалоговое окно настройки Редактора Кода (см. 
раздел 14.2.5). 


Debugger Options — опции отладчика 


Этот раздел меню выводит диалоговое окно настройки отладчика — Debugger 
Options, в котором вы можете изменять установки, ‚связанные с отладкой прило- 
жений (см. раздел 14.2.8). 


Translation ToolsOptions — опции интернационализации 


Этот раздел меню выводит диалоговое окно настройки инструментария 
Integrated Translation Environment (ITE), используемого при интернационализа- 
ции проектов (см. раздел 4.7.1.2). 


Repository — Депозитарий объектов 


Этот раздел меню вызывает диалоговое окно просмотра Депозитария объек- 
тов — Object Repository (см. раздел 14.2.3). Оно позволяет просмотреть объекты, 
которые вы поместили в Депозитарий командой Ргоес! | Add To Repository. Вы може- 
те также добавлять и удалять объекты из Депозитария. 
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Translation Repository — депозитарий переводов 


Этот раздел меню вызывает диалоговое окно депозитария переводов, храняще- 
го переводы для интернационализации проектов (см. раздел 4.7.1.2). 


Visibroker SmartAgent — запуск и останов SmartAgent 


Раздел позволяет. запустить или остановить Visibroker Smart Agent. Smart 
Agent должен быть запущен для клиентского приложения CORBA, чтобы связать- 
ся с сервером приложений CORBA. 


IDL Repository — регистрация файла IDL в проекте 
с Interface Repository CORBA 


Раздел позволяет вызвать диалоговое окно Update IDL Repository, в котором 
вы можете зарегистрировать свой файл интерфейса IDL. 


Configure Tool — настройка разделов меню Tools 


Этот раздел меню позволяет вам настроить C++Builder, добавляя инструменты 
в меню Тоо. Это обеспечивает большую гибкость в настройке среды C++Builder 
под ваши задачи (о настройке меню Tools см. в разделе 14.2.4). 


Database Desktop — вызов Database Desktop 


Раздел вызывает программу Database Desktop, позволяющую создавать и pe- 
дактировать базы данных Paradox, dBASE, БОГ. и др. , 


TeamSource — система управления проектами 


Раздел вызывает главное окно системы Borland TeamSource, организующей 
управление большими проектами (см. раздел 2.4.4.2). Этот раздел присутствует не 
во всех версиях C++Builder 5. 


Package Collection Editor — создание и редактирование собрания 
пакетов 


Раздел вызывает Редактор Собрания Пакетов, позволяющий создавать новые 
и редактировать существующие собрания пакетов. 


Visual C++Project Conversion Utility — преобразование проектов 
Visual C++ 


Раздел преобразует проекты Microsoft Visual C++ 5.0 u 6.0 (файлы .dsp и .dsw) 
в соответствующие файлы проекта C++Builder. 


Image Editor — вызов редактора изображений 


Раздел вызывает редактор изображений — битовых матриц, пиктограмм ит.п. 


14.1.10 Меню справки Нер 


Разделы меню Help позволяют работать со справочной системой C++Builder. 
Меню содержит разделы C++Builder Help — вызов справки по C++Builder и С++, 
раздел C++Builder Tools — вызов справок по инструментарию C++Builder 5, Windows 
API/SDK Help — вызов справок по Windows, ряд разделов получения информации 
через Интернет, а также раздел Customize, позволяющих настраивать справочную 
систему (см. раздел 2.5.3.4). 
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14.2 Настройка Интегрированной Среды 
Разработки C++Builder 


14.2.1 Настройка инструментальной панели 


Инструментальная панель содержит быстрые кнопки, дублирующие команды 
меню и существенно облегчающие работу. Благодаря технологии Drag&Doc, вы 
можете осуществлять перестроение инструментальных панелей, просто перетаски- 
вая их мышью (см. раздел 2.2.8). Но возможности настройки панелей гораздо 
шире. Вы можете делать какие-то из панелей невидимыми и можете изменять на- 
боры быстрых кнопок панелей. 

Наиболее простой способ реорганизации панелей — сделать те из них, которые 
вам сейчас не нужны, невидимыми. Для этого выполните команду View | Toolbars. 
Можно обойтись и без этой команды, просто щелкнув правой кнопкой мыши Ha од- 
ной из панелей. В обоих случаях вы увидите меню, содержащее индикаторы от- 
дельных панелей: Standard, View, Debug, Custom, Component Palette, Desktops, CORBA. 
Можете выключить какие-то из этих индикаторов (например, индикатор Custom, 
соответствующий панели, которая по умолчанию содержит только кнопку справ- 
ки). Освободившееся место можно использовать под расширение каких-то других 
панелей. В дальнейшем в любой момент с помощью того же меню вы можете опять 
восстановить установку индикатора и панель станет видимой. 

В том же меню, всплывающем при щелчке на панели правой кнопкоы мыши, 
имеется раздел Customize, который позволяет настроить состав отдельных панелей, 
добавляя или удаляя какие-то быстрые кнопки. При выборе этого раздела появит- 
ся диалоговое окно, представленное на рис. 14.1. В этом окне страница Тоооаг$ по- 
зволяет управлять видимостью панелей, а расположенная на этой стрванице кноп- 
ка Кезе! восстанавливает вид панели по умолчанию. Если вы выберете в окне одну 
из панелей и нажмете Reset, то после запроса о подтверждении уничтожения всех 
изменений панели она примет вид, который имела по умолчанию. Таким образом, 
если вы как-то неудачно настроили панель, у вас всегда есть возможность вернуть 
ее к тому состоянию, которое продумали за вас создатели C++Builder. 

На странице Commands окна рис. 14.1 вы можете выбрать меню (Categories) и 
его раздел (Commands), для которого вы хотите добавить кнопку на панель. Далее 
можно мышью перетащить выбранную кнопку на панель. Чтобы удалить кнопку с 
инструментальной панели, надо перетащить ее оттуда мышью. 

На странице Options окна рис. 14.1 вы можете включить или выключить оп- 
ции Show tooltips — показ ярлычков быстрых кнопок при задержке над ними курсо- 
ра мыши, и Show shortcut keys on tooltips — показ на этих ярлычках соответствующих 
сочетаний «горячих» клавиш. 

Находясь на любой странице диалогового окна рис. 14.1 вы можете переупоря-*' 
дочивать кнопки любой инструментальной панели, просто перетаскивая их мышью. 


Рис. 14.1. 
Окно настройки инструментальных панелей 
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14.2.2 Настройка палитры компонентов 


Вызвать настройку палитры компонентов можно щелчком правой кнопки 
мыши на палитре и выбором команды Properties из всплывшего меню. Можно вы- 
полнить для этого команду Component | Configure Palette. Можно также выполнить 
команду Tools | Environment Options и перейти в открывшемся диалоговом окне на 
страницу Palette (рис. 14.2). 


Рис. 14.2. 
Страница настройки палитры компонентов 
_ в окне Environment Options 


Опции окна позволяют работать со страницами палитры. Для этого надо пе- 
рейти в окно Pages и нажать кнопку Add, чтобы добавить новую страницу (на 
рис. 14.2 вы видите внизу две новые страницы — Мои компоненты и Мои шаблоны), 
кнопку Rename, чтобы переименовать страницу, кнопку Delete, чтобы удалить стра- 
ницу (она должна быть к этому моменту пустой), кнопки Move Up или Move Down, 
чтобы изменить последовательность страниц в палитре. Впрочем, последователь- 
ность проще изменять, просто перетаскивая мышью в левой панели страницу на 
новое место в списке. 

Последний раздел А! показывает список компонентов всех страниц. Если вы- 
делить этот раздел, то вид правого окна Components несколько изменяется. В нем 
появляется три столбца: Name, Package и Page. Щелкнув на одном из этих столбцов 
вы можете упорядочить список компонентов соответственно по имени компонента, 
по пакету, в который он включен, или по страницам библиотеки. При выделенном 
разделе А! в окне появляется кнопка Default. Если щелкнуть на ней, восстановится 
последовательность и состав страниц, принятый в C++Builder по умолчанию. 

Перейдя в окно Сотропет вы можете изменять состав страниц, перетаскивая 
мышью компонент с одной страницы на другую или делая кнопкой Hide какие-то 
компоненты невидимыми (кнопка Hide появляется на месте кнопки Delete, кото- 
рую вы видите на рис. 14.2, при выделении какого-нибудь компонента в правой 
панели). Можете изменять последовательность компонентов на странице кнопка- 
ми Move Up и Move Down, или просто перетаскивая соответствующую строку вверх 
или вниз. 


14.2.3 Настройка Депозитария 


Депозитарий является хранилищем форм, фреймов, проектов. Вы можете ре- 
организовывать страницы Депозитария, вносить на них свои формы и проекты 
(см. раздел 7.4 главы 7), создавать новые страницы. Для реорганизации страниц 
щелкните в окне Депозитария правой кнопкой мыши и выберите из контекстного 
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меню раздел Properties. Вы попадете в окно реорганизации Депозитария, представ- 
ленное на рис. 14.3. В это же окно можно попасть, выполнив команду 
Tools | Repository. 

В левом списке Pages (страницы) этого окна вы видите список тех страниц Де- 
позитария, которые вы можете перестраивать. Выделив строку в левом списке вы 
увидите в правом списке Objects объекты, отображенные на этой странице. Кнопка 
Edit Object позволяет отредактировать информацию об объекте, кнопка Delete Object 
позволяет удалить объект из Депозитария. Мышью вы можете перетащить объект 
из правого окна на другую страницу Депозитария, отображенную в левом окне. 
Если вы перетащите объект в строку [Object Repository], то этот компонент не будет 
представлен ни на одной странице окна, хотя по-прежнему будет храниться в Де- 
позитарии. Впоследствии вы можете его извлечь из [Object Repository] и перенести 
мышью на любую страницу. 

Кнопка Ада Раде позволяет добавить новую страницу в Депозитарий (см. на 
рис. 14.3 добавленные страницы Мои формы и Мои проекты), кнопка Delete Page уда- 
ляет пустую страницу, кнопка Кепоте Раде позволяет переименовать закладку 
страницы. Кнопки со стрелками позволяют переместить выделенную страницу 
вверх или вниз. Впрочем, проще перетащить мышью строку выделенной страницы 
на нужную позицию. 

Если вы выделите в правом окне одну из форм, то вам будут доступны два ин- 
дикатора (см. рис. 14.3): New Form — сделать данную форму формой по умолчанию 
при добавлении новой формы в проект (при выполнении команды File | New Form), и 
Мат Гогт — сделать данную форму главной формой по умолчанию (она будет авто- 
матически включаться в создаваемый новый проект вместо пустой формы). 
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Puc. 14.3. 
Окно реорганизации Депозитария 
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Если вы выделите в правом окне один из проектов, то вам будет доступен ин- 
дикатор New Project — открывающий данный проект при выполнении вами в по- 
следующем команды File | New Application. 

Таким образом, реорганизация Депозитария позволяет вам настраивать неко- 
торые разделы меню File. 


14.2.4 Настройка меню Tools 


Меню среды разработки Tools может быть настроено добавлением в него разде- 
лов, вызывающих те или иные приложения. Таким образом вы можете расширить 
возможности главного меню C++Builder, приспособив его для своих задач. Для на- 
стройки надо выполнить команду Tools | Configure Tool. Перед вами откроется диало- 
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говое окно, представленное на рис. 14.4 a. В нем содержится список тех разделов 
меню Tools, которые вы можете удалять (кнопка Delete), переставлять (кнопки со 
стрелками), редактировать (кнопка Edit). Разделы, входящие в меню безусловно, в 
этом списке не отражены. 

Кнопка Add позволяет добавить в меню новые разделы. При нажатии этой 
кнопки открывается диалоговое окно, представленное на рис. 14.4 6 (на рисунке 
оно показано с развернутым списком макросов). Для ввода нового раздела меню вы 
должны в окошке Ргодгат написать имя выполняемой программы вместе с путем к 
нему. В окошке Working Dir вы указываете рабочий каталог выполняемой програм- 
мы. Оба эти окошка проще всего заполнять, указывая программу в дереве катало- 
гов компьютера с помощью кнопки Browse. Выбор программы этой кнопкой авто- 
матически заполняет оба окошка и вам остается только, если необходимо, подпра- 
вить рабочий каталог. 


Рис. 14.4. Ч Too! Options 
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В окошке Title вы должны написать название вводимого вами раздела меню. 
При этом можете использовать амперсант для указания клавиши ускоренного дос- 
тупа, как это обычно делается в меню. 

Перечисленные выше окна вы должны заполнить. В окно Parameters вы може- 
те занести строку параметров, которую хотите передать в вызываемую программу. 
При записи этой строки вы можете использовать макросы, список которых развер- 
тывается кнопкой Macros (на рис. 14.4 6 этот список развернут). Вы можете ис- 
пользовать следующие макросы: 
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и ERI RICE: 


$COL x Расширяется до номера позиции курсора в активном окне Ре- 
дактора Кода. Например, если позиция курсора 50, то C++Buil- 
der передаст в запускаемую программу параметр «50» 


$ROW Расширяется до номера строки курсора в активном окне Редак- 
тора Кода. Например, если курсор находится в строке 10, то 
C++Builder передаст в запускаемую программу параметр «10» 


$CURTOKEN Расширяется до слова (лексемы), в котором расположен курсор 
_в активном окне Редактора Кода. Например, если курсор нахо- 
дится в слове Label, то C++Builder передаст в запускаемую bans 
грамму параметр «Label» 


ФРАТН Расширяется до каталога файла, указанного в макросе как па- 
раметр. Сам макрос записывается в строку как S$PATH(). В 
скобках вы можете указать файл. Например, макрос 
ФРАТН($ЕОМАМЕ) передаст в запускаемую программу каталог 
файла, расположенного в активном окне Редактора Кода 


SNAME Расширяется до имени файла, указанного в макросе как пара- 
метр. Сам макрос записывается в строку как $МАМЕС. В скоб- 
ках вы можете указать файл. Например, макрос 
SNAME($EDNAME) передаст в запускаемую программу имя 
файла, расположенного в активном окне Редактора Кода 


ФЕХТ Развертывается до расширения файла, указанного в макросе 
как параметр. Сам макрос записывается в строку как ФЕХТО. В 
скобках вы можете указать файл. Например, макрос 
SEXT(SEDNAME) передаст в запускаемую программу имя фай- 
ла, расположенного в активном окне Редактора Кода 


ФЕОМАМЕ Расширяется до полного имени файла, расположенного в актив- 
ном окне Редактора Кода 


ФЕХЕМАМЕ Расширяется до полного имени выполняемого файла текущего 
проекта. Например: «C:\PROJ1\UNIT1.EXE». Например: 
«C:\PROJ1\UNIT1.PAS» 


$PARAMS Расширяется до командной строки, указанной в диалоге коман- 
ды Run | Parameters 


$PROMPT Перед запуском программы Ha выполнение предлагает пользо- 
вателю диалоговое окно, в котором пользователю предлагается 
указать значение параметра. Макрос вставляется в строку в 
виде $РКОМРТ(). В скобках вы можете указать пользователю 
значение параметра по умолчанию, которое и будет показано 
ему в диалоговом окне при выполнении программы 


SSAVE Сохраняет на диске файл, активный в Редакторе Кода 
$SSAVEALL Сохраняет текущий проект 
$TDW Устанавливает окружение для запуска отладчика Turbo Debug- 


ger: сохраняет проект, убеждается, что проект скомпилирован с 
отладочной информацией, повторно компилирует проект, если 
отладочная информация не была включена в него. Этот макрос 
имеет смысл использовать, только если вы включили отладчик 
в меню Tools 


Выбрав макрос в списке макросов окна рис. 14.4 6, вы должны нажать кнопку 
Insert и макрос запишется в позицию курсора в окошке Parameters. 
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14.2.5 Настройка Редактора Кода 


Вызвать настройку Редактора Кода можно щелчком правой кнопки мыши в 
его окне и выбором команды Properties из всплывшего меню. Можно также выпол- 
нить для этого команду Tools | Editor Options. 

В открывшемся окне (рис. 14.5) страницы, относящиеся непосредственно к 
Редактору Кода: General, Display, Key Bindings, Color. 


Puc 14 5 Editot Properties 
Страница General в окне настройки 
Редактора Кода 


Вид страницы General показан на рис. 14.5. Группа Editor Options (опции редак- 
тора) предлагает ряд опций, которые вы можете включить или выключить исполь- 
зуя индикаторы с флажками: 


Auto indent mode При нажатии 1 Enter курсор позиционируется ‹ с ; отступом под. 
первым значащим символом предыдущей не пустой строки 


Insert mode Установка по умолчанию режима вставки, а не замены сим- 
вола. Эта установка может изменяться пользователем с по- 
мощью клавиши Insert 


Use tab character Вставка при переходе к новой строке символа табуляции. 
Если этот флаг снят, то вставляются пробелы. Если установ- 
лен флаг Smart Tab, то данный флаг отключен 


Smart tab Табуляция до первого отличного от пробела символа в пре- 
дыдущей строке. Если установлен флаг Use Tab Character, то 
данный флаг отключен 


Optimal fill Оптимальное заполнение минимальным числом символов та- 
буляции и пробелов отступа строки 

Backspace unin- При нажатии клавиши Backspace в начале строки с отступом 

dents курсор переходит на отступ предыдущего уровня 


Cursor through tabs Клавиши со стрелками перемещают курсор на следующую 
позицию табуляции 


Group undo При нажатии клавиш Alt-Backspace или выполнении коман- 
ды Edit | Undo восстанавливается состояние, которое было до 
последней последовательности команд одного типа 
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Cursor beyond EOF Курсор может позиционироваться после символа конца фай- 
ла 


Undo after save Позволяет восстановить изменения после команды сохране- 
ния 


Keep trailing blanks ‚ Сохраняет пробелы, набранные вами в конце строки 


BRIEF regular ехр- Использование регулярных выражений редактора Brief 
ressions 


Persistent blocks Сохранение выделения блока даже при сдвиге курсора до 
тех пор, пока не будет выделен новый блок 


Overwrite blocks Замещение выделенного блока очередным нажатым симво- 
лом. Если одновременно установлен флаг Persistent Blocks, то 
вводимый текст добавляется в конец выделенного блока 


Double click line Выделение всей строки при двойном щелчке на каком-ни- 
будь его символе. Если этот флаг не установлен, то при 
двойном щелчке выделяется слово 


Find text at cursor Текст, на котором стоит курсор, помещается при выполне- 
нии команды поиска Search | Find в окно задания текста 


Force си! and copy Команды Edit | Cut и Edit | Copy выполняются, даже если нет 
enabled выделенного текста 


Use syntax highligh- Выделение цветом синтаксических единиц. Цвета задаются 
ting на странице Colors 


Все эти опции можно устанавливать независимо друг от друга. Но можно зада- 
вать их типичные сочетания, выбирая в выпадающем списке Editor SpeedSetting (бы- 
страя смена стиля редактора) один из пяти предопределенных стилей редактирова- 
ния: Default Keymapping (стиль по умолчанию), IDE Classic (классическая ACP), BRIEF 
emulation (эмуляция редактора BRIEF), Epsilon emulation (эмуляция редактора 
Epsilon), Visual Studio Emulation (эмуляция редактора Visual Studio). Основные разли- 
чия между этими пятью стилями определяются установкой следующих опций: 


(Crm Yeramonneme щи | 


| Default Keymapping Auto Indent Mode, Insert Mode, Cursor 
|(CTHIb по умолчанию) Through tabs, Group Undo, Overwrite 
| Blocks 


IDE Classic (классическая _ Auto Indent Mode, Insert Mode, Cursor 
| интегрированная среда разработки) Through Tabs, Group Undo, Persistent 
| Blocks 


| BRIEF emulation Auto Indent Mode, Insert Mode, Cursor 

(эмуляция редактора BRIEF) Through Tabs, Cursor Beyond EOF, Keep 
Trailing Blanks, Brief Regular Expressions, 
Force Cut And Copy Enabled 


| Epsilon emulation Auto Indent Mode, Insert Mode, Cursor 

| (эмуляция редактора Epsilon) и Through Tabs, Group Undo, Overwrite 
Visual Studio Emulation Blocks 

| (эмуляция редактора Visual Studio) 


Установки в нижней части диалогового окна позволяют задать следующие 
значения: 
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ИЕ ИА O LE TIC 


АСЯ 
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Block indent ло пробелов B отступах блоков. По умолчанию — 2, макси- 
мальное значение — 16 | 

Undo limit Объем текста, который может быть восстановлен. По умолча- 
нию 32,767 (32К) 

Tab stops ° Число символов, соответствующих позициям табуляции. Могут 
перечисляться в возрастающем порядке, с разделителями — 
запятыми 


Syntax extensions Расширения файлов, в которых используется выделение цве- 
том синтаксических элементов. По умолчанию — „серр, .с, .ce, 
-hpp, „В, .ВВ, .cxx и .hxx 


Вид страницы Display окна настройки показан на рис. 14.6. Опции этой страни- 
цы определяют отображение текста‘ файлов. 


Рис. 14.6. i Editor пои ee ee 


Страница Display в окне настройки 
Редактора Кода 


Группа Display and file options дает возможность выбрать или отказаться OT сле- 
дующих настроек: 


SIRES aS 


Brief cursor r shapes — Установка формы курсора в стиле редактора BRIEF с 


Create backup file Сохранять предыдущую — резервную копию файла при co- 
хранении редактируемых файлов. Копии файлов имеют рас- 
ширения, начинающиеся с символа «-» 


Preserve line ends Сохранять символы конца строки 


Zoom to full При развертывании устанавливать размер окна Редактора 

screen - Koga во весь экран. Если эта опция выключена, то при раз- 
вертывании окно Редактора Кода не заслоняет полосу главно- 
го меню и инструментальные панели 


Следующий опции определяют шрифт, размер и размещение текста в окне Ре- 
дактора Кода: 
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Visible right Делается видимой линия правого поля в окне Редактора Кода 
margin 
Right margin Устанавливает позицию правого поля в окне Редактора Кода. 


По умолчанию длина строки — 80 символов. Эту длину мож- 
но увеличивать до 1024 


Visible ‘gutter . Делается видимой полоска слева от текста в окне Редактора 
Кода, в которой вы щелкаете при установке точки прерывания 


Gutter width | Устанавливает ширину полоски слева от текста в окне Редак- 
тора Кода. По умолчанию — 30 


Editor font Устанавливает шрифт, используемый в Редакторе Кода. 
Обычно это шрифт постоянной ширины типа Courier. Следите, 
чтобы этот шрифт имел символы кириллицы 


Size Устанавливает размер шрифта, используемого в Редакторе Кода 


Sample Образец текста выбранного шрифта и размера 


Страница Key Mappings (рис. 14.7) позволяет установить комбинации управ- 
ляющих клавиш Редактора Кода, а также дает возможность сделать доступными 
или недоступными модули расширений, о которых будет сказано позднее. 

Опция Key mapping modules (управляющие клавиши в стиле редактора ...) име- 
ет шесть предопределенных значений, пять из которых соответствуют тем же сти- 
лям, которые устанавливаются на странице General: Default, IDE classic, Brief 
emulation, Epsilon emulation, Visual Studio emulation, New IDE Classic. Только эти стили в 
данном случае определяют не поведение редактора, а комбинации управляющих 
клавиш. Например, комбинация клавиш Ctrl-K-R в стиле по умолчанию или класси- 
ческом будет считывать блок из файла, в то время как в режиме BRIEF для этой 
цели используется комбинация А!-К. 

Список Enhancement modules содержит имена установленных модулей расшире- 
ний. Это специальные пакеты, которые регистрируются в системе и содержат ком- 
бинации управляющих клавиш. Вы можете создавать новые модули или изменять 
содержание уже установленных, используя API Open Tools. Индикаторы возле со- 
ответствующих модулей в списке позволяют делать модули доступными или не- 
доступными. 

На странице Color (цвета) вы можете определить вид выделения различных 
синтаксических элементов текста вашей программы. Как и на двух предыдущих 


Рис. 14.7. 
Страница Key Mappings в окне настройки 
Редактора Кода 
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страницах диалогового окна, здесь имеется возможность быстрого выбора настрой- 
ки из списка Color Speed Setting, где вам предоставляется выбор из предопределен- 
ных цветовых схем. Вы можете также самостоятельно выбрать установки цветов 
отдельных элементов, указывая их в списке Element. Результат всех ваших измене- 
ний в установках можно видеть в имитации окна редактора: в нижней части диало- 
гового окна. 

Можно упомянуть еще об одной настройке, введенной в C++Builder 5. Вы мо- 
жете задать формат разделительных линий, возникающих в коде, загруженном в 
окно Редактора Кода и разделяющем друг от друга отдельные функции. Чтобы за- 
дать свой формат, надо внести в текстовый файл beb.bef, размещенный в каталоге 
Bin, раздел [Code Formatting] и после этого заголовка поместить желательный вид 
разделительной линии. Например: 


[Code Formatting] 


Только учтите, что ваше изменение скажется только начиная с очередной 3a- 
грузки C++Builder. 


14.2.6 Настройка Code Insight — Знатока Кода 


Для настройки Code Insight — средства, обеспечивающего подсказки и по- 
мощь при написании и отладке кодов (см. раздел 2.5.3.1), надо выполнить коман- 
ду Tools | Editor Options и затем перейти на страницу Code Insight (рис. 14.8). 


Рис. 14.8. 
Страница Code Insight в окне настройки 
Редактора Кода 


В верхней части окна расположены индикаторы опций автоматического вы- 
полнения различных функций Code Insight: 


ый 


REESE 


x ИВР : GOEBEL, 


Code Completion Завершение кода — подсказка в виде списка свойств, MeTO- 
дов, событий, относящихся к данному компоненту 


Code Parameters — Подсказка параметров функций, процедур, методов 


Tooltip Expression Оценка выражений во время останова или пошагового выпол- 
Evaluation нения приложения BO время его отладки 


Tooltip Symbol Подсказка определений идентификаторов, над которыми пе- 
Insight ремещается курсор мыши | 
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По умолчанию автоматическое выполнение всех этих опции включено. Но вы 
можете установить в автоматический режим только те, которые вам постоянно 
нужны. Например, после того, как вы несколько освоились с C++Builder, можно 
отключить автоматическое выполнение опции Code Completion. Это исключит авто- 
матическое появление подсказок свойств, методов и событий компонентов, по- 
скольку эти подсказки в некоторых случаях мешают нормальной записи кода, а 
иногда приводят и к невольным ошибкам, подставляя в ваш код неправильные 
свойства или методы. При отключении автоматического выполнения этой опции 
вы все равно можете воспользоваться ею в любой момент, нажав клавиши Сн|-про- 
бел. Может оказаться также полезным отключить автоматическое выполнение оп- 
ции Tooltip Symbol Insight, поскольку она занимает заметное время во время работы с 
кодом и замедляет реакцию C++Builder на ваши действия. В тех сравнительно ред- 
ких случаях, когда вам понадобится эта опция, вы можете опять подключить ее. 

Ползунок Delay устанавливает задержку автоматического срабатывания Code 
Insight. Это то время, которое отводится вам для самостоятельного продолжения 
кода. Если вы задержались на большее время, появится подсказка. 

Раздел Code Templates содержит список шаблонов типичных структур языка 
С++, подсказки по которым предлагает Code Insight. Если вы выделите название и 
краткое описание одного из шаблонов в списке, то в нижнем окне сможете увидеть 
предлагаемый шаблон. Кнопка Edit позволяет вам изменить имя и краткое описа- 
ние шаблона. Сам текст шаблона вы можете изменять, не нажимая этой кнопки, а 
просто переведя курсор в нижнее окно с кодом шаблона. Кнопка Delete позволяет 
удалить шаблон из списка. Кнопка Ада дает вам возможность добавить в список 
новый шаблон. Пусть, например, вы хотите добавить шаблон управляющей струк- 
туры do...while (такой шаблон в C++Builder не встроен). Нажмите кнопку Add, и 
вам будет показано окно (рис. 14.9), в котором вы можете ввести имя шаблона 
Shortcut Мате (на рисунке — dowhile) и его краткое описание Description. Затем вы 
можете ввести текст шаблона (этот текст вы можете видеть на рис. 14.8). 


Рис. 14.9. 


Окно добавления и редактирования шаблона 


# Add Code Template 


В тексте шаблона вы можете вставить вертикальную черту в TOM месте, в KOTO- 
ром остановится курсор при вводе этого шаблона в текст. Наверное, эту черту сле- 
дует поставить в том месте, где пользователь должен будет внести первый элемент, 
заполняющий шаблон. Сама черта в этом шаблоне видна не будет. 


14.2.7 Настройка Исследователя Классов ClassExplorer 


Исследователь Классов ClassExplorer показывает дерево всех типов, классов, 
свойств, методов, глобальных переменных и глобальных функций, содержащихся 
в модуле, открытом в Редакторе Кода. В C++Builder 5 этот инструмент облегчает 
также внесение в классы новых методов, свойств, сообщений. 

Настройка Исследователя Классов производится командой Tools | Environment 
Options и переходом Ha страницу ClassExplorer (рис. 14.10). 

Опция Automatically show Explorer, определяет автоматическое появление окна 
Исследователя Классов, встроенного в окно Редактора Кода. По умолчанию эта оп- 
ция включена, но, вероятно, во многих случаях ее лучше отключить, чтобы не 
уменьшать площадь видимого окна кода. Вы всегда при необходимости можете и в 
этом случае вызвать Исследователя Кода командой View | ClassExplorer. 

Опция Show Warnings определяет отображение в ClassExplorer сообщений об 
ошибках, вследствие которых исходный код невозможно прочитать. 
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Puc. 14.10. ¢ 
Страница ClassExplorer окна 
Environment Options 


Опция Live Parsing обеспечивает обновление информации в окне Исследователя 
Кода при модификации проекта в окне Редактора Кода. Если эта опция выключе- 
на, то обновление информации происходит только когда проект сохраняется. 

Опция Parse System Include Files обеспечивает обработку всех файлов, которые 
указаны в проекте директивами #include. Если эта опция выключена (а она вы- 
‚ключена по умолчанию), то обрабатываются только файлы, указанные директива- 
ми #include <¢file.h», а системные файлы, указанные директивами F#include 
<file.h>, не обрабатываются. Включение опции может заметно замедлить работу, 
поскольку в проект может включаться очень много системных файлов. 

Опция Treat «interface» as «structy обеспечивает интерпретацию интерфейса как 
структуры. 

Опция Show Field Types задает отображение в дереве класса типов полей. A оп- 
ция Show Method Arguments отображает в дереве аргументы всех методов. 


14.2.8 Настройка отладчика 


Вызов настройки отладчика осуществляется командой Tools | Debugger Options. 
Появляется многостраничное окно настройки, показанное на рис. 14.11. 


Рис 14 1 1 Е Debugger Options 
Страница General окна настройки р. 
отладчика 

ЕТ. ‘Rearrange editot local menu оп tun pes : 
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Основная опция этого окна расположена внизу и видна на любой странице. 
Это опция Integrated debugging, обеспечивающая активацию отладчика. Если вы- 
ключить эту опцию, то ни одна из возможностей отладчика не будет реализовы- 
ваться. 

На странице General, показанной на рис. 14.11, имеются следующие опции, 
определяющие интерфейс пользователя во время работы отладчика: 


ЕЕ ПОЗА ИИ О ИИ СЯДУТ ЗАД ОИЯИ СИ ИИ р НАЯ 


Мар TD32 keystrokes Позволяет использовать клавиши карты TD32 в процессе 

оп run выполнения приложения. Установка этой опции автома- 
тически устанавливает и делает недоступной опцию Mark 
buffers read-only оп run 


Mark buffers read-only Все редактируемые файлы помечаются BO время выполне- 

on run ния приложения как файлы только для чтения. Это не 
позволяет вам во время выполнения, перейдя в ИСР, 
что-то изменить (или случайно испортить) в файлах. По- 
сле завершения приложения атрибуты файлов восстанав- 
ливаются 


Inspectors stay оп юр Оставляет все окна отладчика видимыми, даже если они 
не активны 


Disable multiple Запрещает работу сразу двух блоков оценки С++ и Pascal. 

evaluators Если эта опция установлена, то работает только блок 
оценки С++ 

Allow side effects т Разрешает побочные эффекты (например, изменение пере- 

new watches менных) в процессе наблюдения (см. раздел 2.6.4) _ 

Rearrange editor local Перестраивает контекстное меню Редактора Кода во 

menu оп run время выполнения приложения, вынося на верх разделы, 
связанные с отладчиком. Это ускоряет доступ к командам 
отладки 

Debug spawned Автоматически отлаживает процесс, порожденный отла- 

processes живаемым. Если эта опция не установлена, порожденный 


процесс запускается, но не отлаживается 


Опции группы InspectorDefaults определяют опции по умолчанию окна Инспек- 
тора Отладки (см. раздел 2.6.8). Опция Show inherited обеспечивает отображение на 
страницах окна всех свойств и методов, как объявленных в данном классе, так и 
наследуемых. Если эта опция выключена, то отображается только то, что объявле- 
но в данном классе. Опция Sort by name упорядочивает отображаемые данные в ал- 
фавитной последовательности имен. Опция Show fully qualified names обеспечивает 
отображение наследуемых элементов с их полными именами. 

Все эти опции могут быть изменены при работе с Инспектором Отладки (см. 
раздел 2.6.8). | 

Окно Debug Symbols Search Path определяет каталог, в котором сохраняются фай- 
лы символов, используемых при отладке: .tds, .rsm, .dcp. Если окно оставлено неза- 
полненным, то эти файлы хранятся вместе с выполняемым файлом проекта .exe. 

Страница Event Log окна настройки отладчика (рис. 14.12) позволяет устано- 
вить опции сообщений о событиях. Протокол этих событий, сопровождающих вы- 
полнение вашего приложения, вы можете посмотреть в процессе выполнения или 
после его окончания, выполнив команду View | Debug Windows | Event Log или нажав 
клавиши Ctrl-Alt-E (см. раздел 2.6.9). 

Следующие опции страницы Event Log, объединенные в разделе General, опре- 
деляют способ отображения событий: 
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Puc. 14.12. 
Страница Event Log окна настройки 


отладчика 

а EES SEE GEESE О В о SSSI: 
Clear log on run Очистка протокола при начале очередного сеанса отладки 
Unlimited Length Неограниченная длина отображения событий 

Length Максимальная длина отображения сообщения о событии. 


Эта опция недоступна, если выбрана опция Unlimited 


Опции раздела Messages определяют типы сообщений, которые будут зано- 
ситься в протокол событий: 


SEER I ELL RELL ELE LLL LEG SE IE 


REL LE LIL LEER LLELLE ERE BELL ENE TE EA LORE 


НОА 


Breakpoint messages `бробидения Oo прерываниях- выполнения из-за вставленных 
вами в проект точек прерывания или из-за генерации иск- 


лючений 
Process messages Сообщения о загрузке и окончании всех процессов 
Thread Messages Сообщения нитей (параллельных потоков) приложений 
Output messages Сообщения, генерируемые функцией OutputDebugString 


(см. раздел 2.6.9) 


Window messages Сообщения Windows 


Для пользователей, не собирающихся погружаться в тонкости работы систе- 
мы, можно рекомендовать установить только опции Breakpoint messages и Output 
messages. Это позволит вам отследить последовательность выполнения вашего при- 
ложения и с помощью функции OutputDebugString вывести сообщения, детали- 
зирующие состояние приложения в различные моменты времени. 

Страница Language Exceptions (рис. 14.13) позволяет управлять прерываниями 
отладки при генерации исключений в приложении. Выключение опций Stop оп Del- 
phi Exceptions и Stop Оп C++ Exceptions (останов при генерации исключений Delphi или 
C++) обеспечивает отсутствие остановов при отладке, сопряженных с появлением 
дополнительного окна сообщения об исключении. Иначе говоря, приложение в про- 
цессе отладки будет вести себя так же, как оно ведет себя при обычном запуске. 

Если опции Stop оп Delphi Exceptions и Stop On С++ Exceptions включены, TO оста- 
новы отладчика будут при любых исключениях, кроме тех, которые перечислены 
в окне Exception Types to Ignore, или их потомков. По умолчанию в список исключе- 
ний, при которых не происходит останова отладчика, входят те, которые вы види- 
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Страница Language Exceptions окна 
настройки отладчика 


Microsoft ОДО Exceptions 
VisiBroker Internal Exceptions 
CORBA System Exceptions 
CORBA User Exceptions 


те в списке на рис. 14.13, да и то не все из них отмечены. С помощью кнопки Add 
вы можете внести в список другие исключения и пометить их. Например, если вы 
внесете в список исключение EMathError, то приложение в процессе отладки не 
будет останавливаться при делении на нуль, переполнении и т.д. 

Кнопка Кетоуе позволяет удалить из списка выделенное в нем исключение. 

Страница OS Exceptions (рис. 14.14) определяет опции обработки исключений. 
Вверху страницы расположен список исключений. Вы можете добавить в него свои 
исключения, пользуясь кнопкой Ада. Кнопка Кетоуе позволяет удалить выделен- 
ное исключение из списка, но удалять можно только исключения, определенные 
пользователем. Для предопределенных в C++Builder исключений кнопка Remove 
недоступна. 

Радиокнопки Handled Бу определяют, чем будет обрабатываться исключение: 
Debugger — отладчиком, User program — программой пользователя. Радиокнопки 
On resume определяют, будет ли C++Builder продолжать обработку исключения 
(Run handled), или нет (Кип unhandled). Выбор кнопки Debugger приводит к появле- 
нию около имени данного исключения красного кружочка, а выбор кнопки Run 
Handled — к появлению зеленой стрелочки. На рис. 14.14 вы можете это видеть 
около исключения Float Divide By Zero. Сочетание этих кнопок приводит к тому, что 
стандартное сообщение об исключении в процессе отладки не появляется, даже 


Рис. 14.14. Debugger Options 


Страница OS Exceptions окна настройки 
отладчика 


In Page Еног (0хС0000006) РР 
Invalid Handle (0xC0000008) ee Bab 
No Memory (0xC000001 7) ря 
Illegal Instruction (0*хС0000010] 

Noncontinuable Exception [(0xC0000025) 

Invalid Disposition (0*С0000026] 

Anay Bounds Exceeded (0xCO00008C) 


Float Denormal Operation (OxCO00008D } 
+ Float Divide By Zero [0хС000008Е } 

Float Inexact Result (OxCO00008F) 

Float Invalid Operation (0хС0000030] 


ре 


27 зак. 322 
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если вы, вопреки предположению не предусмотрели собственную обработку. Впро- 
чем, учтите, что все это относится только к отладке. Если вы выполните приложе- 
ние не из C++Builder, то на его работу все это никак не повлияет. 

Страница Distributed Debugging связана с отладкой распределенных приложе- 
ний, которые мы в данной книге не рассматриваем. 


14.2.9 Настройка компилятора и компоновщика 


14.2.9.1 Рекомендации по сокращению времени компиляции, 
компоновки и загрузки приложения 


C++Builder предлагает вам ряд опций, обеспечивающих сокращение времен- 
ных затрат на цикл редактирования и выполнения приложения. Они могут зада- 
ваться при настройке компилятора и компоновщика с помощью команды 
Project | Options на различных страницах открывающегося диалогового окна. 

Для того, чтобы грамотно пользоваться этими опциями, полезно представлять 
себе, что происходит, когда вы, например, выполняете команду Project | Вип или на- 
жимаете клавишу Г9. При этом C++Builder выполняет следующие операции: 


1. Просмотр файлов вашего проекта с целью определить, какие из них нуждают- 
ся в обработке. 


2. Компиляция всех файлов .cpp, .pas, .asm, .rc, которые были изменены CO вре- 
мени последней компиляции. 


3. Компоновка всех объектных файлов в выполняемый файл. 
4. Загрузка выполняемого файла в память и его выполнение. 


Для ускорения этих операций C++Builder использует несколько возможно- 
стей. Прежде всего это выборочная компиляция файлов. При первой в данном се- 
ансе компиляции и компоновке приложения C++Builder запоминает для каждого 
файла отметку времени его изменения. Эта информация используется при очеред- 
ной компиляции для определения того, какие объектные файлы нуждаются в пе- 
рестроении. 

Компилируемая программа может указать, что некоторое множество заголо- 
вочных файлов, включенных в проект директивами #include, должно быть пред- 
варительно скомпилировано и сохранено в отдельном файле. Этот файл загружает- 
ся при очередной компиляции и таким образом удается избежать повторной ком- 
пиляции этих заголовочных файлов. Более того, C++Builder кэширует этот файл в 
памяти компьютера, так что даже повторная загрузка его может не требоваться. 

Пошаговый интеллектуальный компоновщик ILINK32 сохраняет информа- 
цию о произведенной компоновке в файлах выборочной компоновки .il? и при по- 
следующей компоновке загружает эту информацию. В результате заново компону- 
ются только те файлы, которые были изменены. При этом компонуются только те 
функции и переменные из подключаемых вами библиотек, которые действительно 
используются в проекте. 

Выполняемый файл .ехе формируется непосредственно в памяти. Это исклю- 
чает затраты времени на его сохранение на диске и последующую загрузку в па- 
мять для выполнения. 

Ниже приведен перечень мер, которые вы можете принять для сокращения 
временных затрат на весь цикл редактирования и выполнения приложения. 


1. Не используйте без особой необходимости команду Build All. Эта команда удаля- 
ет из памяти информацию о предыдущей компоновке, удаляет результаты 
предварительной компиляции заголовочных файлов, компилирует и компону- 
ет заново все файлы. | 
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Сохранение информации о последней произведенной компоновке существенно 
сокращает время компиляции и компоновки приложения, но может требовать 
немалого пространства на диске. Создание этих файлов выборочной компонов- 
ки 11? можно отключить, выключив опцию Don’t Generate State Files на страни- 
це Linker. При работе с одним проектом вся информация хранится в памяти. 
Поэтому включение или выключение этой опции не влияет на время компо- 
новки. Но если вы работаете с группой проектов, поочередно компилируя их, 
то хранение в файле информации о предыдущей компоновке существенно со- 
кращает время последующей компоновки. На время первой компоновки каж- 
дого из проектов опция Don’t Generate State Files не влияет. 


При работе в Windows МТ на компьютерах с оперативной памятью 32 мегабай- 
та и менее ускорить запуск приложения после его компоновки помогает вклю- 
чение опции |п-тетогу .EXE на странице Linker, обеспечивающей формирование 
выполняемого модуля в памяти без записи на диск и, соответственно, без необ- 
ходимости его последующей загрузки с диска. Windows 95 эту опцию He под- 
держивает. 


Для больших проектов существенное затягивание процессов компиляции и 
компоновки может вызвать информация отладчика C++Builder. Если вы не 
планируете при очередных прогонах приложения использовать информацию 
отладчика, можно отключить ее кнопкой Release на странице Compiler 
(рис. 14.15). В этих случаях имеет также смысл отключить интегральный от- 
ладчик — снять флажок индикатора Integrated debugger в окне Debugger Opti- 
ons, открываемом командой Tools | Debugger Options. Все это не только сократит 
время компиляции, компоновки, загрузки и выполнения, но и уменьшит за- 
траты пространства на диске. 


В C++Builder 5 введена возможность установки в Менеджере Проектов опций 
компиляции локально для отдельных модулей (см. раздел 2.4.3). Это можно 
использовать в больших проектах, отключая информацию отладчика в уже от- 
лаженных модулях и оставляя ее в отлаживаемых в данный момент. Это, в ча- 
стности, позволит существенно уменьшить затраты дискового пространства. 


Существенного сокращения времени компиляции и уменьшения затрат памя- 
ти можно добиться, используя версию библиотеки компонентов VCL, не пре- 
дусматривающую отладку. Для этого надо на странице ИпКег не включать оп- 
цию Use debug libraries. 


Заметное сокращение времени компиляции a также упрощение отладки полу- 
чается, если на странице Compiler выключить опции Code optimization — опти- 
мизацию приложения по быстродействию. 


Кардинальный способ сократить затраты времени при работе с большими про- 
ектами — увеличить оперативную память вашего компьютера до 48 — 64 мега- 
байт. 

14.2.9.2 Быстрая настройка компилятора и компоновщика 


Настройка компилятора и компоновщика осуществляется с помощью коман- 


ды Project | Options Ha различных страницах открывающегося диалогового окна Pro- 
ject Options: Compiler, Advanced Compiler, Pascal, Linker, Тазт. Если вы не хотите вда- 
ваться в особенности применения различных опций, то наиболее простой способ 
настройки — использование кнопок Full debug и Release на странице Compiler 
(рис. 14.15). Эти кнопки служат для быстрой установки совокупности опций стра- 
ниц Compiler, Advanced Compiler, Pascal, Linker, Tasmlain. Совокупность опций, соот- 
ветствующую кнопке Full debug, можно рекомендовать в процессе отладки прило- 
жения, когда не надо особо заботиться о скорости выполнения, но требуется вклю- 
чение всех возможностей отладки. Правда, при этом могут возникнуть некоторые 
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сложности, связанные с длительностью процессов компиляции и отладки и с за- 
тратами дисковой памяти, о которых говорилось в разделе 14.2.9.1. Кнопку Release 
целесообразно использовать после того, как проект отлажен и готов к эксплуата- 
ции. Она позволяет оптимизировать выполняемый файл. 

Ниже даются списки опций, устанавливаемых кнопками Full debug и Release. 
Пояснения этих опций вы найдете в следующих разделах. 

Кнопка Full debug устанавливает опции: 


Peper: 5295 Hone. с щи ном ое Kevan san | 


Compiler Enables Code optimizations|None 


Enables Debugging|Debug information 


Enables Debugging|Line number information 


Enables Debugging|Disable inline expansions 


Enables Compiling|Stack frames 


Advanced Compiler Enables Register Values|None 


Disables Code generation|Optimization 


Enables Code generation|Stack frames 


Enables Debugging|Debug information 


Enables Debugging|Local symbols 


Enables Debugging|Symbol info 


Enables Linking|Include debug information 


Опции, устанавливаемые кнопкой Release: 


afte eat adnan hac р apa 


Compiler Enables Code optimizations|Speed with scheduling 


Disables Debugging|Debug information 


Disables Debugging|Line number information 


Disables Debugging|Disable inline expansions 


Disables Compiling|Stack frames 


| Advanced Compiler Enables Register Variables|Automatic 


| Pascal Enables Code generation|Optimization 

| Disables Code generation|Stack frames 
Disables Debugging|Debug information 
Disables Debugging|Local symbols 
Disables Debugging|Symbol info 


Disables Linking|lnclude debug information 
Тот | Enables Debug Information|None 


В следующих разделах страницы настройки компилятора и компоновщика бу- 
дут рассмотрены более подробно. Но прежде, чем рассматривать отдельные страни- 
цы, следует указать, что при работе с любой страницей в левом нижнем углу окна 
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виден индикатор Default (см., например, рис. 14.15). Если его включить, то все сде- 
ланные установки будут сохраняться как установки по умолчанию для всех после- 
дующих проектов. 


14.2.9.3 Страница Сотрйег 


Эта страница, устанавливающая основные опции настройки компилято- 
ра С++, показана на рис. 14.15. Опции на ней скомпонованы в несколько групп. 

Назначение основных кнопок страницы — Full debug и Release в общих чертах 
было рассмотрено в предыдущем разделе. 

Группа опций Code Optimization на странице Compiler включает и выключает 
оптимизацию кода с точки зрения скорости выполнения. Опция None, которая 
включена по умолчанию, выключает любую оптимизацию. Это способствует уско- 
рению компиляции и не создает сложностей в отладке, связанных с тем, что ка- 
кие-то переменные и операторы кода могут быть удалены из него в результате оп- 
тимизации. 

Радиокнопка Speed устанавливает следующую группу опций оптимизации: 


Ш Inline intrinsic functions (встраивание функций inline) — эквивалент опции коман- 
дной строки -Oi. В результате ряд небольших функций встраивается в код, CO- 
кращая затраты времени на их вызов. Это ведет к более быстрому выполнению 
приложения, но увеличивает размер выполняемого файла. 


Ш Induction variables (индуцирование переменных) — эквивалент опции коман- 
дной строки -Оу. В результате оптимизируются фрагменты кода, связанные с 
циклами. 


Ш Optimize common subexpressions (оптимизация общих фрагментов выражений) — 
эквивалент опции командной строки -Og. Эта опция удаляет из кода каждой 
функции повторяющиеся в ней выражения, сохраняя их значения и исключая 
таким образом повторяющиеся вычисления. Это сокращает время вычисле- 
ний, но редко сокращает объем выполняемого файла. 


Радиокнопка Selected и нажатие кнопки Optimization вызывают диалоговое 
окно оптимизации, в котором вы можете раздельно задать или отключить перечис- 
ленные выше опции. Кроме того в этом окне вы можете установить опцию Pentium 
scheduling — эквивалент опции командной строки -OS, позволяющую учесть при 
оптимизации особенности компьютеров Pentium. Кнопка Defaults в этом окне вос- 
станавливает состояние всех опций оптимизации по умолчанию. 


Рис. 14.15. 
Страница Сотрйег окна опций проекта 
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Группа опций Warnings задает типы предупреждений компилятора, которые 
будут им выдаваться. Опция All (установлена по умолчанию) обеспечивает выдачу 
всех возникающих при компиляции предупреждений. Опция Мопе запрещает вы- 
дачу любых предупреждений. Опция Selected и нажатие кнопки Warnings вызывают 
диалоговое окно, в котором вам предлагается длинный список типов предупрежде- 
ний, любой из которых вы можете включить или выключить. 

Группа опций Debugging задает генерацию различного вида отладочной инфор- 
мации в процессе компиляции. Опция Debug information добавляет в объектные 
файлы .obj отладочную информацию. Опция Line number добавляет в объектные 
файлы .obj информацию о номерах строк исходного файла. Опция Disable inline 
expansions запрещает компилятору развертывать встраиваемые inline функции. 
При этом встраиваемые функции генерируются и вызываются как и все иные. Это 
облегчает отладку приложения. 

По умолчанию все опции группы Debugging включены. Впрочем, они будут 
обеспечивать встраивание отладки в выполняемый модуль только в случае, если 
одновременно на странице Linker включена опция Include Debug Information. Если 
ваши объектные файлы .obj получаются очень большими, вы можете уменьшить 
их размер, отключая те или иные опции отладки. При завершении работы с проек- 
том эти опции безусловно надо выключить и оттранслировать проект заново. 

Опции группы Pre-compiled headers определяют предварительную компиляцию 
заголовочных файлов. Эта возможность компилятора, рассмотренная в разде- 
ле 14.2.9.1, может существенно ускорять повторную компиляцию приложения за 
счет того, что сохраняет в файле на диске таблицу символов использованных заго- 
ловочных файлов. Но это может быть связано с большими объемами файлов на 
диске. Опция Мопе запрещает генерацию файла предварительной компиляции за- 
головочных файлов. Опция Use pre-compiled headers обеспечивает генерцию и ис- 
пользование этого файла (его имя по умолчанию — ...\lib\vel.csm). Опция Cache 
pre-compiled headers (включена по умолчанию) обеспечивает кэширование файла 
предварительной компиляции. Это полезно, если предварительно компилируется 
более одного заголовочного файла. Окно File Мате позволяет вам изменить имя по 
умолчанию файла предварительной компиляции. Это имя можно задать или с пол- 
ным путем, или с путем относительно каталога C++Builder, обозначаемого макро- 
сом $(ВСВ). Окно Stop After прерывает создание файла предварительной компиля- 
ции после того, как скомпилирован указанный в этом окне файл. Это можно ис- 
пользовать, чтобы сократить размер файла предварительной компиляции. 

Группа индикаторов Compiling устанавливает основные опции компилятора, 
которые отражаются на компиляции большинства приложений C++Builder. Оп- 
ция Merge duplicate strings дает компилятору возможность объединять две строки 
символов, следующих друг за другом, в одну строку. Это может несколько сокра- 
щать размер программы, несколько удлинять ее компиляцию, а иногда приводит к 
ошибкам при изменении вами одной из строк. 

Опция Stack frames (включена по умолчанию) заставляет компилятор генериро- 
вать стандартный стек входов и выходов функций, что облегчает отладку по шагам 
с заходом в вызываемые функции. Если выключить эту опцию, то все функции, не 
имеющие локальных переменных и параметров, компилируются с укороченной 
адресацией входов и выходов. Это сокращает код и ускоряет выполнение. Поэтому 
после окончания отладки эту опцию следует выключать. 

Опция Treat enum types as ints обеспечивает размещение переменных типа enum 
в четырех байтах. 

Опция Show general messages обеспечивает отображение всех сообщений компи- 
лятора и компоновщика, помимо предупреждений, замечаний и сообщений об 
ошибках. На отображение предупреждений и сообщений об ошибках эта опция не 
влияет. А дополнительные сообщения вряд-ли дадут вам что-нибудь ценное. 
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Опция Extended error information обеспечивает расширенную информацию о кон- 
тексте ошибок. Около сообщений появляются индикаторы с символом «+», кото- 
рые можно раскрыть для получения дополнительной информации. 


14.2.9.4 Страница Advanced Compiler 


Эта страница устанавливает дополнительные опции компилятора C++, необ- 
ходимые для приложений, использующих библиотеки компонентов (VCL). Вы мо- 
жете изменять установки на этой странице, но при этом надо соблюдать определен- 
ную осторожность, поскольку необходимо обеспечивать совместимость с УСГ. Об- 
щий вид страницы показан на рис. 14.16. 


Рис. 14.16 
Страница Advanced Compiler ee ar Tere ae ree 
окна опций проекта 


Опции на странице скомпонованы в несколько групп. Опции группы Instruction 
5е! определяют тип компьютера; для которого компилируется приложение: 80386 
(по умолчанию), i486, Pentium, Pentium Pro. | 

Опции группы Data Alignment определяют выравнивание данных в памяти: 
Byte — выравнивание по границам 8 бит, Word — 16 бит, Double Word — 32 бита, 
Quad Word — 64 бита. 

Опции группы Calling Convention определяют соглашение, используемое при 
вызове функций. Соглашения различаются способами обработки стеков, последо- 
вательностью параметров, чувствительностью к регистру, префиксами глобальных 
переменных. 

Опция С (включена по.умолчанию) соответствует соглашениям языка С — в 
частности, определяет чувствительность к регистру. Включение этой опции экви- 
валентно объявлению всех функций с ключевым словом __ с4ес1. Функции, соот- 
ветствующие соглашению С, могут воспринимать список параметров переменной 
длины. Если вы установили эту опцию, то функции, использующие другие согла- 
шения, можете объявлять ключевыми словами __ pascal, _ fastcall, __$&4саП. 

Опция Pascal соответствует соглашениям языка Pascal — в частности, опреде- 
ляет перевод идентификаторов к верхнему регистру. Включение этой опции экви- 
валентно объявлению всех функций с ключевым словом __ pascal. В результате 
вызов функций обычно короче и производится быстрее, чем при опции С. В функ- 
ции должен передаваться список параметров указанной длины и типов. Если вы 
установили эту опцию, то функции, использующие другие соглашения, можете 
объявлять ключевыми словами __cdecl, __fastcall, __ stdcall. 


840 | Глава 14 


Опция Register (J) соответствует соглашениям передачи параметров Register. 
Включение этой опции эквивалентно объявлению всех функций с ключевым сло- 
вом __fastcall. В результате, где возможно, параметры будут передаваться в реги- 
стры. Если вы установили эту опцию, то функции, использующие другие соглаше- 
ния, можете объявлять ключевыми словами __cdecl, _ pascal, _ stdcall. 

Опция Standard Call соответствует соглашениям передачи параметров Stdcall. 
Включение этой опции эквивалентно объявлению всех функций с ключевым сло- 
вом _ stdcall. В функции должен передаваться список параметров указанной дли- 
ны и типов. Если вы установили эту опцию, то функции, использующие другие со- 
глашения, можете объявлять ключевыми словами __cdecl, __ pascal, __fastcall. 

Группа опций Register Variables определяет, могут ли локальные переменные BO 
время выполнения храниться в системных регистрах. Опция Мопе (включена по 
умолчанию) запрещает хранение локальных переменных в регистрах, даже если 
вы используете для них ключевое слово register. Опция Automatic разрешает ком- 
пилятору перемещать переменные в регистры, даже если вы не указали ключевого 
слова register. Опция Register Keyword разрешает использовать регистр для пере- 
менной, только если она объявлена с ключевым словом register и ее размещение в 
регистре возможно. Опции Automatic и Register Keyword обеспечивают более быстрое 
выполнение, оптимизируя использование регистров, но могут затруднять отладку. 

Опции группы Output определяют, надо ли включать в информационный файл 
Makefile информацию о генерируемых объектных модулях (опция AUtodependency 
Information) и надо ли предварять имена функций символом подчеркивания (опция 
Generate Underscores). По умолчанию обе опции включены. 

Опции группы Floating Point позволяют оптимизировать производительность и 
точность вычислений с плавающей запятой. По умолчанию все опции этой группы 
выключены. Опция Мопе запрещает использование плавающей запятой. При этом 
нельзя использовать библиотеки функций с плавающей запятой. Если вы все-таки 
обратитесь в программе к вычислениям с плавающей запятой, вам будет выдана 
ошибка компоновки. Опция Fast разрешает оптимизировать вычисления с плаваю- 
щей запятой независимо от явного или неявного задания преобразований типов. 
Если эта опция выключена, то компилятор придерживается стандарта ANSI для 
преобразования типов. Включение этой опции может ускорить вычисления. Оп- 
ция Correct Pentium FDIV flaw позволяет исправить ошибки деления с плавающей за- 
пятой, которые были свойственны ранним кристаллам Pentium. 

Опции группы Language Compliance определяют множество воспринимаемых 
компилятором ключевых слов. Ключевые слова, не соответствующие установлен- 
ному множеству, воспринимаются компилятором как обычные идентификаторы. 

По умолчанию включена опция Borland, соответствующая расширению ключе- 
вых слов, принятому в корпорации Inprise. Это расширение включает, в частно- 
сти, ключевые слова near, far, huge, asm, cdecl, pascal, interrupt, _export, _4$, 
_CS, _SS, _eS, псевдопеременные регистров (_AX, BX и т.д.). Если в вашем коде 
обнаружены синтаксические ошибки, связанные с непониманием компилятором 
ключевых слов, проверьте прежде всего, включена ли опция Borland. 

Опция ANSI соответствует стандарту языков С и С++. Поэтому данная опция 
обеспечивает максимальную переносимость вашего кода на другие платформы. 
Опция Unix У устанавливает распознавание только ключевых слов UNIX У. Опция 
К & К устанавливает распознавание только ключевых слов расширения K&R. 

Группа опций Source управляет интерпретацией кода. Опция Nested Comments 
разрешает наличие в коде С и С++ вложенных комментариев. В стандарте С вло- 
женные комментарии не допускаются, так что их использование делает код непе- 
реносимым на другие платформы. Поэтому данная опция по умолчанию выключе- 
на. | | 

Опция MFC Compatibility позволяет компилировать код так, что он делается со- 
вместимым с классами Microsoft — Microsoft foundation classes (MFC). 
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Окно Identifier Length (2) позволяет указать число символов, которые компилятор 
будет распознавать в идентификаторах. В отличие от классического С++, в кото- 
ром распознаются идентификаторы неограниченной длины, C++Builder распозна- 
ет не более заданного числа символов идентификаторов, включая идентификаторы 
переменных, имена макросов препроцессора, имена элементов структур. Длину 
идентификаторов можно указать от 8 до 250. Если задать значение 0, оно будет 
трактоваться как 250. Учтите, что другие системы, в частности, компилятор 
UNIX, учитывает только 8 первых символов идентификатора. Так что если вы хо- 
тите написать код, переносимый на подобную платформу, лучше задать в окне 
Identifier Length (2) соответствующее число символов. Это поможет при переносе на 
другую платформу избежать ошибок, связанных с усечением длинных идентифи- 
каторов, когда разные идентификаторы начнут трактоваться как идентичные. 


14.2.9.5 Страница С++ 


Страница С++ устанавливает опции компилятора, специфические для С++ и 
необходимые для приложений, использующих библиотеку компонентов VCL. Из- 
менять настройки этой страницы можно только для приложений, не использую- 
щих VCL. Если же вы используете VCL, то изменять эти настройки нельзя. Поэто- 
му ограничимся только кратким описанием отдельных групи опций. 

Опции группы Member Pointers определяют виды указателей на размещенные в 
памяти элементы классов. Установленная по умолчанию опция All cases разрешает 
доступ к любым элементам без ограничения, что в некоторых частных случаях мо- 
жет быть не самым эффективным. 

Опции группы Compatibility определяют обратную совместимость с прежними 
версиями стандарта ANSI. Они разрешают вам перекомпилировать прежние биб- 
лиотеки. По умолчанию эти опции выключены. 

Опции группы Virtual Tables позволяют оптимизировать размер таблиц вирту- 
альных функций. Опция Templates определяет обработку компилятором шаблонов. 
Опции группы Exception Handling управляют обработкой прерываний и информации 
RTTI. Опция General устанавливается для совместимости с объектами библиотек, 
реализующими пустые базовые классы нулевого размера. 
| В большинстве случаев все опции этой страницы лучше не трогать, пока у вас 
не возникло каких-то проблем и нет уверенности, что опции этой страницы могут 
их решить. 


14.2.9.6 Страница Pascal 


Эта страница устанавливает опции компилятора Object Pascal. Они влияют на 
компиляцию модулей на языке Object Pascal, например, модулей, заимствованных 
из Delphi 5. Общий вид страницы показан на рис. 14.17. 

Опции данной страницы соответствую ключевым директивам компилятора 
языка Object Pascal. Установка той или иной опции эквивалентна включению со- 
ответствующей директивы. Подробнее 06 Object Pascal в Delphi 5 и о самой системе 
Delphi 5 вы можете узнать в книге А.Я. Архангельского «Программирование в 
Delphi 5», издательство БИНОМ, 2000, или в серии книг «Все о Delphi». 

Опции на странице Pascal скомпонованы в несколько групп. Опции группы 
Code generation влияют на способ компиляции. Опция Optimization (эквивалент ди- 
рективы {$0}) разрешает оптимизацию компиляции. Опция Aligned record fields 
(эквивалент директивы {$А}) выравнивает по границам 32 байтов поля записей. 
Опция Stack frames (эквивалент директивы {$W}) генерирует стек для всех проце- 
дур и функций. Опция Pentium-safe ЕО (эквивалент директивы {$U}) генерирует 
коды вычислений с плавающей запятой, работающие на всех процессорах 
Pentium, включая первые процессоры с ошибками. 

Опции группы Syntax options управляют обработкой синтаксических конструк- 
ций Object Pascal. Опция Strict var-strings (эквивалент директивы {$V}) устанавлива- 
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ет проверку типов коротких строк, передаваемых в функции и процедуры. Опция 
требуется только для обратной совместимости с ранними версиями C++Builder. 
При включенной опции Open parameters опция Strict var-strings не работает для от- 
крытых параметров. 

Опция Complete boolean eval (эквивалент директивы {$B}) определяет вычис- 
ление всех элементов булева выражения, даже если после вычисления первых эле- 
ментов ясен результат всего выражения — true или false. 

Опция Extended syntax (эквивалент директивы {$Х}) разрешает использовать 
функции как процедуры, игнорируя возвращаемый ими результат, а также обес- 
печивает поддержку типа Pchar. 

Опция Typed @ operator (эквивалент директивы {$Т}) управляет типом указа- 
телей, возвращаемых операцией @. 

Опция Open parameters (эквивалент директивы {$Р}) разрешает передачу от- 
крытых строк в качестве параметров процедур и функций. Опция Huge strings (эк- 
вивалент директивы {$Н}) делает возможным использование длинных строк. При 
включении этой опции тип string эквивалентен новому типу AnsiString. При вы- 
ключенной опции тип string эквивалентен типу ShortString. 

Опция Assignable typed constants (эквивалент директивы {$J}) используется для 
обратной совместимости с Delphi 1, разрешая присваивания типизированным кон- 
стантам. 

Группа опций Runtime errors определяет обработку ошибок времени выполне- 
ния. Опция Range checking (эквивалент директивы {$R}) обеспечивает проверку 
удовлетворения индексов массивов и строк заданным пределам. Опция |/О checking 
(эквивалент директивы {$1}) обеспечивает проверку каждой операции ввода/вы- 
вода. Опция Overflow checking (О) (эквивалент директивы {$Q}) обеспечивает про- 
верку переполнения при целочисленных вычислениях. 

Группа опций Debugging определяет тип отладочной информации, включаемой 
в объектные модули .Obj. После завершения отладки перед компиляцией закончен- 
ного приложения все эти опции должны быть выключены. Опция Debug information 
(эквивалент директивы {$D}) помещает отладочную информацию в файлы модулей 
.4си. Опция Local symbols (эквивалент директивы {$L}) генерирует информацию о 
локальных символах. Опция Reference info (\) (эквивалент директивы {$Y}) генери- 
рует информацию о символах. Вспомогательная опция Definition only, доступная толь- 
ко при включенной опции Reference info (Y), определяет генерацию информации толь- 
ко 06 определениях символов. Опция Assertions (С) (эквивалент директивы {$С}) 
управляет генерацией информации, связанной с процедурой Assert. 
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Группа опций Messages определяет уровень сообщений, генерируемых компи- 
лятором Object Pascal. Опция No (эквивалент директивы {$R}) определяет отсут- 
ствие сообщений. Опция Show hints обеспечивает генерацию замечаний, а опция 
Show warnings — генерацию предупреждений. 


14.2.9.7 Страница Tasm 


Эта страница устанавливает опции компилятора турбо ассемблера. Операторы 
турбо ассемблера могут помещаться в любом месте текста и нех предваряться 
ключевым словом азт. Например, 


asm mov ах, 0х0е07 


или 


mov ax, 0х0е07 
ROY DX, . DX 

int 0x10 

} 


Кроме того могут использоваться файлы .азш, целиком написанные Ha турбо 
ассемблере. 

Общий вид страницы Тазт показан на рис. 14.18. Опции на ней скомпонованы 
в несколько групп. 


Рис. 14.18. ne | it ed ~. 


Страница Tasm окна опций проекта 


Опции группы Debug Information управляют включением отладочной информа- 
ции в объектный модуль. Опция Мопе запрещает включение отладочной информа- 
ции. Опция Line Number включает номера строк, что позволяет синхронизовать ис- 
ходный код и информацию о данных. Опция Full включает все возможности отлад- 
чика для выполнения вашей программы по шагам или изменения данных. 

Опции группы Case sensitivity управляют чувствительностью к регистру. Опция 
None делает компилятор нечувствительным к регистру. Опция Globals обеспечива- 
ет чувствительность к регистру только внешних и открытых символов (external и 
public). Опция А! трактует символы во всем тексте как приведенные к верхнему 
регистру. 

Группа опций Selections определяет инициализацию и область действия ассемб- 
лера. Окно Hash table capacity задает максимально допустимое число символов фай- 
ла .азт. Это значение может изменяться в пределах 8192 — 32768. Опция Maximum 
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passes устанавливает максимальное число проходов компилятора. Оно использует- 
ся, если вы хотите, чтобы компилятор удалял команды МОР, появляющиеся при 
предварительных ссылках. Окно Maximum symbol length устанавливает максималь- 
ную длину значимых символов идентификаторов (должно быть не менее 12). Окно 
Add directive может содержать начальные директивы ассемблера, появляющиеся 
перед первой строкой текста файла. 

Группа опций Warnings устанавливает уровень появляющихся предупрежде- 
ний компилятора. Опция None исключает отображение замечаний. Опция Level | 
приводит к появлению кратких предупреждений, которые показывают, как мож- 
но повысить эффективность кода. Опция Level 2 приводит к генерации всех преду- 
преждений. 

Опция Generate Listing вызывает генерацию листинга — файла с расширением 
Ast. Если это опция включена, то остальные опции группы определяют, что имен- 
но будет включаться в файл листинга. 


14.2.9.8 Страница Linker 


; 

Общий вид страницы Linker показан на рис. 14.19. Эта страница устанавливает 
опции, управляющие компоновкой проекта, т.е. объединением файлов .obj, .lib, 
„ге; в выполняемый файл .ехе или в библиотечный файл .АП. Компоновка осущест- 
вляется пошаговым компоновщиком I[LINK32. В большинстве случаев имеет 
смысл оставлять значения опций данной страницы теми, которые заданы по умол- 
чанию. 


Рис. 14.19. 


Страница Linker окна опций проекта 


Опции на странице Linker скомпонованы в несколько групп. Индикаторы груп- 
пы Linking задают основные опции компоновки. Опция Create debug information до- 
бавляет в выполняемый модуль отладочную информацию, используемую как ин- 
тегрированным отладчиком, так и 32 битным отладчиком TD32.EXE — Turbo 
Debugger. 

Опция Use dynamic RIL означает использование в приложении библиотеки вре- 
мени выполнения RTL в виде DLL. Если включить эту опцию, компоновщик не 
присоединяет RTL к вашему выполняемому файлу. В результате выполняемый 
файл становится существенно меньше, но ваше приложение должно передаваться 
другим пользователям вместе с RTL DLL. Эту опцию имеет смысл поддерживать 
включенной в процессе отладки приложения. Но, если вы хотите создать автоном- 
ный выполняемый файл, то после завершения отладки надо перекомпоновать про- 
ект с выключенной опцией Use dynamic RTL. 
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Опция Use debug libraries означает компоновку в приложение варианта veld.lib 
библиотеки визуальных компонентов VCL, допускающего отладку. Эта опция не 
работает, если вы используете поддержку пакетов. Так что для использования 
этой опции вы должны выключить опцию Use Packages на странице Packages. Оп- 
ция Use debug libraries существенно увеличивает размер выполняемого модуля. Так 
что включать ее имеет смысл в тех редких случаях, когда вам требуется пройти по 
шагам в исходном коде библиотеки VCL. 

Опция Generate import library доступна только при разработке DLL или пакета. 
Она управляет созданием файла импорта библиотеки .lib (для DLL) или пакета .bpi 
(для пакета). Этот файл необходим для использования в дальнейшем этой библио- 
теки или пакета. Например, если приложение использует созданную вами библио- 
теку, в него надо включить соответствующий файл .lib. А при использовании ком- 
понента из установленного пакета должен быть доступен соответствующий файл 
„Бру. 

Опция Generate lib file доступна только при разработке пакета. Она говорит о 
необходимости создания файла импорта .lib, а не .bpi. Это позволит приложению, 
использующему данный пакет времени выполнения, компоновать его как DLL. 

Опция Don’t generate state files запрещает генерацию файлов выборочной компо- 
новки .il? с информацией о произведенной компоновке (см. раздел 14.2.9.1), в ре- 
зультате чего вы выиграете в дисковом пространстве, но все последующие компи- 
ляции будут проводиться так же долго, как первая. Файлы выборочной компонов- 
ки .il? создаются в каталоге, заданном опцией Final output на странице Directo- 
-ries/Conditionals. 

Окно Max errors указывает, после скольких обнаруженных ошибок компоновка 
должна прекратиться. Количество ошибок можно задать до 255. При досрочном 
прекращении компоновки вы можете не получить сообщения о всех ошибках. 

Группа опций Мар file управляет созданием файла карты приложения „тар, 
который располагается в каталоге, заданном опцией Final output на странице 
Directories/Conditionals. Опция ОН исключает генерацию файла. Опция Segments обес- 
печивает включение в файл только списка сегментов, начального адреса програм- 
мы и сообщений об ошибках компоновки. Опция Publics обеспечивает включение в 
файл помимо этого алфавитного списка открытых (public) символов. Опция 
Detailed помимо всего этого обеспечивает включение в файл детальной карты сег- 
ментов, включая адреса сегментов, их длину в байтах, имена, информацию о груп- 
пах и модулях. Индикатор Show Mangled Names помещает в файл свернутые имена 
идентификаторов С++, а не полные имена. Такие имена используются в некото- 
рых утилитах. 

Группа опций Warnings устанавливает тип замечаний, выдаваемых при по- 
строении проекта. Опция All предусматривает выдачу любых типов замечаний. Оп- 
ция Selected позволяет с помощью кнопки Warnings выбрать в списке те сообщения, 
которые желательно выдавать. 

Группа окон редактирования PE Не options указывает минимальный и макси- 
мальный размеры стека, хранящего локальные переменные и точки вызова и воз- 
врата функций (Min stack size и Max stack size), а также минимальный и максималь- 
ный размеры динамически распределяемой области памяти heap (Min heap size и 
Мах heap size). Размеры задаются шестнадцатеричными цифрами. Минимальный 
размер стека — 4К (0х1000). По умолчанию — 0х00002000. 

Окно редактирования Image Базе указывает выполняемому модулю адрес пер- 
вого объекта приложения. Все объекты выравниваются по границам 64К. Эта оп- 
ция уменьшает размер файла, ускоряет его загрузку и улучшает производитель- 
ность. Не рекомендуется использовать эту опцию при разработке DLL. Для систе- 
мы Win32 рекомендуемое значение 0х400000. Ho его не надо использовать для 
Win32s. . 
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Окна Subsystem Major и Subsystem Minor позволяют указать номер версии среды 
разработки, для которой предназначено созданное приложение. Эта информация 
помещается в заголовок файла .ехе. Например, для версии 4.2 следует задать Sub- 
system Major равным 4 и Subsystem Minor равным 2. 


14.2.9.9 Страница Advanced Linker 


Страница Advanced Linker (рис. 14.20) содержит дополнительные опции компо- 
новщика. Группа опций Advanced определяет некоторые условия компоновки. Yc- 
тановка опции Case-insensitive link определяет чувствительность компоновщика к ре- 
гистру, который используется для открытых и внешних символов. Поскольку и С, 
и С++ чувствительны к регистру, эту опцию, как правило, надо включать, но по 
умолчанию она выключена. Опция Calculate checksum задает вычисление контроль- 
ной суммы и размещение ее в результирующем файле. Это нередко требуется для 
драйверов и DLL. Опция Replace resources обеспечивает добавление или замещение 
ресурсов в выполняемом файле или DLL. 


Рис. 14.20. 
Страница Advanced Linker окна Version info Packages "Тат! | CORBA “| CodeGuad | 
опций проекта 2: Рой plication | Compe. te _ Advanced Compder | Gees 

re : te ыы a 


кинь А 


Опции User major version, User minor version и окошко Image comment позволяют за- 
нести в двоичный результирующий файл соответственно старшую и младшую 
цифры версии пользователя и комментарий. 

В окошко Dils to delay load можно занести список имен DLL, разделяемых точ- 
ками с запятой, которые компоновщик не загружает, пока не встречается вызов 
какой-то их функции. 


14.2.9.10 Страница Directories /Conditionals 


Общий вид страницы Directories/Conditionals показан на рис. 14.21. Эта страни- 
ца определяет месторасположение в компьютере файлов, используемых в процессе 
компиляции и компоновки вашего приложения. Указываются также некоторые 
данные, используемые при компиляции. Около каждого окна редактирования 
имеется кнопка со стрелочкой. Щелчок на ней позволяет осуществить выбор из 
выпадающего списка ранее внесенных данных. 

Окна группы Directories определяют каталоги различных файлов. Окно Include 
path указывает каталоги, где располагаются заголовочные файлы, используемые в 
проекте. 

Окно Library path определяет каталоги, содержащие файлы библиотек, ресурсов 
и исходные файлы модулей. 
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Рис. 14.21. 
Страница Directories/Conditionals 
окна опций проекта 


Окно Debug source path указывает каталоги, где отладчик может найти файлы 
исходных текстов. В этом окне надо указать все каталоги, в которых расположены 
тексты, компилирующиеся в вашем проекте или группе проектов. 

Окно Intermediate output определяет каталог, в котором должны располагаться 
промежуточные файлы: объектные файлы .obj и сгенерированные файлы .азт. 

Окно Final output указывает каталог, в который должен быть помещен резуль- 
тат — файл .exe, или .bpl, или .АП. Если этот каталог не указан, то результат раз- 
мещается в том же каталоге, в котором расположен файл проекта .bpr. 

Окно BPI/LIB output определяет при создании пакетов или DLL каталог размеще- 
ния файлов .bpi или .lib. Это окно используется, если генерируются файлы импор- 
та, т.е. если на странице Linker установлена опция Generate import library или Generate 
lib Не. Если окно BPI/LIB output He заполнено, то в качестве каталога используется 
каталог библиотек, заданный на странице Library окна Environment Options, которое 
открывается командой Tools | Environment Options. 

В тех из перечисленных окон, в которых может быть указано несколько ката- 
логов, эти каталоги перечисляются, разделяясь точками с запятой. Пробелы после 
точек с запятой не требуются. Длина текста не должна превышать 127 символов, 
включая пробелы. Каждый путь может быть указан полностью, или относительно 
корневого каталога C++Builder с помощью макроса $(BCB). 

Требуемые списки каталогов можно редактировать непосредственно в соответ- 
ствующем окне. Но для первых трех окнах это удобнее делать с помощью кнопок с 
многоточием справа от окна редактирования. Нажав эту кнопку, вы попадете в 
диалоговое окно, показанное на рис. 14.22. Перемещаясь по списку каталогов вы 
можете удалит кнопкой Delete любую строку. Если вы хотите добавить новую стро- 
ку или изменить прежнюю, то можете ввести новый каталог в нижнее окно редак- 
тирования. Если при этом вам надо посмотреть дерево каталогов вашего компьюте- 
ра, нажмите кнопку с многоточием около этого окна. Откроется обычный для 
Windows диалог, в котором вы можете выбрать каталог и нажать после этого ОК. 
Тогда вы вернетесь в окно на рис. 14.22, в котором станут доступны кнопки Replace 
и Ада. Первая из них заменит выделенный в верхнем окне каталог на введенный в 
нижнее окно, а вторая добавит новый каталог к списку. Нажав после всех этих 
операций кнопку ОК, вы вернетесь в исходное окно рис. 14.21, в котором появится 
отредактированная вами строка. 

Окно Conditionals страницы Directories/Conditionals (рис. 14.21) определяет усло- 
вия, используемые препроцессором при условной компиляции кодов с директива- 
ми #ifdef, #1 и др.. Если вам надо просто определить некоторый идентификатор, 
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>. Directories 


Puc. 14.22. 
Диалоговое окно списка каталогов 


D:\Progratn Files\Borland\Rampe 


: [D:\Program Files\Borl d\R e\Projects\ 


чтобы проверять его, например, директивой #Hifdef, достаточно написать этот иден- 
тификатор в окне Conditionals. Если вам надо присвоить идентификатору некоторое 
значение, которое будет, например, проверяться директивой #И, то соответствую- 
щее значение присваивается символом равенства «=». Отдельные определения и 
присваивания разделяются запятыми. В примере на рис. 14.21 Определен иденти- 
фикатор Debug, а идентификатору Var присвоено значение 1. Так что в тексте 
приложения сработают директивы 


#ifdef Debug 


и 
#1Е Var== Г 


Окно Aliases страницы Directories/Conditionals позволяет задать псевдонимы для 


модулей Object Pascal, имена которых изменены. Синтаксис задания псевдонима: 
<прежнее имя>=<новое имя>. 


14.2.10 Общие настройки среды 


Многостраничное окно настройки вызывается командой Tools | Environment Opti- 
ons. На рис. 14.23 приведена его страница Preferences — общие настройки среды 
проектирования. 


Рис 14 23 nvironment Opti 
Страница Preferences окна Environment 
Options 
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Опции на ‘странице Preferences скомпонованы в несколько групп. Группа 
Compiling определяет выполнение компиляции и компоновки. Опция Show Compiler 
Progress отображает диалоговое окно хода выполнения компиляции. Опция Веер оп 
completion осуществляет звуковой сигнал по окончании компиляции. Опция Cache 
headers on startup обеспечивает предварительную компиляцию в оперативной памяти 
заголовочных файлов, что сокращает затраты времени на последующие компиля- 
„ ции (см. раздел 14.2.9.1). Опция Warn on package rebuild приводит к появлению пре- 
дупреждения, если во время компиляции происходит перестроение пакетов. Опция 
Background Compilation задает выполнение всех команд компиляции (кроме Run) в фо- 
новом режиме. Достоинства и недостатки этого обсуждаются в разделе 2.6.1. 

Опции группы Autosave options определяют, что сохраняется при выполнении 
приложения и выходе из C++Builder. Включение опции Editor Files (редактируемые 
файлы) приводит к тому, что при каждом выполнении приложения и при выходе 
из C++Builder автоматически сохраняются все модифицированные в Редакторе 
Кода файлы. Это иногда может быть опасным, так как могут сохранятся помимо 
вашего желания какие-то неудачные исправления в программе, которые после тес- 
тирования вы хотели бы отменить. С другой стороны, это гарантирует сохранение 
файлов в случае, если ваше еще не отлаженное приложение при его выполнении 
приведет к сбою системы. 

Если вы включите опцию Project desktop (состояние экрана), то при очередном 
запуске C++Builder загрузится ваше последнее приложение и откроются все окна, 
которые были открыты в момент выхода из C++Builder. Это очень удобно, если вы 
намерены продолжать работу над тем же приложением. 

Опции проектирования формы Form designer определяют сетку формы и ярлыч- 
ки компонентов. Опция Display grid делает видимыми узлы сетки на форме. Уста- 
новка опции Snap to grid приводит к тому, что компоненты при их размещении ав- 
томатически привязываются к узлам сетки. При этом компоненты невозможно 
разместить между узлами. 

Окна редактирования Grid size хи Grid size у определяют шаг сетки по горизон- 
тали и вертикали. Шаг может задаваться в пределах от 2 до 128. 

Опция Show component captions делает видимыми надписи компонентов. Опция 
Show desiner hints делает видимыми ярлычки с именами, типом и размерами компо- 
нентов. 

Опция New forms as text определяет, в каком виде — текстовом (если опция ус- 
тановлена) или двоичном сохраняется файл описания формы .dfm. Текстовый фор- 
мат легче может модифицироваться различным инструментарием, в частности, 
системой управления версиями. Зато двоичный формат имеет лучшую обратную 
совместимость с более ранними версиями C++Builder. 

Опция AutoCreate Forms определяет, будут ли новые формы проекта (кроме пер- 
вой) рассматриваться как автоматически создаваемые (Auto Create), или как воз- 
можные (Available Forms). В дальнейшем это можно изменить на странице Forms оп- 
ций проекта. | 

Опции группы Running определяют состояние UCP C++Builder в процессе вы- 
полнения приложения. Установка опции Minimize оп run приводит к свертыванию 
C++Builder при выполнении приложения. Когда приложение закрывается, 
C++Builder восстанавливается. Опция Hide designers on run делает невидимыми 
окна проектирования (Инспектора Объектов и формы) при выполнении приложе- 
HUA. 

Окно Directory определяет местонахождение файла депозитария объектов. Если 
каталог не указан, C++Builder ищет этот файл в своем каталоге BIN. 

Страница Library окна Environment Options (рис. 14.24) содержит списки катало- 
гов, в которых ищутся файлы, используемые в проектах. Если указывается не- 
сколько каталогов, то они перечисляются, разделяясь точками с запятой. Пробелы 
после точек с запятой не требуются. Длина текста не должна превыптать 127 сим- 
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Рис. 14.24. P 
' (Страница Library в окне настройки среды ‘ 
разработки 
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волов, включая пробелы. Каждый каталог может быть указан с полным путем, 
или относительно корневого каталога C++Builder с помощью макроса $(ВСВ). 

Кнопки со стрелками справа от окон редактирования позволяют выбрать ката- 
лог из числа ранее записанных в эти окна. 

Требуемые списки каталогов можно редактировать непосредственно в соответ- 
ствующем окне. Но для первого и четвертого окна, в которые можно заносить не- 
сколько каталогов, это удобнее делать с помощью кнопок с многоточием. Нажав 
эту кнопку, вы попадете в диалоговое окно, описанное ранее в разделе 7.9.10 и по- 
казанное на рис. 7.22. 

Каталоги, указываемые в окнах страницы Library, означают следующее: 


а О О О О ОВС Бы а ILIA ааа AEELEAE RESET IIB. 


Library path Каталоги, в которых расположены. ‘заголовочные и библиотеч- 
ные файлы компонентов и пакетов. В набор этих каталогов сле- 
дует включать: 


Каталог Include Path заголовочных файлов, используемых библио- 
rekon VCL 


Каталог Library Path объектных файлов VCL, файлов ресурсов, 
файлов модулей C++Builder 


Каталоги всех библиотек, которые вы используете в своих про- 


ектах 
BPL output Каталог, в который компилятор должен поместить файл .bpl 
directory компилируемого пакета 


BPI/LIB output Каталог, в котором по умолчанию должны размещаться файлы 
path пакетов .bpi и .lib. Это значение каталога по умолчанию в даль- 
нейшем может быть изменено для каждого пакета его опциями 


Browsing path Каталоги, в которых ищутся файлы, содержащие идентификато- 
ры проекта 
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14.3. Страницы библиотеки компонентов 


В этом разделе приведены те страницы библиотеки, компоненты которых рас- 
сматриваются или упоминаются в данной книге. 


14.3.1 Страница Standard 


Страница Standard содержит ряд часто используемых компонентов общего Ha- 
значения. 


Компонент Тип Описание 


Панель с возможностями наследования. 
Проектируется как отдельное окно. Компо- 
нент визуальный. 

главное меню | MainMenu Позволяет конструировать и создавать по- 
лосу главного меню формы и выпадающие 
меню. Компонент невизуальный. 


всплывающее |PopupMenu |Позволяет конструировать и создавать 
меню всплывающие контекстные меню, возника- 
ющие при нажатии пользователем правой 


кнопки мыши. Компонент невизуальный. 


Используется для размещения на формах и 
других контейнерах текста, который не из- | 
меняется пользователем. Компонент визуа- | 
льный. 


окно редакти- Используется для ввода пользователем од- 

рования нострочных текстов. Может использоваться 
для отображения текста. Компонент визуа- 
льный. 


многострочное Используется для ввода и отображения 
окно редакти- многострочных текстов. Компонент визуа- 
рования льный. 


командная Button Используется для создания кнопок, KOTO- 
кнопка рыми пользователь выбирает команды в 
приложении. Компонент визуальный. 


контрольный | Checkbox Позволяет пользователю включать и вы- 
индикатор с ключать различные опции. Компонент ви- 


флажком зуальный. 


радиокнопка | RadioButton | Предлагают пользователю набор альтерна- | 
тив, из которых выбирается одна. Набор | 
реализуется требуемым количеством радио- | 
кнопок, размещенных в одном контейнере | 
(форме, панели ит.п.). Компонент визуаль- | 
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Компонент Описание 


окно списка || ListBox Представляет собой стандартное окно спис- 
ка Windows, позволяющее пользователю 
выбирать разделы из списка. Компонент 
визуальный. 


редактируе- ComboBox Объединяет функции ListBox и Edit. Поль- 
мый список зователь может либо ввести текст, либо вы- 
брать его из списка. Компонент визуаль- 


ный. 


линейка Scrollbar Представляет собой стандартную линейку 
прокрутки прокрутки Windows и служит для управле- 
ния положением видимой части форм или 


компонентов. Компонент визуальный. 


групповое GroupBox Является контейнером, объединяющим 

окно группу связанных органов управления, та- 
ких как радиокнопки RadioButton, конт- 
рольные индикаторы Checkbox и т.д. Ком- 


понент визуальный. 


группа RadioGroup |Является комбинацией группового окна | 
радиокнопок GroupBox с набором радиокнопок Radio- 
Button; служит специально для создания 
групп радиокнопок. Можно размещать в 
компоненте несколько радиокнопок, но ни- 
какие другие органы управления не разре- 
шены. Компонент визуальный. 


панель Panel Является контейнером для группирования 
органов управления и меньших контейне- 
ров. Панель можно использовать также 
для построения полос состояния, инстру- 
ментальных панелей, палитр инструмен- 
тов. Компонент визуальный. 


список ActionList Обеспечивает диспетчеризацию событий 
событий компонентов. Компонент невизуальный. 


Страница является дополнением страницы Standard и содержит ряд часто ис- 
пользуемых компонентов общего назначения 


Используется для создания кнопок, на ко- 


торых располагается битовая графика (на- 
пример, кнопка ОК с галочкой). Компонент 
визуальный. 
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| Компонент Описание 


кнопка SpeedButton | Используется для создания инструменталь- 


с фиксацией ных панелей и в других случаях, когда 


' требуется кнопка с фиксацией нажатого со- 
стояния. Компонент визуальный. 


маскирован- | MaskEdit Используется для форматирования данных 
ный ввод или для ввода символов в соответствии с 
шаблоном. Компонент визуальный. 
таблица строк |StringGrid —| Используется для отображения текстовой 
‚ | информации в таблице из строк и столб- 
цов. Компонент визуальный. 

таблица DrawGrid Используется для отображения в строках и 

рисунков столбцах нетекстовых данных. Компонент 

визуальный. 

изображение | Image Используется для отображения графики: 

пиктограмм, битовых матриц и метафай- 
лов. Компонент визуальный. 

Shape Используется для рисования фигур: квад- 
ратов, кругов и т.п. Компонент визуаль- 
ный. 

Bevel Используется для рисования выступающих 
или утопленных линий или прямоуголь- 
ных рамок. Компонент визуальный. 


ScrollBox 


CheckList- 


Используется для создания зон отображе- 
ния с прокруткой. Компонент визуальный. 


окно с про- 
круткой 


Компонент является комбинацией свойств 
списка ListBox и индикаторов CheckBox в 
одном компоненте. Компонент визуальный. 


список с 
флажками 


Вох 
Используется для создания в приложении 
панелей с изменяемыми пользователем раз- 


я мерами. Компонент визуальный. 
StaticText Компонент подобен компоненту Label, Ho 
обеспечивает дополнительные возможности 
по заданию стиля бордюра. Компонент ви- 
зуальный. 
ControlBar | Используется для размещения компонентов 
инструментальной панели. Компонент ви- 
зуальный. 


события при- | Application- | Перехватывает события на уровне прило- 
ложения Events жения. Компонент невизуальный. 


диаграммы us| Chart Компонент принадлежит к семейству KOM- 
графики понентов TChart, которые используются 
для создания диаграмм и графиков. Компо- 


нент визуальный. 


разделитель 
панелей 


метка с бор- 
дюром 


инструмента- 
льная панель 


de 
а 
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Страница Win32 содержит компоненты общего назначения, позволяющие раз- 
рабатывать приложения в стиле Windows 95/98/2000 и МТ 4.х. Некоторые из этих 
компонентов аналогичны имеющимся на странице \\т3.1. 


з а 2 


| Компонент Описание 


страница 
с закладкой 


многостранич- 


ное окно 


список 
изображений 


окно редакти- 
рования в 
формате RTF 


ползунок 


отображение 
хода процесса 


кнопка-счет- 


-- UMK 


«горячие» 
клавиши 


воспроизведе- 
ние немых 


клипов 


ввод дат 
и времени 


ввод дат 


дерево 


| PageControl 


TabControl | Позволяет организовывать страницы с 3a- 
кладками в стиле Windows, которые мо- 
жет выбирать пользователь. Компонент ви- 


зуальный. 


Позволяет создавать страницы в стиле 
Windows, управляемые закладками или 
иными органами управления, для эконо- 
мии места на рабочем столе. Компонент 
визуальный. 


ImageList Предназначен для работы со списками 
изображений одинакового размера в меню, 
инструментальных панелях и т.п. Компо- 
нент невизуальный. 


RichEdit Представляет собой окно редактирования в 
стиле Windows, позволяющее производить 
выбор цвета и шрифта, поиск текста и 
многое другое. Компонент визуальный. 


TrackBar Управляющий элемент в виде ползунка в 


стиле Windows. Компонент визуальный. 


ProgressBar | Используется для отображения в стиле 
Windows хода процессов, занимающих за- 
метное время. Компонент визуальный. 

UpDown Кнопка-счетчик в стиле Windows для BBO- 
да целых чисел. Компонент визуальный. 


HotKey Дает возможность реализовать в приложе- 
нии поддержку горячих клавиш. Компо- 
нент визуальный. 


Используется для воспроизведения немых 
клипов АУТ, подобных используемым в 

Windows изображениям копирования фай- 
лов ит.п. Компонент визуальный. 


DateTime- 
Picker 


MonthCalen- 


Ввод дат и времени с выпадающим кален- 
дарем. Компонент визуальный. 


Ввод дат с выбором из календаря. Компо- 
нент визуальный. 


Предоставляет возможность просмотра 
структуры иерархических данных в стиле 
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о ее, ЕЕ == = 


заголовок 


Полоса состояния программы, при необхо- 
димости — на нескольких панелях. Ком- 
понент визуальный. 


<j полоса 
| < состояния 


=== прокрутка 
и | страниц 


HeaderCont- | Позволяет создавать составные перемещае- 
инструмен- ToolBar 
тальная па- | 
нель приложения. Компонент визуальный. | 

| 
| 
страиваемая 
пример, инструментальных панелей. Ком- 


| Компонент Описание 
rol мые заголовки в стиле Windows. Компо- 
Инструментальная панель для быстрого 
инструмен- CoolBar Контейнер инструментальной панели, раз- 
меры которой могут изменяться пользова- | 
e телем. Компонент визуальный. | 
панель ; 
понент визуальный. 


MII | 
| 
List View Отображает списки в стиле Windows. Ком- | 
понент визуальный. | 
| 
нент визуальный. 
StatusBar 
доступа к часто используемым функциям 
тальная пере- 
PageScroller | Обеспечивает прокрутку больших окон, на- 


Страница System содержит компоненты, позволяющие использовать системные 
средства Windows. 


Описание 


Используется для запуска процедур, 
функций и событий в указанные интер- 
валы времени. Компонент невизуаль- 
ный. 


окно для Рашё Вох Используется для создания на форме 
рисования некоторой области, в которой можно 
рисовать. Компонент визуальный. 


| Компонент 


аудио и видео | MediaPlayer Используется для создания панели 

плеер управления воспроизведением звуко- 
вых и видео файлов, а также устройств 
мультимедиа. Компонент визуальный. 


контейнер OLE | OLEContainer Используется при создании области 
клиента для объекта OLE. Компонент 
визуальный. 


диалог с DDEClientConv |Используется клиентом DDE для орга- 
сервером DDE низации диалога с сервером ОПЕ. Ком- 
понент невизуальный. 
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Компонент Описание 


данные, DDEClientItem | Используется для определения данных 
передаваемые 
серверу DDE 


клиента, передаваемых в диалоге серве- 
ру DDE. Компонент невизуальный. 


DDEServerConv | Компонент используется сервером DDE 
при проведении диалога с клиентом 


DDE. Компонент невизуальный. 


диалог с 
клиентом DDE 


ОрЕ$егуег Цет 


данные, 
передаваемые 
клиенту DDE 


Компонент используется для определе- 
ния данных сервера, передаваемых 
клиенту ОПЕ в течение диалога. Ком- 
понент невизуальный. 


Страница Data Access — доступ к данным, содержит компоненты управления 
обменом информацией между приложением и базами данных. 


источник DataSource | Используется для соединения компонентов 

данных типа Table или Query с компонентами, OTO- 
бражающими данные. Компонент невизу- 
альный. 


набор данных | Table Используется для установления связи при- 
ложения с таблицей базы данных. Компо- 
нент невизуальный. 


запросы ЗОГ |®@иегу Используется для построения и выполне- 
я ния SQL-3ampocoB к удаленным SQL-cepBe- 
| рам или локальным базам данных. Компо- 


нент невизуальный. 


хранимые StoredProc | Используется для выполнения процедур, 
процедуры хранимых на SQL-cepBepe. Компонент не- 


визуальный. 


связь с Database Используется для установления связи с 
сервером удаленными серверами баз данных. Компо- 
нент невизуальный. 


сеанс работы с | Session Используется для обеспечения глобального 
данными управления соединениями приложения с 


базами данных. Компонент невизуальный. 


локальная BatchMove |Позволяет работать с записями и таблица- 
работа с ми локально, а затем передавать обновлен- 
данными ную информацию обратно на сервер. Ком- 


понент невизуальный. 
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-- 


| Компонент 


изменение 
базы данных базы данных SQL. Компонент невизуаль- 
ный. 


Описание 


вложенные 
таблицы 


Страница Data Controls содержит компоненты, связанные с данными и предна- 
значенные для отображение, ввода и редактирования содержимого баз данных. 
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Компонент 


таблица Используется для создания ориенти- 

данных рованных на данные таблиц с отобра- 
жением данных в строках и столбцах. 
Компонент визуальный. 


навигатор DBNavigator Используется для управления про- 
смотром и редактированием базы дан- 
ных. Компонент визуальный. 

DBText Представляет собой ориентированный 
на данные вариант метки Label. Ком- 
понент визуальный. 

окно редакти- | DBEdit Представляет собой ориентированный 
рования на данные вариант окна редактирова- 
ния Edit. Компонент визуальный. 
окно редакти- | DBMemo Представляет собой ориентированный 
рования Мето на данные вариант многострочного 
окна редактирования Memo. Компо- 
нент визуальный. 
изображение | DBImage Представляет собой ориентированный 
на данные вариант компонента Image. 
Компонент визуальный. | 
список ОВ {Вох Представляет собой ориентированный | 
на данные вариант компонента List- 
Вох. Компонент визуальный. 
редактируе- DBComboBox Представляет собой ориентированный 
мый список на данные вариант компонента Сот- 
boBox. Компонент визуальный. | 
индикатор DBCheckBox Представляет собой ориентированный | 
на данные вариант компонента Check- | 
Вох. Компонент визуальный. | 
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rpynna DBRadioGroup Представляет собой ориентированный 
радиокнопок на данные вариант компонента Radi- 
oGroup. Компонент визуальный. 


создание DBLookupList- Предназначен для создания окна List- 
списка Вох Вох, ориентированного на данные. 
Компонент визуальный. 


создание ре- DBLookupCombo- | Предназначен для создания окна Сот- 
дактируемого |Вох boBox, ориентированного на данные. 
списка Компонент визуальный. 


окно формата | DBRichEdit Представляет собой ориентированный 
RTF на данные вариант компонента RichE- 
dit. Компонент визуальный. 


gs гибкая табли- | DBCtriGrid Используется для создания таблицы 
eH ца данных данных, более гибкой, чем DBGrid. 
Компонент визуальный. | 
= ГИСТОГраммы, | DBChart Представляет собой ориентированны 
& графики на данные вариант компонента Char 
Компонент визуальный. 


Страница ADO, появившаяся только в C++Builder 5, содержит копоненты для 
связи с базами данных через Active Data Objects (ADO) — множество компонентов 
ActiveX, использующих для доступа к информации баз данных Microsoft OLE DB. 
Эти компоненты являются альтернативой компонентам, использующим BDE и 
размещенным на странице Data Access. 


Компонент Описание 


соединение ADOConnection | Используется для связи с набором дан- 
ных ADO. Может работать с несколь- 
кими компонентами наборов данных 
как диспетчер выполнение их команд. 
Компонент невизуальный. 


команды SQL | ADOCommand |Используется в основном для выполне- 
ния команд SQL, He возвращающих 
множество результатов. Может также 
совместно с другими компонентами ис- 
пользоваться для работы с таблицами. | 
Может связываться с набором данных 
непосредственно, или через ADOCon- 
nection. Компонент невизуальный. 
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универсальный | ADODataSet Универсальный компонент связи с Ha- 

набор данных борами данных, который может рабо- 
тать в различных режимах, заменяя 
связанные с BDE компоненты Table, 
Query, StoredProc. Компонент невизу- 
альный. 

набор данных | ADOTable 
ты с одной таблицей. Компонент неви- 
зуальный. 

запросы SQL ADOQuery Используется для работы с набором 
данных с помощью запросов SQL. Ком- 
понент невизуальный. 

хранимые ADOStoredProc | Используется для выполнения проце- 

процедуры дур, хранимых на сервере. Компонент 

невизуальный. 


Аналог Table, используемый для рабо- 


объект RDS 


Представляет объект RDS DataSpace и 
используется в многопоточных прило- 
жениях. Компонент невизуальный. 


Страница InterBase, появившаяся только в C++Builder 5, содержит компонен- 
ты для работы с InterBase напрямую, минуя BDE. Эти компоненты обеспечивают 
повышенную производительность и позволяют использовать новые возможности 
сервера InterBase 5.5, недоступные обычным компонентам BDE. 


ры? _ [Ти = |Описание _ Описание 


набор данных |IBTable Используется вместо Table для доступа к 
одной таблице набора данных. Компонент 
невизуальный. 


запросы SQL IBQuery Используется вместо Query для выполне- 
ния запросов SQL. Компонент невизуаль- 
ный. — 

хранимые IBStoredProc | Используется для выполнения процедур, 
хранимых на сервере. Компонент невизуа- 
льный. 


процедуры 
IBDatabase Обеспечивает соединение с базой данных 
InterBase. Компонент невизуальный. 


IBTransacti- 
on 


соединение с 
InterBase 


транзакции Управляет транзакциями. Поддерживают- 
ся распределенные транзакции со множе- 
ством баз данных. Компонент невизуаль- 


ный. 
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изменение IBUpdateSQL | Используется для изменений в таблицах 
данных, только для чтения и для кэширования из- 
кэширование | менений. Компонент невизуальный. | 


набор данных | IBDataSet Набор данных, обеспечивающий эффек- 
тивный доступ к данным. Компонент не- 
визуальный. 


запросы SQL Выполняет запросы SQL, минимизируя 
затраты буферизации и обмена данными с 
компонентами Delphi. Обеспечивает наи- | 
более эффективный доступ к данным Ш- 
{егВазе. Компонент невизуальный. 


информация IBDatabase-. | Позволяет приложению затребовать ин- 
Info формацию о базе данных и сервере Inter- 
Вазе. Компонент невизуальный. 


мониторинг IBSQLMoni- | Позволяет осуществлять отладку комму- 
tor никаций для ускорения работы проектов 
клиент/сервер и проектов с параллельны- 

ми потоками. Компонент невизуальный. 


|8 IBEvents Обеспечивает асинхронную обработку co- 
| 1875 бытий сервера InterBase. Компонент неви- | 
| зуальный. 


— 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Страница Decision Cube содержит компоненты для проведения многомерного 
анализа данных, хранимых в базах данных. 


многомерный | DecisionCube Связь с базой данных и реализация мно- 

Ри гомерного куба — основы многомерного 
анализа данных. Компонент невизуаль- 
ный. 


набор данных | DecisionQuery |Набор данных, на основании которого 
проводится анализ. Компонент невизу- 
альный. 


источник DecisionSource | Источник многомерных данных — по- 

данных средник между DecisionCube и компо- 
нентами отображения данных. Компо- 
нент невизуальный. 


управление DecisionPivot 


таблица DecisionGrid Табличное отображение данных. Компо- 
нент визуальный. 


® 
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Компонент Описание 


| Компонент Описание 


QuickRep Используется для введения в приложе- 
ние средств печати отчетов QuickReport. 
Компонент невизуальный. 


QRSubDetail Используется для компоновки в отчет 
дополнительных данных. Компонент 
визуальный. 


полоса текста |QRStringsBand | Используется для компоновки в отчет 
дополнительных текстов. Компонент 
визуальный. 


полоса QRBand Используется для построения отчетов 
путем размещения на нем печатаемых 
компонентов. Компонент визуальный. 
дочерняя QRChildBand Используется для создания дочерних 
полоса полос, которые могут содержать другие 
компоненты QuickRep и полосы. Ком- 
понент визуальный. 


группировка /|QRGroup _ | Используется для группировки данных. 
Компонент невизуальный. 
QRLabel Используется для размещения текста в | 
отчете. Компонент визуальный. 


| 

| 

текст из базы | QRDBText Представляет собой ориентированный | 

данных на данные компонент для размещения | 

текста в отчете. Компонент визуаль- | 

ный. | 

матеметиче- QRExpr Позволяет строить и отображать выра- | 

ские выраже- жения над полями данных и системны- | 

ния ми величинами (такими, как время и | 

дата). | 

вси | 

‘3 системные QRSysData Используется для отображения систем- | 

-$¥$ данные | ных данных. Компонент визуальный. | 

| 

2 многостроч- QRMemo Используется для размещения в отчете | 
ный текст многострочных текстов. Компонент ви- 

| зуальный. 
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Компонент 


тексты с мате- | QRExprMemo 


матическими | 
QRRichText 


выражениями 
QRDBRichText 


QRShape 
QRImage Используется для печати изображений 
в отчете. Компонент визуальный. 


QRDBImage Используется для печати изображений 
из баз данных в отчете. Компонент ви- 
зуальный. 

QRComposite- | Используется для построения состав- 

Report ных отчетов. Компонент визуальный. 

QRPreview Используется для предварительного 

| просмотра на экране подготовленного к 
печати отчета. Компонент визуальный. 

QRTextFilter Используется для установки фильтра 

текста. Компонент невизуальный. 


разделитель QRCSVFilter Используется для установки разделите- 


as ля текста. Компонент невизуальный. 
фильтр HTML | QRHTMLFilter 
Используется для печати в отчете диа- 
грамм, построенных на основе баз дан- 


QRChart 
ных. Компонент визуальный. 


Описание 


Используется для размещения в отчете 
текстов с математическими выражения- 
ми. Компонент визуальный. 


многостроч- 
ный текст ВТЕ 


Используется для размещения в отчете 
текста в обогащенном формате Rich- 
Text. Компонент визуальный. 


многостроч- 
ный текст RTF 
базы данных 


Используется для размещения в отчете 
текста из базы данных в обогащенном 

формате RichText. Компонент визуаль- 
ный. 


Используется для рисования в отчете 
графических форм. Компонент визуаль- 
ный. 


изображение 


изображение 
из базы дан- 
ных 


ЕН составной 
= отчет 


предваритель- 
ный просмотр 


фильтр текста 


Используется для установки фильтра 
HTML. Компонент невизуальный. 


диаграммы, 
графики 


Страница Dialogs содержит компоненты, используемые для создания различ- 
ных диалоговых окон, общепринятых в приложениях Windows. Диалоги исполь- 
зуются для указания файлов или выбора установок. Применение поставляемых в 
составе Delphi диалоговых окон помогает сэкономить время на разработку и при- 
дать вашему приложению совместимость с принятыми в Windows нормами диало- 
га. 
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«Открыть OpenDialog Предназначен для создания окна диало- 
файл» га «Открыть файл». Компонент невизуа- 
льный. 


«Сохранить SaveDialog Предназначен для создания окна диало- 
файл как...» га «Сохранить файл как». Компонент 
невизуальный. 


«Открыть OpenPictureDi- | Предназначен для создания окна диало- 
рисунок» alog га «Открыть рисунок». Компонент неви- 
зуальный. 


«Сохранить SavePictureDi- | Предназначен для создания окна диало- 
рисунок alog га «Сохранить рисунок как». Компонент 
как...» невизуальный. 


«Шрифты» FontDialog Предназначен для создания окна диало- 


га «Шрифты». Компонент невизуаль- 
ный. 


ColorDialog Предназначен для создания окна диало- 
га «Цвет». Компонент невизуальный. 


«Печать» PrintDialog Предназначен для создания окна диало- 
га «Печать». Компонент невизуальный. 


«Установка PrinterSetup- |Предназначен для создания окна диало- 
принтера» ‘| Dialog га «Установка принтера». Компонент 
невизуальный. 


«Найти» FindDialog Предназначен для создания окна диало- 
га «Найти». Компонент невизуальный. 


«Заменить» ReplaceDialog |Предназначен для создания окна диало- 
га «Заменить». Компонент невизуаль- 
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Страница Win3.] содержит компоненты, предназначенные для приложений 
Windows 38x. В 32-разрядных приложениях компоненты данной страницы приме- 
нять не рекомендуется. 


Компонент Tm [Описание 


блокнот с Используется для создания блокно- 
закладками та с закладками. Компонент визуа- 
льный. 


окно дерева Позволяет отображать иерархиче- 
ские данные в форме дерева. Компо- 


нент визуальный. 


Bh 
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| Компонент Тип | Описание | 


многостранич- | TabbedNoteBook Используется для создания много- 
ная форма страничных форм с закладками. 
Компонент визуальный. 


пачка страниц | NoteBook Используется для создания пачки 
страниц, может применяться совме- 
стно с TabSet. Компонент визуаль- 
ный. 
заголовок ды Используется для отображения тек- | 
ста в областях переменного размера. | 
Компонент визуальный. | 
| 
список файлов | FileListBox Отображает список файлов катало- | 
га. Компонент визуальный. | 
| 


структура DirectoryListBox Отображает структуру каталогов ди- | 
каталогов ска. Компонент визуальный. 


| 


список дисков | DriveComboBox Выпадающий список доступных ди- 
сков. Компонент визуальный. 


список FilterComboBox Выпадающий список фильтров для 
фильтров поиска файлов. Компонент визуаль- 
ный. 


списка данных ний в таблице данных с помощью 
окна списка. Компонент визуаль- 
ный. 


создание ре- DBLookupCombo Предназначен для просмотра значе- 
дактируемого ний в таблице данных с помощью 
списка данных выпадающего списка. Компонент ви- | 


| 

| 

| 

создание DBLookupList Предназначен для просмотра значе- 
| 

зуальный. 


Страница Samples содержит примеры компонентов. Поскольку это всего лишь 
примеры, они снабжены в C++Builder лишь минимальной документацией и BO 
встроенной справке сведения о них отсутствуют. Однако, исходные тексты приме- 
ров со страницы Samples поставляются вместе с C++Builder 5. Вы можете их про- 
смотреть и понять, как построены эти примеры и как ими пользоваться. 


ет ETERS GET де ee ges 
Компонент Тип Описание 


индикатор Пример компонента, используемого для со- 


линейки, текста или секторной диаграммы. 
Компонент визуальный. 


| 

в 

| м - 

| и хода процесса здания индикатора хода процесса в виде 
| 

| 

| 

| 
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| Компонент Описание | 


‘таблица CColorGrid |Пример компонента, используемого для со- | 


цветов здания таблицы цветов, в которой пользо- 


ватель выбирает требуемый цвет. Компо- 
нент визуальный. 


CSpin- Пример компонента, используемого для со- | 
Button здания кнопок-счетчиков. Компонент визу- | 
альный. 

| 

| 

| 


| 5} кнопка-счет- 
a чик 


окно редакти- |CSpinEdit |Пример компонента, используемого для со- 
рования со здания окна редактирования в комбинации 
счетчиком с кнопкой-счетчиком. Компонент визуаль- 

ный. 


CDirectory- 
Outline 


Пример компонента, используемого для 
отображения структуры каталогов выбран- 
ного диска. Компонент визуальный. 


дерево 
каталогов 


CCalendar |Пример компонента, используемого для 
отображения календаря на указанный ме- 
сяц в стандартном формате. Компонент ви- 


зуальный. 


календарь 


IBEvent- 
Alerter 


индикатор 
события 


Пример компонента, сигнализирующего о 
событии в базе данных. Компонент невизуа- 
льный. 


пм в | 
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Страница ActiveX содержит примеры компонентов ActiveX. Поскольку это всего 
лишь примеры, они снабжены в C++Builder лишь минимальной документацией и 
во встроенной справке сведения о них отсутствуют. Ho если вы перенесете соответст- 
вующий компонент на форму и щелкнете на нем правой кнопкой мыши, то во 
всплывшем меню можете выбрать команду Property и некоторые другие, которые 
отобразят диалоговые окна, помогающие задать необходимые свойства компонента. 


диаграммы Chartfx Редактор диаграмм и графиков. 
и графики ‘ . 


ye 
орфографиче- | VCSpell Визуальный блок орфографического KOHT- 
ский контроль роля 


страницы F1Book Компонент ввода и обработки числовой ин- 
Excel формации, аналогичный страницам Excel. 


kL. диаграммы VtChart Окно построения диаграмм. 
диаграммы Graph Окно построения диаграмм и графиков. 
и графики © | 
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Страница Servers содержит множество серверов СОМ, соответствующих OCHOB- 
ным программам Windows. На приведенном выше рисунке показана только часть 
этих серверов. Компоненты этой страницы позволяют вызывать из вашего прило- 
жения такие программы Windows, как Word, Excel, Access и др. 


Bets 
Bs 
ee : 


Функции С, С++, библиотек 
C++Builder, API] Windows 


В настоящей главе описано свыше 570 функций С, C++, библиотек C++Buil- 
der, API Windows. Это еще далеко не все функции, которые можно использовать. 
Но ограничения на объем книги потребовали отобрать из всего трудно обозримого 
множества функций те, которые используются чаще всего. 


15.1 Справочные сведения общего характера 


15.1.1 Коды клавиш 


Ниже приведены виртуальные коды клавиш, которыми можно пользоваться 
при обработке символов, строк, при проверке параметра Кеу в обработчиках собы- 
тий OnKeyDown и ОпКеуОр. Символы кириллицы соответствуют тем клавишам с 
латинскими символами, на которых они размещены. Использование виртуальных 
кодов клавиги см. в главе 4 в разделе 4.3.2.2. 


Десятичное Шестнадцате- | Сим 
число ричное число |имя 


[||| oe] 
сю” юз - re 
= 
= 
Е 
= 


— 
sO 


F10 


| пробел 


BackSpace 
ab 9 


enter 13 |0x0D | VK_RETURN 
VK_SHIFT 
VK_CONTROL 


ыы 


68 | Глава 15 


число ричное число |имя | символу 


| Insert 


> 
on 
© 
74 
bo 


| PageUp 


> 
74 

bo 
bo 


| PageDown 3 


| End 


> 
jon) 


Delete 


> 


oO 
~] 
=) 
[в 

bo 
On 


PrintScreen 


| ScrollLock - 


| 


Pause 
| NumLock 


> 
© 
© 
7 
iw) 
— 


Or 
= 
bo 
> 
< 
| | 
> 


5% 


N 
Qo 


о |< в: foo 1x4 ВЕ о lols [=z 
wml#t 1@ | = 
[о 

> 

(ee) 


Or 
— 


= 


9 
8 


187 
219 


2 
8 


co 
© 
* 

ey) 


р 


On 


I! 
+ 


bo 
= 


a 
> 
7 
| 
| 


_ 


©) 
> 
rad 

©) 


18 


190 OxBE 


as ee SR И Savy Вы 
VIA |—Г| А — |— 
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число ричное число |имя символу | 
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АИТ ee ВАА 
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0х44 


НИ 
И 
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0x46 


oe 
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ee 
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~] 
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— 
= 


ТБН 
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~ 


3 
< 


Ра 8 
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~ 


0x54 


< 


< 
< 


0х57 


a 


i eee 

(ООН 

На правой клавиатуре при выключенной клавише NumLock 
0560 __ | VK_NUMPADO _ 
[0562 VK_NUMPAD2_ 
но [УК мРА 
[ав [vm wumpape | 


= 


= 


* 
N 


= 


100 


29 
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| Клавиша Десятичное Шестнадцате- | Символическое |Сравнение по 
| число ричное число |имя символу 
7 ре а ees: Come 
VK_NUMPAD8 


0x67 VK_NUMPAD7 
VK_NUMPAD9 


| 


и оо _ оной = — — 


eee EE VK_MULTIPLY 
107 VK_ADD 


| 
ЕЕ 


109 VK_SUBTRACT 
VK_DECIMAL 
VK_DIVIDE 


15.1.2 Некоторые объявленные константы C++Builder 


В C++Builder предопределен ряд глобальных идентификаторов — макросов, 
называемых иногда объявленными (manifest) константами. Большинство из них 
начинаются с двух символов подчеркивания. В приведенной ниже таблице для 
большей наглядности и во избежание путаницы между этими символами подчер- 
кивания введены пробелы, т.е. вместо (__) записано (_ _). В реальных идентифика- 
торах этот пробел не должен фигурировать. Ниже приводится только часть объяв- 
ленных констант. Остальные вы можете посмотреть во встроенной справке 
C++Builder. 

Макросы! | DATE __,__FILE__, _ ИМЕ _, _STDC__u__TIME __ не 
должны появляться в файле непосредственно за директивами #Hdefine и #undef. 


Макрос Значение | Описание 


(sae. + 1 | Определен в любом компиляторе, производя- 
| щем оптимизацию 


_ _BCPLUSPLUS_ _ 


0х0530 Определен, если вы выбрали компиляцию 


С++; в последующих версиях значение будет 
увеличено 


—-BORLANDC____| 0x0530 


_ _CDECL_ _ 1 Определен, если установлено соглашение вы- 
| 30Ba cdecl 


_CHAR UNSIGNED |1 Определен, если выбрана опция, что по умол- 


чанию тип Char эквивалентен unsigned char; 
’_ _CONSOLE_ _ 


при опции -К макрос не определен 


— 


Определен для консольных приложений 
_CPPUNWIND 1 По умолчанию определен и показывает, что 
| доступно разматывание стека; при -xd не 
| определен 
_ _eplusplus Определен в режиме C++ | 
строка Дата компиляции исходного файла (строка в | 
формате «Mmm dd уууу», например, «Jan 19 | 
1994») 


Определен при использовании опции -WD 


| 
| 
| 
| 
| 
| 
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| Макрос Значение | Описание 
ape SS строка Предполагаемое имя исходного файла 


> i en 1 Определен при компиляции в модели памяти 

flat с разрядностью 32 бита 

__LINE_ _ целое Номер текущей строки исходного текста про- 
граммы 

| РАЗСАГ. _ Определен, если установлено соглашение вы- 
зова Pascal 


1 Используется для указания, что данная реа- 
лизация удовлетворяет стандартам ANSI. 
Определен, если вы компилировали с опцией 


ws . 


Определен для файлов С++, означает, что 


_ _ТЕМРЕАТЕ$ _ _ | 
поддерживаются шаблоны 
ae) ae строка Время компиляции исходного файла (симво- | 
льная строка формата «<hh:mm:ss>») | 
_ _WINS2_ _ НА Определен для приложений консольных и | 
GUI | 


1 
1 
1 


Комментарий 


Приведенные объявленные константы C++Builder могут использоваться в 
приложениях для определения различных опций настройки приложения. Приве- 
денный ниже оператор 


Editl->Text = DATE ; 
отображает в окне редактирования Editl дату создания файла. Например, резуль- 
тат выполнения этого оператора может иметь вид: 

‚ Арг 10 2000 

Если необходимо включить значение объявленной константы в строку текста, 
ее надо явным образом привести к типу строки. Например, оператор 

Editl->Text = "Дата создания: " + (String) DATE _ + 

e+ ЭДА. + 455119) ТИ. + 

даст результат вида: 

Дата создания: Арг 10 2000, время: 17:28:34 


15.1.3 Управляющие последовательности символов 
(езсаре-последовательности) 


Управляющие последовательности символов состоят из символа обратного 
слеша (\) и одного или нескольких символов, следующих за ним без пробела. 

Если за символом (\) следуют от одной до трех восьмеричных цифр или любое 
количество шестнадцатеричных цифр, то такая последовательность воспринимает- 
ся как соответствующее восьмеричное или шестнадцатеричное число. Например: 
‘\03' или ‘\Oxf'. 

Ниже приведена таблица основных управляющих последовательностей. 
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пе пару I и RY 
И | 
ое ЕТ: | 
a ae OF ет Пот 


Ox0A новая строка 


в 
гы 


ct 
=" 


— 
= 


oe” Mae. lige: Ой Bae Я 
at a [4 ТРИ 


возврат каретки 


ВЯ Hil ain К Ут тия 


вертикальная табуляция 
обратный слеш 
одинарная кавычка 
0х2 {ар двойная кавычка 
вопросительный знак 


восьмеричное число (до трех цифр) 


ae 


xn ев 


Pa ©. МЕ 
.9 


шестнадцатеричное число 


| = 


шестнадцатеричное число 


Рассмотрим примеры. При работе со строками, содержащими путь к некоторо- 
му файлу, надо не забывать, что одиночный обратный слеш воспринимается как 


начало управляющей последовательности. Поэтому строка вида 
"d:\test\readmy.txt" 


будет воспринята не как имя файла с путем, а как 


| 
А:<символ табуляции>ез{<символ возврата каретки>еааму. © хе 


Чтобы восприятие строки было нормальным, надо сдвоить все символы обрат- 
ного слеша: 

"d:\\test\\readmy.txt" 

Ниже приведен пример, отображающий с помощью функции ShowMessage 
(см. раздел 15.7.2.1) окно сообщения с табулированным текстом: 


5помМеззаае ( 
"Предмет\+Оценка\п\"Математика\"\&5\п\"Русский\"\$2"); 


Результат выполнения этого оператора показан на рис. 15.1. Сивмолы новой 
строки «\п» позволили разбить текст на три строки. Символы табуляции «\t» по- 
зволили расположить текст каждой строки в двух столбцах. А символы «\» позво- 
лили ввести в текст кавычки. 


Рис. 15.1. 
Пример сообщения с табулированным выводом 
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15.1.4 Форматы и типы, используемые при форматировании 
данных 


15.1.4.1 Строка форматирования функций вывода 


Строка формата, используемая во многих функциях вывода данных (printf, 
cprintf, sprintf и др.), состоит из обычных символов, управляющих последователь- 
ностей символов (см. раздел 15.1.3) и спецификаций полей формата вывода аргу- 
ментов. Обычные символы и управляющие последовательности просто копируют- 
ся в выходную строку. 

Спецификации полей формата начинаются с символа % и имеют вид: 


$[flags] [width] [.precision] [F|N|h|1|L]type 
Все символы спецификации записываются без пробелов между ними. 
Единственно обязательным элементом спецификации является type — сим- 


вол, указывающий на тип данных вводимого поля. Остальные необязательные эле- 
менты задают параметры форматирования: 


[flags] Флаги выравнивания, управления печатью знака числа, управле- 
ния пробелами, десятичной точкой, основанием печати (восьме- 
ричная, шестнадцатеричная) 

[width] Ширина поля — минимальное число выводимых символов 


[.precision] Спецификатор точности — максимальное количество печатаемых 
символов или минимальное количество разрядов печатаемого це- 
лого 


[F|N|hII|L] Модификаторы, изменяющие размер аргумента по умолчанию: 


М | ближний указатель (пеаг) 
Е дальний указатель (Гаг) 

h _ short int 

| long 

L long double 


Ниже приведены возможные значения type. 


Символ 


десятичное signed integer 

десятичное signed integer 

восьмеричное unsigned integer 

десятичное unsigned integer 
шестнадцатеричное unsigned int 

| (с цифрами a, b, с, 4, е, Г) 

то же, что x, но с цифрами А, В, С, D, Е, Е 
формат с фиксированной точкой: [-]dddd.dddd 


Й экспоненциальный (научный) формат: 


Формат вывода 


| 
| 
| 
| 
| 
| 
| 
| 
==), 


деиствительныи 


| 
| 
| 
| 
| 
| 
| 
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Cawiios 


Тип аргумента Формат вывода ` | 
действительный TO же, что е, но с символом Е 


| 

| 

| 
действительный наиболее компактный из форматов е и # для | 
данного числа и данной точности; незначащие 
| 

| 

| 


нули не выводятся 


действительный то же, что g, но с символом Е в экспоненци- 


альном формате 


Символы 


символ 


указатель на строку | строка символов до нулевого символа в конце 
т или с числом символов, заданных точностью 


% нет печать символа % 


Указатели | 


один символ 


указатель Ha int в ячейку памяти, на которую указывает apry- 
мент, заносится количество выведенных к 


данному моменту символов 


указатель печать аргумента как указателя; в зависимо- 
сти от используемой модели памяти печатает- 


ся или ХХХХ:УУУУ, или YYYY (только сме- 


Перечисленные ниже флаги flags могут записываться в любой последователь- 
ности и в любой комбинации. 


Флаг Пояснение 
Выравнивание влево, оставшееся поле справа заполняется пробелами. 
Если этот флаг не задан, то производится выравнивание вправо, а 
оставшееся поле слева заполняется нулями или пробелами. 


+ 


| 
| 


Обязательно перед числом указывается знак плюс (+) или минус (-). 


пробел |Если значение не отрицательное, то печать начинается с пробела вме- 
сто знака плюс (+). Для отрицательного значения знак минус (-) печа- 
тается. Если наряду с этим флагом задан флаг +, то он должен быть 
указан до флага пробела. 


В форматах o, x, Х добавляется префикс 0, Ox, OX соответственно. В 
форматах е, Е, f, g, G во всех случаях выводится десятичная точка. 
Кроме того в форматах g, G не подавляется вывод незначащих нулей. 


Спецификатор width задает минимальную ширину поля. Спецификатор мо- 
жет быть задан или явным образом — десятичным числом, или косвенно — симво- 
лом звездочки (*). В последнем случае предполагается, что ширину поля задает 
очередной аргумент из списка. 

Спецификатор width указывает только минимальную ширину. Если вывод 
данного аргумента требует большей ширины поля, то поле расширяется и значе- 
ние никогда не усекается. 

Спецификатор может принимать следующие значения: 
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ыы ый НЯ ЛИ ИИ IOS IRIE 


MO ELIOT LE DEERE REE: 


n Выводится по крайней мере п символов. . Если per вывода требуется. ме: — 
ньше символов, то лишние позиции (слева или справа, в зависимости OT 
флагов) заполняются пробелами 


Оп Выводится по крайней мере п символов. Если для вывода требуется ме- 
ньше символов, то лишние позиции слева заполняются нулями 


4 


* Ширину поля задает очередной аргумент из списка 


Спецификатор точности precision определяет максимальное число выводимых 
символов или место десятичной точки. Он записывается после символа точки (.), 
чтобы отделить его от предшествующего спецификатора width. Данный специфи- 
катор, как и width, может быть задан или явным образом — десятичным числом.,,. 
или косвенно — символом звездочки (*). В последнем случае предполагается, что 
точность задается очередным аргументом из списка. 

Отсутствие спецификатора precision означает точность по умолчанию и экви- 
валентно: 


1 для форматов а, i, о, “а, 3 х, ke 
6 для форматов e, Е, f 

числу значащих цифр для форматов в, ot 

выводу до нулевого символа для формата $ 

не влияет на формат с 


Возможные значения precision: 


И По: о наи ОИ ЗАКИ ИА НИНЕ. 


.0 Для фоматов Ч, i, о, и, х эквивалентно точности по › умолчанию. 


Для форматов е, Е, # означает вывод без десятичной точки 


n Задает вывод п символов или позицию п десятичной точки. Если выво- 
димая величина содержит более п символов, то строка символов усека- 
ется, а число может округляться (в зависимости от формата) 


* Точность задает очередной аргумент из списка 


Ниже приведены сведения о влиянии значения precision на различные форматы. 


/ 


ааа LEED ИА ДИ НИЯ ИИА Я: АЗИЯ К LORELEI PEEVE RLS I 


ad, i} 0; u, x, xX Указывает, что должно выводиться по крайней мере n ‘цифр. 
Если число имеет менее п цифр, позиции слева заполняются 
нулями. Если число имеет более п цифр, число не усекается 


e, Е, f Указывает, что после десятичной точки должно выводиться 
п цифр. Последняя цифра округляется 

5, а Указывает, что должно выводиться до и цифр 

с Спецификатор не влияет 


С Указывает, что должно выводиться не более п символов 
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Примеры 


Примеры влияния формата: 


110000.000000 


1 0.000000 1.100000e-07 1.1е-07 1.10000E-07 
| 12.000000 1.200000e+01 12.0000 | 


eee 


Примеры влияние флагов: 


Примеры влияния точности: 


ВЕНЕ ИИА 
1% 
%.51 
% At 

| iS PY ee oad 


jm .8f_ «sd 128456789.000 0.128 

| %е 

ИИ РИВА ИА Las es i 

| % .5е 1.2345 7е-01 

| % Ae 1.2346е-01 

|%.3е 
о a ee ae 


} 


Mo Ba 2 ARAM HOB рег о ПОВ ar с Sere] 
OE osc ob ош pA REOB ge oy ORB ea В 
0.12 
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Примеры использования строка форматирования вы можете также найти в 
разделе 15.5.4 в описании функций вывода. 


15.1.4.2 Строка форматирования функций ввода 


Описанная ниже строка формата, используется во многих функциях ввода 

данных (scanf, fscanf, sscanf и др.). Строка может включать три вида элементов: 
Ш пробельные символы (пробел « », табуляцию «\t», символ новой строки «\п» 
Ш не пробельные печатные символы (кроме %) 
Ш спецификации формата 

Если в строке встретился пробельный символ, то с этого момента пробельные 
символы до первого не пробельного символа считываются из входного потока, но 
не участвуют в присваивании значений переменным (игнорируются). 

Если в строке встретился печатный не пробельный символ, то с этого момента 
из входного потока считывается и игнорируется последовательность символов, 
встретившаяся в строке формата. Если последовательность символов во входном 
потоке не соответствует записанной в строке формата, то форматирование преры- 
вается. 

Спецификации формата начинаются с символа % и имеют вид: 


% [*] [width] [FIN] [1116] type 


Все символы спецификации записываются без пробелов между ними. 

Единственно обязательным элементом спецификации является type — сим- 
вол, указывающий на то, как будет трактоваться вводимый аргумент. Остальные 
необязательные элементы задают параметры форматирования: 


PERI ых В а вой 


[*] Запрет занесения в память читаемого поля. Поле сканируется, HO 
его значение не присваивается аргументу из списка. 


[width] Ширина поля — максимальное число читаемых символов. Реально 
может быть прочитано меньше символов, если во входном потоке 
раньше встретится пробельный символ или символ, который не мо- 
жет быть преобразован согласно заданному формату. 


[FIN]. Модификаторы, изменяющие размер аргумента по умолчанию: 
М ближний указатель (пеаг) 
Е дальний указатель (far) 
[ИГ] Модификаторы, изменяющие размер аргумента по умолчанию: 
h short int 
] long int, если type соответствует целому числу, 


или double, если type соответствует действитель- 
ному числу 


L _ 018 double 


Ниже приведены возможные значения фуре. 


Символ 
< ый [указатель на int (int *arg) 
рый [с [указатель на long (long *arg) 


] 
| 
| 


} 
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Символ Ожидаемый тип данных . Тип аргумента 
действительный указатель Ha float (float *arg) 


действительный 


указатель Ha float (float *arg) 
действительный указатель Ha float (float *arg) | 


восьмеричный целый указатель Ha int (int *arg) 


восьмеричный целый указатель на long (long *arg) 


десятичный, восьмеричный или | указатель Ha int (int *arg) 
шестнадцатеричный целый 


десятичный, восьмеричный или 


указатель Ha long (long *arg) 
шестнадцатеричный целый 


десятичный целый без знака указатель Ha unsigned int (unsig- 
ned int *arg) 


десятичный целый без знака указатель Ha unsigned long (un- 
signed long *arg) 


шестнадцатеричный целый указатель на int (int *arg) 


шестнадцатеричный целый указатель на int (int *arg) 


Символы 


строка символов указатель на массив символов 


(char arg[]) 


указатель Ha Char (char *arg) или, 
если задана ширина поля (напри- 


мер, % 5c), то на массив символов 
размером W (char arg[W)]) 


| 
| 
| 
не преобразуется 


% символ % 


Указатели 


указатель на int (int *arg) в ячейку памяти, на которую yKa- 
зывает аргумент, заносится коли- 
чество успешно прочитанных к 


данному моменту символов 


шестнадцатеричный формат: 
YYYY:ZZZZ или ZZZZ 


указатель Ha объект (far* или 
пеаг*) 


Примеры использования строки форматирования вы можете найти в разде- 
ле 15.5.4 в описании функций ввода. 


15.1.4.3 Строка форматирования функций типа Format 


Описанная ниже строка форматирования используется в функциях Format, 
FormatBuf, FmtStr, StrFmt, StrLFmt и др. 

Строка содержит обычные символы и спецификаторы формата полей. Обыч- 
ные символы просто копируются в выходную строку, а спецификаторы определя- 
ют форматирование аргументов из заданного списка. 

Спецификации формата начинаются с символа % и имеют вид: 


Ta”. (ода пт] [Г] (width). ["." prec} type 
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Единственно обязательным элементом спецификации является type — сим- 
вол, указывающий на то, как будет трактоваться аргумент. Остальные необяза- 
тельные элементы задают параметры форматирования: 


ЗВ ОЕ ОСН НУ НОВА НЯ ИИ 


[index “:"] Устанавливает текущий индекс массива. аргументов в ‘заданное 
значение index. Индексы начинаются с 0. Например, специфи- 

катор % 0: переводит индекс на начало массива и обеспечивает 
повторное форматирование первого аргумента 


ние: неа 


["-"] Обеспечивает выравнивание результата влево с заполнением 
оставшихся правых позиций поля пробелами. В отсутствие спе- 
цификатора ["-"] выравнивание производится вправо 


[width] Устанавливает минимальную ширину поля в результирующей 
строке. Если результат преобразования короче ширины поля, 
происходит выравнивание вправо (или влево, если был записан 
спецификатор ["-"]) с заполнением лишних позиций пробелами 


["." prec] Спецификатор точности, определяющий число выводимых сим- 
волов (в зависимости от принятого формата). Спецификатор за- 
писывается после символа точки (.), чтобы отделить его от пред- 
шествующего спецификатора width 


Значения спецификаторов index, width и prec могут задаваться в виде целых 
значений или в виде символа звездочки (*).В последнем случае предполагается, 
что значение спецификатора задается очередным аргументом из списка. 

Ниже приведены возможные значения type. 


Десятичный формат — строка десятичных цифр. 
Если используется спецификатор [".” prec], To он 
указывает минимальное количество выводимых 
цифр. Если действительное количество цифр резу- 
льтата меньше указанного спецификатором точно- 
сти, то происходит выравнивание вправо с заполне- 
нием лишних позиций нулями. 


Научный формат — строка вида «-d.ddd...E+ddd>. 
Перед десятичной точкой всегда помещается одна 
цифра и для отрицательных величин — знак ми- 
нус. Если используется спецификатор [".” prec], то 
он указывает общее количество выводимых цифр, 
включая цифру перед десятичной точкой (по умол- 
чанию 15 цифр). После символа порядка «Е» всегда 
указывается знак — плюс или минус. 


действительный 


Формат с фиксированной точкой — строка вида 
«-999.999...›. Если используется спецификатор [ . 
prec], то он указывает количество выводимых цифр 
после десятичной точки (по у умолчанию 2 цифры). 


действительный 
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действительный | Универсальный формат — преобразование в науч- 
ный формат или формат с фиксированной точкой, в 
зависимости от того, какой из них дает более ком- 
пактный результат. Если используется специфика- 
тор [".” prec], то он указывает количество выводи- 
мых значащих разрядов (по умолчанию — 15). На- 
чальные нули не печатаются, десятичная точка пе- 
чатается, если необходимо. Формат с фиксирован- 
ной точкой используется, если в преобразуемом 
значении число цифр до десятичной точки меньше 
заданной точности и если значение не меньше 
0.00001. В остальных случаях используется науч- 
ный формат. 


действительный | Числовой формат — то же, что формат с фиксиро- 
ванной точкой, но с добавлением разделителей ты- 
cau: «-d,ddd,ddd.ddd...». 


действительный | Монетарный формат — число преобразуется в стро- 
ку, отображающую денежную сумму. Формат конт- 

ролируется глобальными переменными CurrencySt- 
ring, CurrencyFormat, NegCurrFormat, Thousand- 
Separator, DecimalSeparator, CurrencyDecimals, 
задаваемыми для монетарного формата разделом 
Currency Format элемента International Контрольной па- | 
нели Windows. Если используется спецификатор 
["." prec], то он заменяет собой значение глобаль- 
ной переменной CurrencyDecimals. 


«ХХХХ:УУУХ», где ХХХХ и YYYY — сегмент и 
смещение, выраженные четырьмя шестнадцатерич- 
ными цифрами. 


символ, строка |Строка символов. Если используется спецификатор 

или тип PChar |[”.” prec], то он задает максимальное число симво- 
лов. Если строка длиннее указанного числа, она 
усекается. | 


Шестнадцатеричный формат — строка шестнадца- 
теричных цифр. Если используется спецификатор 
[".” prec], то он указывает минимальное количество 
цифр результата. Если результат короче, лишние 

| позиции слева заполняются нулями. | 


= указатель Указатель — значение преобразуется в строку вида 


Все указанные в приведенной таблице обозначения форматов могут записы- 
ваться в нижнем или верхнем регистре, что никак не влияет на результат. 

Для форматов действительных чисел реально используемые символы десятич- 
ной точки и разделителей тысяч определяются глобальными переменными 
DecimalSeparator и ThousandSeparator. 
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Примеры 


Примеры влияния формата: 


110000. 110000,00 1,10000000000000E+005 |110000 
'-1.1е+08 -110000000,00 |-1,10000000000000Е-008 | -110000000 
0.00011 0,00 = [= [1,10000000000000Е-004 | 0,00011 


| 


1,10000000000000E-007 | 1,1E-7 
12. 12,00 1,20000000000000E+001 
‘tats 0,00 __|9,000000000000008+000 |O 


15.1.4.4 TFloatFormat и TFloatValue — типы форматирования 
действительных чисел 
Типы TFloatFormat и TFloatValue определяют форматирование действитель- 


ных чисел в таких функциях, как FloatToText, FloatToStrF, FloatToDecimal, 
TextToFloat. | 


Синтаксис 


#include <SysUtils.hpp> . | 

enum TFloatFormat { ffGeneral, ffExponent, ffFixed, ffNumber, 
ffCurrency }; 

enum TFloatValue { fvExtended, fvCurrency }; 


Описание 

ТЕюаз{УаШе указывает тип преобразуемого числа. Значение fvExtended соот- 
ветствует обычному числу с плавающей запятой, а значение fvCurrency — числу 
типа Сиггепсу. 

Тип TFloatFormat определяет коды форматирования чисел с плавающей запя- 
той в функциях FloatToText, FloatToStrF, FloatToDecimal, TextToFloat. Воз- 
можные значения формата определяют следующие правила форматирования: 
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ffGeneral Основной ч числовой формат. Число преобразуется по формату с фик- 
сированной точкой или научному в зависимости от того, какой из 
них оказывается короче. Начальные нули удаляются, десятичная 
точка ставится только при необходимости. Фиксированный формат 
используется, если число разрядов слева от точки не больше ука- 
занной точности Precision и если значение не меньше 0.00001. В 
противном случае используется научный формат, в котором пара- 
метр Digits определяет число разрядов степени — от 0 до 4 


ffExponent Научный формат. Число преобразуется в строку вида 
«-d.ddd...E+dddd». Общее число цифр, включая одну перед десяти- 
чной точкой, задается параметром Precision. После символа «Е» 
всегда следует знак «+» или «-» и до четырех цифр. Параметр Di- 
2165 определяет минимальное число разрядов степени — от 0 до 4 


ffFixed Формат с фиксированной точкой. Число преобразуется в строку 
вида «-ddd.ddd...». По крайней мере одна цифра всегда предшест- 
вует десятичной точке. Число цифр после десятичной точки зада- 
ется параметром Digits, который может лежать в пределах от 0 до 
18. Если число разрядов слева от десятичной точки больше ука- 
занного параметром Precision, то используется научный формат 


ffNumber Числовой формат. Число преобразуется в строку вида 
«-d,ddd,ddd.ddd...». Данный формат совпадает с ffFixed за исклю- 
чением наличия в нем разделителей тысяч 


ffCurrency Монетарный формат. Число преобразуется в строку, отображающую 
денежную сумму. Формат контролируется глобальными переменны- 
ми CurrencyString, CurrencyFormat, NegCurrFormat, ThousandSe- 
parator, DecimalSeparator, задаваемыми для монетарного формата 
разделом Currency Format элемента International Контрольной панели 
Windows. Число цифр после десятичной точки задается параметром 
Digits, который может лежать в пределах от 0 до 18 


Для всех форматов действительные символы, используемые в качестве деся- 
тичной точки и разделителя тысяч определяются глобальными переменными 
DecimalSeparator и ThousandSeparator. 


15.1.4.5 Строка форматирования функций типа FormatFloat 


Строка форматирования, описанная ниже, применяется в функциях 
FormatFloat, FloatToTextFmt, в методе FormatFloat класса AnsiString и в неко- 
торых других. 

В строке используются следующие символы: 


0 Сохранение 1 позиции длЯ я цифры. Если форматируемое число ‘содержит 
цифру в позиции, в которой в строке форматирования имеется символ 
«0», то эта цифра копируется в выходную строку. В противном случае в 
этой позиции в выходной строке содержится «0» 


# Сохранение позиции для цифры. Если форматируемое число содержит 
цифру в позиции, в которсй в строке форматирования имеется символ 
«#», то эта цифра копируется в выходную строку. В противном случае в 
эту позицию в выходной строке ничего не заносится 
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Е Десятичная точка. Первый символ точки «.» в строке форматирования 
определяет позицию десятичной точки в отформатированном числе. Лю- 
бые последующие символы «.» в строке игнорируются. Действительный 
символ, используемый в качестве десятичной точки, определяется глоба- 
льной переменной DecimalSeparator, установленной в разделе Number 
Format элемента International программы «Панель управления» Windows 


. Разделитель тысяч. Если строка форматирования содержит один или бо- 
лее символов ‹,», то в выходной строке будут использованы разделители 
тысяч. Местоположение символов «,» в строке форматирования безраз- 
лично — это просто указание, что надо использовать разделители тысяч. 
Действительный символ, используемый в качестве разделителя, опреде- 
ляется глобальной переменной ThousandSeparator, установленной в раз- 
деле Number Format элемента International программы «Панель управле- 
ния» Windows 


E+, Научный формат. Если в строке форматирования встречаются симолы 


Е-, «E+», «Е-», «e+» или «е-»›, то при форматировании используется науч- 
e+, ный формат. Сразу после этих символов может быть расположена группа 
e- символов «0» (до четырех символов), которая определяет минимальное 


число цифр в показателе степени. Если в строке использованы символы 
«E+» или «e+», то как перед положительной, так и перед отрицательной 
степенью будет всегда помещаться знак «+» или «-». Если в строке испо- 
льзованы символы «Е-» или «е-», то знак будет помещаться только перед 
отрицательной степенью 


хх / Символы, заключенные в одинарные или двойные кавычки, выводятся в 
хх выходную строку, никак не влияя на форматирование 


3 Символ разделяет разделы строки, связанные с форматированием поло- 
жительных, отрицательных и нулевых значений 


Расположение крайнего левого символа «0» перед десятичной точкой и край- 
него правого символа «0» после десятичной точки определяет число цифр, всегда 
присутствующих в выходной строке. 

Форматируемое число всегда округляется до стольких десятичных разрядов, 
сколько символов «0» и «#» находится справа от десятичной точки. Если строка 
форматирования не содержит десятичной точки, значение форматируемого числа 
округляется до ближайшего целого. 

Если форматируемое число имеет больше цифр слева от десятичной точки, 
чем количество расположенных там в строке форматирования символов «0» и «#>, 
то лишние цифры все равно выводятся в начале числа. 

Строка форматирования может содержать от одной до трех секций, разделяе- 
мых точкой с запятой. Если задана только одна секция, то она применяется для 
форматирования любых чисел. Если задано две секции, то первая используется 
при форматировании положительных чисел и нуля, а вторая — при форматирова-. 
нии отрицательных чисел. Если заданы три секции, то первая относится к поло- 
жительным числам, вторая — к отрицательным, третья — к нулю. 

Если секции отрицательных чисел или нуля пустые (т.е. ничего не написано 
после соответствующей точки с запятой, то вместо них используется секция поло- 
жительных чисел. 

Если секция положительных чисел пустая или вообще строка форматирова- 
ния пустая, то используется основной формат чисел с плавающей запятой с 15 зна- 
чащими разрядами. Этот формат соответствует формату ffGeneral типа TFloat- 
Format (см. раздел 15.1.4.4). Этот же формат используется, если число имеет более 
18 разрядов до десятичной точки и строка форматирования не содержит указания 
на применение научного формата. 
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Примеры 


Ниже приведены строки форматирования и соответствующие им выходные 
строки. 


[Строка bopmaruponanua | 
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15.1.5 Обработка ошибок времени выполнения, диагностика 


Чтобы работать с сообщениями об ошибках времени выполнения, в приложе- 
ние должна быть включена директива 


#Hinclude <errno.h> 


15.1.5.1_doserrno, errno и _sys_nerr — переменные, содержащие коды 
ошибок 


Переменные _doserrno и errno типа int получают положительные значения 
при возникновении различных, ошибок времени выполнения. Значения_4озеггпо 
и еггпо задаются одновременно, но иногда они могут различаться, поскольку 
errno — переменная, совместимая с UNIX. 

Коды ошибок, присваиваемые errno, являются одновременно индексами мас- 
сива _sys_errlist, содержащего сообщения об ошибках. Кроме того имеется пере- 
менная _SyS_nerr, которая содержит номер ошибки и используется функцией 
реггог (файл stdio.h) для вывода в стандартный поток сообщений об ошибках 
stder. Поэтому доступ к соответствующему сообщению можно получить или как 
_sys_errlist[errno], или как _sys_errlist[_sys_nerr]. 

Нормальное значение рассматриваемых переменных — 0. При выполнении 
различных математических функций, при манипуляциях с файлами и т.п. это зна- 
чение при возникновении ошибки изменяется и сохраняется таким вплоть до сле- 
дующего обращения к соответствующей функции. Если это нежелательно, надо 
программно сбрасывать значения в 0. 


15.1.5.2 Коды ошибок 


Ниже приводится таблица, содержащая мнемонические константы ошибок, 
их коды и соответствующие сообщения из массива _sSys_errlist. 


eS eae 
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pane nen 


Koncrawra |Код _| Coo6menne в _sys_errlist 


Arg list too long 


EACCES 5 Permission denied 


/EAGAIN Resource temporarily unavailable т 
EBADF 6 =  |Ваа file number 
 ЕВО$У pag 38 8 Resource busy 


| ECHILD 24 No child process 
ECONTR Memory blocks destroyed 
ECURDIR 

| EDEADLOCK 


1 


© 


Attempt to remove CurDir 


Locking violation 


Math argument 


File already exists 


1 
27 Для UNIX — в MSDOS отсутствует 


Interrupted function call 


= 


Unknown error 


Invalid access code 


—= 
© 


Invalid argument 
Invalid data 


Invalid drive specified 


13 
5 
10 
1 


cle le le le le le le = 
2\)\24/2\/424'1Z|/2/2Z2lol> | 
аааа«аанная 
НАННЫНЫЫЕЕ 
«АР > 2 
= 
bo 


Invalid environment 


— 


Invalid format 
Invalid function number 


nvalid memory block address 


=> 
© 


Input/output error 

Для UNIX — в MSDOS отсутствует 
Too many open files 

Для UNIX — в MSDOS отсутствует 


Too many open files 


> 


6 


1 


= 


8 
5 


No more files 


No such device 


= 


No such file or directory 


bo 


1 Exec format error 


File not found 


ENOMEM  _—_—_—s|8_| Not enough core 
ENOPATH 3 [Рай not found 
| ENOSPC : 28 |No space leftondevice __ _____ 


ABABA BBE 
SISISISIZISIRIS 434 
SIS IS Sis isisis -- 
аа зЕН‚яы 5 |Z 
mS = го 
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[Код____ Сообщение в зузетнй о 
43 |Для UNIX — в MSDOS oreyrersyer 
45 Для UNIX — в MSDOS oreyrersyer | 
[25 |Для UNIX — в MSDOS oreyrensyer  — 
Зена ВОИНОВ > ыы о ини 
Eten 
ыы 
BBs gad 
og 


ENOTBLK 
ENOTSAM 


ENOTTY 


ENXIO 
ERANGE 
ESRCH 
ETXTBSY 
EUCLEAN 


EXDEV 


Стандартные сообщения можно изменять. Например, оператор 


es as 


A 4 


strcpy( sys errlist[ENOENT],"Her такого файла или каталога"); 


русифицирует стандартное сообщение «No such file or directory». 

Ниже приведена таблица других кодов ошибок — ошибок файлового BBO- 
да-вывода, которые возникают, если включена опция |/О checking на странице Pas- 
cal окна опций проекта. Эти коды генерируются в C++Builder 5 при создании ис- 
ключения EInOutError. 


а 
Ве нависе м Инет ист аа mmm madmen лотом зб в, 
У | Hepbanmaanbe Аа Фа Ns. 
40 [Сл мною открытых файлов 
ee a ТР аа ИИ 


Достигнут конец файла (EOF) 


Ошибка ввода 


А 


15.1.5.3 EDOM, ERANGE — константы сообщений об ошибках 


Символические целочисленные константы EDOM и ЕКАМСЕ используются в 
математических и других функциях для сообщений об ошибках. Узнать, возникла 
ли соответствующая ошибка при выполнении некоторой функции, можно провер- 
кой переменной errno, например: 


if(errno == EDOM) ...;. 
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15.1.5.4 matherr и _matherrl — обработчики ошибок 


Синтаксис 


#include <math.h> gry 
int _matherr(struct exception *е); 
int _matherrl(struct _exceptionl *е); 


Описание 
Функция _matherr или _matherr! (для типов long double) вызываются биб- 
лиотечными математическими функциями при возникновении в них ошибок, свя- 
занных с недопустимыми значениями параметров (корень или логарифм отрица- 
тельного числа ит.п.). Функции перехватывают только ошибки, выхода за преде- 
лы области определения и выхода за диапазон допустимых значений, но не реаги- 
руют на исключения при выполнении математических операций, например, при 
делении на 0. Для перехвата таких событий служит функция signal. 
Стандартные варианты _matherr и _matherrl могут быть переопределены 
пользователем, если он объявит в своем приложении аналогичные функции. Эти 
функции пользователя должны возвращать ненулевое значение, если они обрабо- 
тали ошибку. В этом случае не возникает стандартного сообщения об ошибке и не 
изменяется значение переменной errno. Если переписанные пользователем вари- 
анты _шаегг u_matherrl не обработали данную ошибку, они должны вернуть 0. 
Тогда будет проведена стандартная обработка ошибки. 
В качестве параметра е в функции передаются структуры: 
struct exception { 
int type; 
char *name; 


double argl, arg2, retval; 
}; 


struct _exceptionl { 
int type; 
char *name; ’ 
long double argl, arg2, retval; 

}; 

Элемент структуры type определяет тип ошибки. Элемент Name указывает на 
строку, содержащую имя функции, в которой произошла ошибка. Элементы argl 
и arg2 — это значения аргументов, приведшие к ошибкам (если функция имеет 
один аргумент, то его значение помещается в argl). Элемент retval — возвращае- 
мое по умолчанию значение функции. Пользователь может изменить это значение. 

Тип ошибки, лан в элементе type, может принимать одно из следую- 
щих значений: 


DOMAIN padi аргумент ‘выходит ‘за пределы области определения; напри_ 
мер, log(-1) 

SING аргумент соответствует особой точке функции; например, 
pow(0, -2) ? A 

OVERFLOW аргумент приводит к значению функции, превышающему 
DBL_MAX (или ГОВГ_ МАХ); например, ехр(1000) 

UNDERFLOW аргумент приводит к значению функции, меньшему чем 
DBL_MIN (или LDBL_MIN); например, exp(-1000) 

TLOSS аргумент приводит к значению функции с полной потерей 


значащих разрядов; например, sin(10e70) 


888 ” ‚ Глава 15 


Фигурирующие в приведенном описании макросы ОВГ МАХ, DBL_MIN, 
LDBL_MAX и LDBL_MIN определены в файле float.h. 


Пример 

Приведенный ниже пример показывает функцию, обрабатывающую ошибку 
типа DOMAIN функции sqrt (корень из отрицательного числа), заменяя результат 
на корень из положительного числа: 


int matherr (struct exception *а) 


{ 


if (a->type == DOMAIN) 
if (!strcemp(a->name,"sgqrt")) { 
a->retval = sqrt (-(a->argl)); 
return 1; 
} 
return 0; 


} 


15.1.5.5 assert — макрос диагностики 


Синтаксис 


#include <assert.h> 
void assert(int test); 


Описание 

Макрос assert используется в программах для диагностики. Если при расши- 
рении макроса значение параметра test ложно (равно нулю), TO assert выдает в 
стандартный файл ошибок stderr сообщение: 


Assertion failed: test, file <имя файла>, line <номер строки> 


После этого макрос assert производит вызов функции abort. 
Если в исходном файле перед директивой 


#include <assert.h> 
появляется директива препроцессора 
#define NDEBUG 


то все последующие макросы assert игнорируются. Таким образом вы можете ввес- 
ти в свое приложение какие-то проверки, необходимые для отладки, а затем в 
окончательном файле отключить их директивой NDEBUG. 


15.2 Математические функции 


15.2.1 Константы, используемые в математических 
выражениях 


| Константа _| Описание Значение | | 
M_1 SQRTPI 0.564189583547756286948 


мам |2/n 1[0.689619712361581348016 | 
|M_2_SQRTPI 1.12887916709551257390 | 
МЕ [чи = = —————C—C~sCsé*:« 718 281828-45904523536_| 
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[Константа (Описание 
11(10) — логарифм натуральный от 10 
11(2) — логарифм натуральный от 2 
logio(e) — логарифм десятичный от е 


|M_LOG2E loge(e) — логарифм по основанию 2 | 1.44269504088896340736 


3.14159265358979323846 
1.57079632679489661923 
0.785398163397448309616 


0.707106781186547524401 
1.41421356237309504880 


; 
Г. 
. 
. 


корень из 2 


Синтаксис Описание 


unsigned long _lrotl( циклический сдвиг | stdlib.h 
unsigned long val, int count) val влево Ha count 
битов 


unsigned long _lrotr( циклический сдвиг 
unsigned long val, int count) val вправо Ha count 
битов 


unsigned short _гой( циклический сдвиг 
unsigned short value, int count) value влево Ha count 
битов 


unsigned short _rotr( — циклический сдвиг 
unsigned short value, int count) value вправо Ha со- 
P unt битов 


int abs(int x) абсолютное значение 


double cabs(struct complex 2) _ | модуль комплексного 
struct complex { double x, у; }; qucla Zz . 


long double cabsl(struct 
7 _complex!l 2) числа 2 
struct _сошрех { long 
double x, y; }; 


double ceil(double x) округление вверх: 
наименьшее целое, 
не меньшее х 


int Ceil(Extended Х); округление вверх: 
наименьшее целое, 
не меньшее Х 


со 
wo 
о 
Bas 
= 
wo 
|) 
я 
— 
vi 


Функция | Синтаксис Описание 


long double ceill(long double x) округление вверх: 
наименьшее целое, 
не меньшее х 


ie | 
& 

с | 
ч | 


= 
Е 


div_t div(int numer, int denom) math.h 


typedef struct { 


div целочисленное деле- 


ние numer / denom 


int quot; // частное 
int rem; // остаток 
} div_t; 


double exp(double x) 
long double expl(long double x) 
fabs _| double fabs(double x) 


long double fabsl(long double x) 


double floor(double x) округление вниз: 
наибольшее целое, 
не большее х 


Math.hpp | 


int Floor(Extended Х); округление вниз: 


наибольшее целое, 
не большее Х 


long double floorl(long double x) округление вниз: 
наибольшее целое, 
не большее х 


double fmod(double x, double у). 
| x/y 

long double fmodl(long double x, остаток от деления math.h_ | 
long double у) x/y 


double frexp(double x, разделяет x Ha MaH- 
int *exponent) |тиссу (возвращает) и 
степень exponent 


и 
ы 
© 
‘a 
к. 


void Frexp(Extended X, разделяет X Ha ман- | Math.hpp 
Extended & Mantissa, тиссу Mantissa и сте- 


int & Exponent) пень Exponent 


разделяет X Ha ман- /|math.h 
тиссу (возвращает) и 


степень exponent 


long double frexpl(long double x, 
int *exponent) 


IntPower | Extended IntPower(Extended возводит Base в це- | Math.hpp 


Base, int Exponent) лую степень Ехро- 


nent 


| 
| 


long labs(long int x) stdlib.h | 
double Idexp(double x, int exp) math.h | 
Ldexp Extended Ldexp(Extended X, int P) Math.hpp | 


long double Idexpl(long double x, 
ш 11$ ехр) 
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‘Idiv typedef struct { целочисленное деле- 
long int quot; // целое ние: 
long int rem; // остаток 

} Idiv_t; 
Idiv_t Idiv(long int numer, quot — результат 
long int denom) rem — остаток 


/LnXP1 Extended LnXP1(Extended X) натуральный лога- Math.hpp 
рифм (X + 1) | 
| double log(double x) натуральный 
ь логарифм 
10510 double log10(double x) десятичный 
| логарифм 
Logi0 Extended Log10(Extended X) десятичный Math. hpp 
логарифм 
[10510 long double log10l(long double x) |десятичный math.h 
логарифм 
Log? Extended Log2(Extended X) логарифм по Math.hpp 
основанию 2 
long double logl(long double x) натуральный 
логарифм 
Том Extended LogN(Extended Base, логарифм X по Math. a 
Extended X) основанию Base 


aa ee oe 


максимальное значе- 
min(a, b) 


numer / denom; 


ние 43 au b любых 
типов 


макрос возвращает 
минимальное значе- 
ние изаи Ь любых 
типов 


double modf(double x, 
double *ipart) 


разделяет x на целую | math.h 
часть ipart и возвра- 
щаемую дробную 

часть 


long double modfl(long double x, 
long double *ipart) 


разделяет х Ha целую | math.h 
часть ipart и возвра- 
щаемую дробную 

часть 


полином OT х степени | math.h 


degree с коэффици- 

ентами coeffs 
Extended Poly(Extended X полином OT X степе- 
const double * Coefficients, ни Coefficients Sive 


Poly 3 : 
const int Coefficients Size) jc hs ia } | 


double poly(double x, int degree, 
double coeffs[]) 
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Функция |Синтаксис Описание Файл — 


| polyl long double polyl(long double x, . полином OT x степе- |math.h 
| int degree, long double coeffs[]) ни degree с коэффи- 
циентами coeffs 


pow | double pow(double x, double у) Eee oe Ee 
x 


Extended Power(Extended Base, возводит Base в сте- |Math.hpp/| 
Extended Exponent) | next Exponent | 

long double powl(long double x, y | 
long double y) | 


double sqrt(double x) корень квадратный 


Комментарии 

При работе с математическими функциями надо иметь в виду, что файлы 
math.h и Ма ®.Врр в C++Builder 5 автоматически не подключаются к модулю ва- 
шего приложения. Поэтому для использования описанных в этих файлах функций 
необходимо вручную вводить директивы 


#include <math.h> 
#include <Math.hpp> 


Функции exp, expl, 14ехр, Idexpl в. случае выхода аргумента за диапазон до- 
пустимых значений генерируют ошибку ERANGE. 

Функции log, 10210, 105101, 1051 в случае отрицательного аргумента генериру- 
ют ошибку ERANGE, а при нулевом аргументе — EDOM. 
| Функции ром и ром генерируют ошибку EDOM, если x < Оиуне является це- 
лым числом, а также если x = 0 u y <= 0. Возможно также появление ошибки 
ЕКА МСЕ. 

Функции sqrt и sqrtl генерируют ошибку EDOM, если x < 0. 

Функции файла Math.hpp в основном повторяют возможности функций файла 
math.h, но для типа Extended. 


15.2.3 Тригонометрические функции 


| 
| long double acosl( math.h 
| long double x) 

| ArcCos Extended ArcCos( арккосинус Math.hpp 

| Extended X) 


| 
| 
| 
| 
] 
| 
| 


| ArcSin Extended ArcSin( Math.hpp 
Extended X) 
Extended ArcSinh( арксинус гиперболический 
Extended Х) 
арктангенс (У / X) Math.hpp 


| 
| 
| 


с 
© 
Ww 
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Синтаксис Описание 


ArcTanh Extended ArcTanh( арктангенс 
Extended X) |гиперболический 


double asin(double x) 


long double asinl( арксинус 
long double x) 


double atan(double x) арктангенс 


double atan2( арктангенс у / x 
double y, double x 


long double atan2Il(long |арктангенсу / x 

double y, long double x) 

long double atanl(long арктангенс 
double x) 


double cos(double x) math.h о 
Нова x) те 


Extended Cosh( косинус гиперболический | Math. hpp 
Extended X) 
long double coshl( косинус гиперболический |math.h 
long double x) 
long double cosl( косинус 
long double x) 
Extended Cotan( котангенс Math.hpp 
Extended X) 


CycleToRad | Extended CycleToRad( вычисляет угол в радианах | Math.hpp 
Extended Cycles) | mo его значению в перио- 
дах Cycles: 2х: Cycles. 


| 
} 
| 
| 
| 


= 
> 
— 
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Extended DegToRad( вычисляет угол в радианах | Math.hpp 
Extended Degrees) | по его значению в градусах 


Degrees: Degrees: x / 180. 


double hypot( гипотенуза треугольника с |math.h 
double x, double у) |катетами хиу 

Extended Hypot( расчет гипотенузы по кате- 

Extended X, Extended У) |там Хи У 

long double hypotl(long |гипотенуза треугольника с |math.h 

double x, long double у) | Kareramu x u y ) 


RadToCycle | Extended RadToCycle( вычисляет угол в периодах | Math.hpp 
Extended Radians) | no его значению в радианах 
Radians: Radians / (27). 


Extended RadToDeg( вычисляет угол в градусах |Math.hpp 
Extended Radians) | по его значению в радиа- 
нах Radians: 


RadToDeg 


Radians : 180 / л. 


double sindouble x) jemuye [а 


| | a 
ie) 
© 
Е. 
№ 
| 
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Файл 
SinCos void SinCos(Extended расчет синуса Sin и коси- | Math.hpp 
Theta, Extended &Sin, |нуса Cos угла Theta 
| Extended &Cos) 


Extended Sinh( синус гиперболический Math.hpp | 
Extended X) 


double sinh(double x) math.h 


long double sinhl( синус гиперболический 
long double x) 
| long double sinl( синус 
long double x) 
| Tan _ | Extended Tan( тангенс 
Extended Х) 


ап | double tan(double x) 


|Tanh Extended Tanh( тангенс гиперболический | Math.hpp 
| Extended X) 


double tanh(double x) 


long double tanhl( тангенс гиперболический | math.h 
| long double x) : 

long double tanl( тангенс 
| long double x) АА 


L 


Комментарии 

При работе с тригонометрическими функциями надо иметь в виду, что файлы 
math.h и Math.hpp в C++Builder 5 автоматически не подключаются к модулю ва- 
шего приложения. Поэтому для использования описанных в этих файлах функций 
необходимо вручную вводить директивы 

. #include <math.h> 

#include <Math.hpp> 

Во всех тригонометрических функциях угол задается в радианах. Пересчет 
угла в радианы из значения, заданного в градусах или периодах, позволяют осуще- 
ствить функции DegToRad и CycleToRad. Например, оператор 

double Rad = БедТоВаа (90); 


‚ заносит в переменную Ка4 значение угла 90 градусов в радианах. То же самое зна- 
чение заносит в переменную Ва4 оператор 

double Rad = Сус1еТоВаа (0.25); 
в котором значение угла задано в периодах (четверть периода). Следующее выра- 
жение вычисляет синус 90 градусов: 

double $ = sin(DegToRad (90)); 


Все обратные тригонометрические функции вычисляют главные значения: 
acos и acosl — в диапазоне [0, д], asin, asinl, atan, atan2, аёап21, atanl — в диапа- 
зоне [-л/2, л/2]. Результат возвращается в радианах. Пересчет угла в радианах в 
значения градусов или долей периода позволяют осуществить функции RadToDeg 
и КадТоСуе. Например, операторы 


double А = atan(T); 
double Al = RadToDeg(atan(T) ); 
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double A2 = RadToCycle(atan(T)); 


вычисляют арктангенс Т в радианах (А), в градусах (Al) и в долях периода (А2). 

В функциях acos, acosl, asin, asinl, если заданный аргумент не попадает в 
диапазон значений [-1, + 1], происходит ошибка выхода за пределы области опре- 
деления (EDOM). 

В гиперболических функциях cosh, coshl, sinh, $111, если заданный аргумент 
слишком велик, происходит ошибка выхода за диапазон допустимых значений 
(ERANGE). 


15.2.4 Генерация псевдослучайных чисел 


|Фушкция пенни у асан _ |Файл | 


long _lrand(void) stdlib.h 
Псевдослучайное целое, диапазон от 0 до 231 - 


int rand(void) 
Псевдослучайное целое, диапазон от 0 до RAND MAX 


/RandG Extended RandG(Extended Mean, Extended StdDev) Math. hpp | 
Псевдослучайные числа, распределенные по нормально- 


му закону; Меап — математическое ожидание, 
StdDev — среднее квадратичное отклонение 


| гапдот int random(int num) 
| Псевдослучайное целое, диапазон от 0 до num - 1 


| 
randomize | void randomize(void) 
Рандомизация генераторов (кроме RandG) случайной 


величиной 


| Вап4ош!- | void Randomize(void) Math.hpp 
| ze Рандомизация RandG случайной величиной 


`згап@ void srand(unsigned seed) stdlib.h 
| | Рандомизация генераторов (кроме RandG) числом seed |. | 


Комментарии 

Функция rand возвращает целые псевдослучайные числа, равномерно распре- 
деленные в диапазоне oT 0 до RAND MAX (0x7FFFU - 32767). Длина отрезка апе- 
риодичности псевдослучайных чисел 232 = 4 294 967 296. Число используемых 
случайных чисел не должно превышать эту величину. Если вам все-таки требуется 
больше чисел, то вы должны при приближении к границе отрезка апериодичности 
(а лучше задолго до нее) обновить последовательность чисел с помощью функций 
randomize или srand. 

Если желательно генерировать случайные числа, лежащие в диапазоне от 0 до 
некоторого значение М, то это легко делать операцией вычисления остатка %. Ha- 
пример, выражение 


rand() % 101 


возвращает числа в диапазоне OT 0 до 100, a выражение 
(гапа() % 201) - 100 
возвращает числа в диапазоне от -100 до 100. 


Функцию rand можно использовать и для генерации действительных случай- 
ных чисел. Например, выражение 


10. * rand() / RAND МАХ 
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генерирует псевдослучайные действительные числа, распределенные в диапазоне 
от 0 до 10. 

Функция _Irand работает аналогично функции rand, но имеет отрезок аперио- 
дичности 264 и диапазон от 0 до 231 - 1. 

Функция random отличается от предыдущих тем, что имеет параметр пит, 
определяющий верхнюю границу диапазона генерируемых чисел. Поэтому, если | 
надо, например, генерировать числа в диапазоне от 0 до 100, это можно сделать 
выражением 


гапаом (101); 


не прибегая, как для предыдущих функций, к операции %. 

Функция RandG генерирует квазислучайные действительные числа, распре- 
деленные но нормальному закону (закону Гаусса) с математическим ожиданием 
Mean и средним квадратичным отклонением StdDev. При работе с этой функцией 
надо иметь в виду, что файл Math.hpp в C++Builder 5 автоматически не подключа- 
ется к модулю приложения. Поэтому в модуль необходимо вручную вводить ди- 
рективу 


#include <Math.hpp> 


Поскольку генерируемые рассматриваемыми функциями числа являются 
псевдослучайными, то при каждом новом запуске вашего приложения будет выра- 
батываться одна и та же последовательность чисел. Если это недопустимо, надо 
рандомизировать генератор чисел, т.е. задавать ему каждый раз новое случайное 
исходное число. Рандомизацию всех генераторов, кроме RandG, осуществляет 
функция randomize. Достаточно вставить где-то в текст программы (например, в 
событие OnCreate формы) оператор 


гапаот12е(); 


чтобы при каждом запуске приложения генерировалась новая последовательность 
чисел. 

Функция srand отличается от randomize тем, что задает в качестве начального 
не случайное число, а значение своего параметра seed. 

Рандомизацию генератора RandG осуществляет функция Randomize, анало- 
гичная randomize. Задание конкретного начального числа для этого генератора 
можно осуществить, задавая значение целой переменной RandSeed, определенной 
в файле System.hpp. 


15.2.5 Функции обработки статистических данных 


Приведенные ниже функции обрабатывают данные, хранящиеся в массиве 
Data, в котором максимальное значение индекса равно Data_Size. 


| Функция ____ | Синтаксис / Они 


| MaxIntValue int MaxIntValue( const int * Data, Math.hpp 

| ; const int Data_Size) | 
Максимальное значение 

| МахУаше double MaxValue(const double * Data, 

| const int Data_Size) 

| Максимальное значение 4 | 


Extended Mean(const double * Data, Math. hpp | 
const int Data_Size) 


: Среднее значение (математическое ожидание) 
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void MeanAndStdDev(const double * Data, 
const int Data_Size, 


Extended & Mean, 
Extended &StdDev) 


Среднее значение Mean и среднее квадратичное от- 
клонение StdDev 


: MinInt Value int MinIntValue(const int * Data, Math.hpp 
| const int Data_Size) 


Минимальное значение 


| МшУаше double MinValue(const double * Data, Fieri | 
| const int Data_Size) | ; 


Минимальное значение | 


void MomentSkewKurtosis(const double * Data, Math.hpp 
const int Data_Size, Extended &M1, 
Extended &M2, Extended &M3, 
Extended &M4, Extended &Skew, 
Extended &Kurtosis) 


Первые четыре момента M1, M2, МЗ, M4, коэффи- 
циент асимметрии Skew, эксцесс Kurtosis 


Extended Norm(const double * Data, 
const int Data_Size) 


| MomentSkew- 
| Kurtosis 


Эвклидова норма: корень из суммы квадратов 


Extended PopnStdDev(const double * Data, Math.hpp 
const int Data_Size) | 


| PopnStdDev 


Смещенная оценка среднего квадратичного откло- | 
нения 


| PopnVariance | Extended PopnVariance(const double * Data, Math.hpp 
| const int Data_Size) 
: CSiourentad оценка дисперсии (cm. Variance). 


Extended StdDev(const double * Data, 
const int Data_Size) 


Несмещенная оценка среднего квадратичного OT- 
клонения 


Extended Sum(const double * Data, 


| const int Data_Size) 
= Сумма значений 
Сумма значений 
Extended SumOfSquares(const double * Data, Math.hpp 
const int Data_Size) | 
_|Сумма. квадратов знач. значений 


29 зак 322 


void SumsAndSquares(const double * Data, Math.hpp 
const int Data_Size, Extended &Sum, 


; Extended &SumOfSquares) 


Сумма Sum и сумма квадратов значений SumOf- 
Squares 


Extended TotalVariance(const double * Data, 
const int Data_Size) 


SumsAndSqua- 
| гез 


Total Variance 


Сумма квадратов отклонений от среднего значения 


Variance Extended Variance(const double * Data, Math.hpp 


const int Data_Size) 
Несмещенная оценка дисперсии (cm. | PopnVariance) | _ 


Комментарии — 
Файл Math.hpp в C++Builder 5 автоматически не подключается к модулю при- 
ложения. Поэтому в модуль необходимо вручную вводить директиву 


#include <Math.hpp> 


Функция MeanAndStdDev рассчитывает среднее значение (математическое 
ожидание) и среднее квадратичное отклонение за один проход. Поэтому расчет вы- 
полняется вдвое быстрее, чем при поочередном применении функций Mean и 
StdDev. Точность вычислений может быть несколько пониженной при очень боль- 
ших значениях математического ожидания (> 107) или очень малых дисперсиях. 

Значение среднего квадратичного отклонения, возвращаемое функциями 
MeanAndStdDev и StdDev — это несмещенная оценка. Она несколько отличается 
OT смещенной оценки, возвращаемой функцией PopnStdDev, поскольку при не- 
смещенной оценке сумма квадратов отклонений делится на (п - 1), а при смещен- 
ной — на п. По той же причине разнятся значения дисперсий, возвращаемые 
функциями Variance и PopnVariance. 

Тест для проверки функций` статистической обработки данных может иметь, 
например, следующий вид: 

double А[1001]; 

long double М, StdD,StdD2,M1,M2,M3,M4, Skew, Kurtosis; 

// заполнение массива нормально распределенными числами 

For (Tint: a: = -0; 1°< 40617 3+) 

А[1] = RandG(20,4); 


double у = Variance (А, 1000); 
MeanAndStdDev(A,1000, М, StdD); 


StdD2 = PopnStdDev(A,1000) ; 
MomentSkewKurtosis (A,1000,M1,M2,M3,M4, Skew, Kurtosis) ; 


15.2.6 Вспомогательные функции 


| Функция |Синтаксие / Опа | alton 


_clear87 unsigned int _clear87 (void) float.h | 


Очищает слово статуса плавающей запятой 
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unsigned int mask) 
Манипулирует словом контроля плавающей запятой 
void _fpreset(void) 


Повторно инициализирует пакет математики с плавающей 
запятой 


| 
| 


[ 
| 
| 
| 
| 


15.3 Преобразование типов данных 


15.3.1 Функции взаимного преобразования чисел и строк 


15.3.1.1 Функции взаимного преобразования чисел и строк типа Char * 


Синтаксис / Преобразует 


__int64 _atoi64(const char *s) 
| Строку $ в целое 

long double _atold(const char *s) math.h 
sat Строку $ в число с плавающей запятой 


| i64toa | char *_i64toa(__int64 value, char *strP, int radix) 
| Целое value в строку; radix — основание (от 2 до 36) 


wchar_t *_itow(int value, wchar_t *string, int radix) stdlib.h 
Целое value в строку string по основанию radix 


Rear char *_ltoa(long value, char *string, int radix) = 

| Целое value в строку; radix — основание (от 2 до 36) 
cama long double _strtold(const char *s, char **endptr) 

| Строки $ в действительное число 


_ui64toa |char *_ui64toa(unsigned __int64 value, char *strP, 
int radix) 
| Целое value в строку; radix — основание (от 2 до 36) 
| wehar_t *_ultow(unsigned long value, wchar_t *string, 
int radix) 


Целое value в строку string по основанию radix 


ont long double _westold(const wchar_t *s, wchar_t **endptr) 


Строку $ в действительное число 


double _wtof(const wchar_t *s) math.h 
Строку $ в число с плавающей запятой 


| int _wtoi(const wchar_t *s) 
| Строку $ в целое 


| 
| 


В 


о 
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| 
| 
| 
| 
| 
| 


| 
| 
| 
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Синтаксис / Преобразует Фай 
__int64 _wtoi64(const wchar_t *s) 


Строку $ в целое 


Е 


| 


| 
| 
| 
| 


long _wtol(const wchar_t *s) 


Строку $ в целое 


long double _wtold(const wchar_t *s) 
Строку $ в число с плавающей запятой 
double atof(const char *s) stdlib.h, | 


Строку $ в число с плавающей запятой math.h | 


int atoi(const char *s) 7 stdlib.h | 


Строку $ в целое 


] 
} 
| 
| 
| 
| 


| 
| 


| 
} 
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atol long atol(const char *s) 


Строку $ в целое 


ecvt stdlib.h 


char *ecvt(double value, int ndig, int *dec, int *sign) 


Число с плавающей запятой value в строку с числом 
цифр ndig; dec сохраняет позицию десятичной точки, 
sign — знак 


fevt char *fcvt(double value, int ndig, int *dec, int *sign) stdlib.h 


Число с плавающей запятой value в строку с числом 
цифр ndig; dec сохраняет позицию десятичной точки, 
sign — знак 


gevt char *gcevt(double value, int ndec, char *buf) stdlib.h 
value в строку buf с числом цифр ndec 


char *itoa(int value, char *string, int radix) 

Целое value в строку string по основанию radix 
double strtod(const char *s, char **endptr) stdlib.h | 
Строку $ в действительное число | 


long strtol(const char *s, char **endptr, int radix) 


Строку $ в длинное целое 


unsigned long strtoul(const char *s, char **endptr, 
-int radix) 


Строку $ в unsigned long по основанию radix 


char *ultoa(unsigned long value, char *string, int radix) 
Целое value в строку string по основанию radix 

double westod(const wchar_t *s, wchar_t **endptr 
Строку $ в действительное число 


| westol long westol(const wchar_t *s, wchar_t **endptr, int radix)|stdlib.h | 
Строку $ в длинное целое 


unsigned long westoul(const wchar_t *s, 
wchar_t **endptr, int radix) 


Строку $ в unsigned long по основанию radix 


\ 
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Комментарии 

Функции преобразования строки в число требуют, чтобы строка была записа- 
на в формате чисел соответствующего типа. Преобразование прерывается, когда 
функция встречает первый символ, не соответствующий требуемому формату. 
Если формат вообще не соответствует ожидаемому, функции возвращают 0. 

Функции atof и strtod распознают кроме соответствующих цифровых после- 
довательностей тексты «+1МЕ» и «-INF», которыми обозначаются плюс и минус 
бесконечности, а также тексты «+МАМ» и «-МАМ», обозначающие «He цифровая 
величина». 

В функциях strtod, strtol, strtold, strtoul, westod, westol, westoul параметр 
endptr может задаваться равным NULL. Например, оператор: 


double у = strtod(Editl->Text.c str(),NULL); 


преобразует текст, введенный пользователем в окне редактирования Editl, в зна- 
чение у. Если же задать параметр endptr: 

char *endptr; 

double у = strtod(Editl->Text.c str(),é&endptr) ; 
то величина *endptr будет равна тому символу, на котором остановилось преобра- 
зование строки. Этот параметр можно использовать для проверки правильности 
преобразуемой строки. 

Если при преобразовании наступает переполнение, то функции возвращают 
положительные или отрицательные значения НОСЕ_УАТ, (для типа double) или 
LHUGE_VAL (для типа long double). 

Рассмотренные функции преобразования можно использовать и для типа 
строк AnsiString (см. раздел 15.4.2.3). Но при этом эти строки надо переводить в 
тип char * с помощью метода с_5%г(), как показано в двух предыдущих примерах. 


15.3.1.2 Функции взаимного преобразования чисел и строк, описанные 
в файле SysUtils.hpp 


ВИНА ВОНИ ОЗ ED SR, ——— 


| СиггТо5 г System::AnsiString CurrToStr(System::Currency Value) 
| Число Value типа Currency в строку | 


|CurrToStrF System::AnsiString CurrToStrF(System::Currency Value, 

| TFloatFormat Format, int Digits) 
| Число типа Currency в строку с помощью формата типа 

| TFloatFormat (cm. раздел 15.1.4.4) 


|FloatToDecimal | void FloatToDecimal(TFloatRec &Result, const void *Value, 
| TFloatValue ValueType, int Precision, int Decimals) 


Число Value типа ValueType (cm. TFloatValue в разде- 
ле 15.1.4.4) в структуру TFloatRec 


| FloatToStr _|System::AnsiString FloatToStr(Extended Value) 
Число Value в строку 


| FloatToStrF System::AnsiString FloatToStrF(Extended Value, 
TFloatFormat Format, int Precision, int Digits) 
Число Value в строку с помощью формата Tuna TFloatFor- 
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бизниеые: / Fivsntwasioe 


FloatToText int FloatToText(char * Buffer, const void *Value, 


TFloatValue ValueType, TFloatFormat Format, 
FloatToTextFmt 


int Precision, int Digits) 


Число Value типа ValueType в строку Buffer. с помощью 
формата типа TFloatFormat (см. раздел 15.1.4.4) 


int FloatToTextFmt(char * Buffer, const void *Value, 
TFloatValue ValueType, char * Format) 


Число Value tuna ValueType (cm. TFloatValue в разде- 
ле 15.1.4.4) в строку Buffer с помощью формата FormatFlo- 
at (см. раздел 15.1.4.5) 


void FmtStr(System::AnsiString &Result, 
const System::AnsiString Format, 
const System::TVarRec * Args, const int Args_ Size) 


Аргументы из открытого массива Args размера Args_ Size -1. 
в строку Result по формату Format (см. раздел 15.1.4.3) 


System::AnsiString Format(const System::AnsiString 
Format, const System::TVarRec* 
Args, const int Args_ Size) 

Аргументы из открытого массива Args размера Args_ Size -1 

в строку по формату Format (см. раздел 15.1.4.3) 


Cardinal FormatBuf(void *Buffer, Cardinal BufLen, 
const void *Format, Cardinal FmtLen, 
const System::TVarRec * Args, const int Args Size) 


| FormatBuf 


FormatFloat 


GetFormatSet- 
| tings 


Аргументы из открытого массива Args размера Args_ Size -1 
в строку Buffer длины BufLen по формату Format (см. раз- 
дел 15.1.4.3) длины FmtLen 


System::AnsiString FormatCurr(const System:: AnsiString 
Format, System::Currency Value) 


Число tuna Currency в строку с помощью формата функции 
FormatFloat (см. раздел 15.1.4.5) 


System::AnsiString FormatFloat(const System::AnsiString 
Format, Extended Value) 


Число Value в возвращаемую строку с помощью формата TH- 
па FormatFloat (см. раздел 15.1.4.5) 


void GetFormatSettings(void) 
Устанавливает значения по умолчанию всех глобальных пе- 


ременных, определяющих форматы дат и чисел 
System::AnsiString IntToHex(int Value, int Digits) 


IntToHex $s iStri i i igi 
Целое Value в строку с минимум Digits шестнадцатеричных 
цифр 
PIII of her IntToStr(int Value) 
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Функция Синтаксис / Преобразует | 
| 


StrFmt char * StrFmt(char * Buffer, char * Format, 


StrLFmt 


Строку $ в число Tuna Currency 
Строку 8 в число 
Строку 3 в целое 
StrToIntDef int StrToIntDef(const System::AnsiString S, int Default) 
ее Строку $ в целое, при ошибке — значение Default по умол- 
чанию 


| TextToFloat bool TextToFloat(char * Buffer, void *Value, 
TFloatValue ValueType) : 
Crpoxy Buffer в число Value tuna ValueType (cm. TFloatVa- 


const System::TVarRec * Args, const int Args_ Size) 
Аргументы из открытого массива Args размера Args_ Size -1 
в строку Buffer по формату Format (см. раздел 15.1.4.3) 


char * StrLFmt(char * Buffer, Cardinal MaxLen, 
char * Format, const System::TVarRec* Args, 
const int Args_ Size) 


Аргументы из открытого массива Args размера Args Size -1 
в строку Buffer размера MaxLen по формату Format (см. 


раздел 15.1.4.3) 


| 
| 
| 
| 


лиана рнинвионнийй 


Комментарии 

Многие функции взаимного преобразования чисел и строк, объявленные в 
файле SysUtils.hpp, используют для указания типа числа переменную ValueType, 
которая может принимать значение fvExtended — число с плавающей запятой 
типа Extended, или значение fvCurrency — число типа Currency. Многие функции 
используют для форматирования строку типа TFloatFormat, подробно описанную 
в разделе 15.1.4.4, или формат функции FormatFloat, описанный в разде- 
ле 15.1.4.5, или строку форматирования функции, Format, описанную в разде- 
ле 15.1.4.3. 

Ряд функций получает список форматируемых значений из открытого масси- 
ва аргументов Args размера Args_Size -1. В качестве Args Size в них задается по- 
следний индекс массива Args типа TVarRec. В этих функциях используется стро- 
ка форматирования, описанная в разделе 15.1.4.3. Приведем пример использова- 
ния одной из таких функций — функции Format: 

AnsiString $; 

TVarRec Args[3] = {11, -1.1е+08, 0.00011}; 

$ = Format ("%а tg %Е %0:10а %10g %10.5Е", Args, 2); 


В этом примере объявлена переменная $, в которую производится запись pe- 
зультатов форматирования, и массив Args, в который занесены форматируемые 
числа. Обратите внимание на то, что размер массива равен 3, а в функцию Format 
передается в качестве размера число 2 — максимальное значение индекса, на 1 
меньшее размера. Если бы нужно было форматировать не все три, а, например, 
только два первых числа массива, то в качестве размера можно было бы передать 1. 
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Строка форматирования в этом примере сначала заносит в строку $ значения 
элементов массива по форматам % 4, %#, % Ё, оставляя между ними пробелы (про- 
белы между спецификациями в строке форматирования переносятся в строку ре- 
зультата). Затем спецификация % 0:104 сбрасывает индекс массива на 0, приводя 
к повторному форматированию элементов массива. Повторно они форматируются 
с заданной шириной поля 10, а последнее число еще и с заданной точностью 5. 


Для ссылки на массив аргументов можно было бы воспользоваться макросом 
EXISTINGARRAY (см. раздел 15.7.4): 


5 = Еогтаф ("%а %g %Е %0:10а %104 %10.5£",EXISTINGARRAY (Args) ); 


Можно было бы и не создавать заранее массива аргументов, а сформировать 
его непосредственно в вызове функции Format с помощью макроса OPENARRAY 
(см. раздел 15.7.4): 


$ = Format("%d %g %Е %0:10а %10g %10.5Е", 
OPENARRAY (TVarRec, ( 11, -1.1е+08, 0.00011))); 


При ошибках преобразования рассматриваемые в данном разделе функции ге- 
нерируют исключение EConvertError. Это правило не затрагивает фунцию. 
StrToIntDef, которая в случае ошибки заносит в результат указанное в ней значе- 
ние по умолчанию. 

Функция FloatToDecimal ИН число с плавающей запятой типа 
Extended или Currency в десятичное представление, которое может в дальнейшем 
‚ подвергаться дополнительному форматированию. Для значения типа Extended na- 
раметр Precision указывает число значащих цифр от 1 до 18. Для значения типа 
Currency параметр Precision игнорируется, а точность предполагается равной 19 
разрядам. 

Параметр Decimals указывает максимально требуемое число цифр слева от де- 
сятичной точки. Таким образом, параметры Precision и Decimals совместно опре- 
деляют способ округления результата. Чтобы результат всегда имел заданное ко- 
личество значащих цифр независимо от значения числа, можно указать Decimals 
равным 9999. 

Результат преобразования заносится в структуру типа TFloatRec, имеющую 
поля: 


Exponent Хранит к количество значащих цифр до десятичной © точки. Если 
число меньше 1, то поле Exponent содержит отрицательное число, 
модуль которого равен номеру первого значащего разряда после 
десятичной точки. Если значение равно МАМ (не число), Exponent 
равняется -32768. Если значение INF или -INF (плюс или минус 
бесконечность), то Exponent = 32767 


Negative При отрицательном числе — true, при положительном или 
нуле — false 


Digits Строка с нулевым символом в конце, содержащая до 18 (для Ex- 
tended) или 19 (для Currency) значащих цифр. Десятичная точка 
не хранится. Завершающие нули удаляются. Если число рано 
нулю, МАМ или INF, Digits содержит только нулевой символ 


Ниже приведен пример использования функции FloatToDecimal!l: 


struct TFloatRec PES OAKS 
Extended Value = ат 
FloatToDécimal (Result, &Value, fvExtended, 18, 9999) ; 


При различных значениях Value получаются результаты: 
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Value Exponent [Negative |Digits 
123.4567890123456789 |3 = [12 = 1123456789012345681 
| 1234567890123456789 19 [14 = [|123456789012345679 


|-0.001234567890123456789 |-2 true 1123456189012345671 _ 


15.3.2 Функции преобразования дат и времени 


[Функция __ |Синтакоие / Onuecamme | Dalton 


asctime _ char *asctime(const struct tm *tblock) 


Переводит структуру типа tm в строку 


char *ctime(const time_t *time) 


Переводит время time, полученное функцией 
time, в строку 


| System::TDateTime Date(void) SysUtils.hpp 
Возвращает текущую дату 


DateTimeToFile- | int DateTimeToFileDate( SysUtils.hpp 


Date System::TDateTime DateTime) 


Переводит DateTime в формат DOS 


DateTimeToStr (|System::AnsiString DateTimeToStr( 


System::TDateTime DateTime) 
Преобразует DateTime в строку 


SysUtils.hpp 


SysUtils.hpp 


SysUtils.hpp 


SysUtils.hpp 


| DateTimeToSt- 
ring 


void DateTimeToString( 
System::AnsiString &Result, 
const System::AnsiString Format, 
System::TDateTime DateTime) 


Преобразует DateTime в строку Result по фор- 
мату Format 


| DateTimeToSys- 
temTime 


void DateTimeToSystemTime( 
System::TDateTime DateTime, 
_SYSTEMTIME &SystemTime) 


Преобразует DateTime в формат TSystemTime, 
используемый в API Windows 


DateTimeToTi- 
meStamp 


TTimeStamp DateTimeToTimeStamp( 
System::TDateTime DateTime) 


Преобразует DateTime в TTimeStamp 


System::AnsiString DateToStr( 
System::TDateTime Date) 


Преобразует дату Date в строку 
int DayOfWeek(System::TDateTime Date) 


Извлекает из даты Date день недели (oT 1 до 7, 
1 — воскресенье) 


DateToStr SysUtils. ras 


SysUtils.hpp 


DayOfWeek 
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Функция [Синтаксие /Onmcamme [Фа | 


| DecodeTime void DecodeTime(System::TDateTime Time, SysUtils.hpp 
Word &Hour, Word &Min, 
Word &Sec, Word &MSec) 
| Разбивает Time на часы Hour, минуты Min, 
секунды Sec, миллисекунды MSec 
EncodeDate TDateTime EncodeDate(Word Year, 
Word Month, Word Day) 
) Преобразует год Year, месяц Month и день 
Day в TDateTime 
TDateTime EncodeTime(Word Hour, 


SysUtils.hpp 


SysUtils.hpp 


Word Min, Word Sec, Word MSec) 


Преобразует часы Hour, минуты Min, секунды 
Sec и миллисекунды MSec в TDateTime 


_FormatDateTime System::AnsiString FormatDateTime( SysUtils.hpp 
const System::AnsiString Format, 


System::TDateTime DateTime) 


Преобразует DateTime в строку по формату 
Format 


ee 
Заносит в datep текущую дату | 
void gettime(struct time *timep) 

Заносит в Ятер текущее время 

struct tm *gmtime(const time_t *timer) time.h 
oe Переводит время timer, полученное функцией 

time, в структуру типа tm 


const System:: TDateTime Date, 
int NumberOfMonths) 


Возвращает дату Date, измененную Ha Num- 


Е System::TDateTime IncMonth( SysUtils.hpp 
berOfMonths месяцев 

IsLeapYear_. bool IsLeapYear(Word Year) SysUtils.hpp 
| localtime struct tm *localtime(const time_t *timer) time.h 
oe Переводит время timer, полученное функцией 

| time, в структуру типа tm с поправкой Ha ло- 

| кальное время 

time_t mktime(struct tm *t) 


MSecsToTime- 
Stamp 


Переводит время из структуры типа tm в фор- 
мат time_t 


TTimeStamp MSecsToTimeStamp( 
System::Comp MSecs) 


Преобразует миллисекунды MSecs в TTime- 
Stamp 


SysUtils.hpp 


| 
ee 
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ЕЕ 
2 


[ Функция _ Файл 


| Now System::TDateTime Now(void) SysUtils.hpp 


Возвращает текущую дату и время 
void setdate(struct date *datep) 


Задает дату datep как системную (если пользо- 
вателю разрешен доступ) 


Файл 
ie 
settime void settime(struct time *timep) 
| Задает время timep как системное 

| int stime(time_t *tp) м 
| Задает системную дату и время из tp 


| StrToDate System::TDateTime StrToDate( 
| const System::AnsiString S) 


Преобразует строку S в дату TDateTime 


System::TDateTime StrToDateTime( 
const System::AnsiString S) 


Преобразует строку S в дату и время TDateTi- 


| 
<< 
9) 
=, 
= 
=. 
г 
= 
к. 
к. 


System::TDateTime StrToTime( 
const System::AnsiString S) 


SysUtils.hpp 


Преобразует строку 8 во время TDateTime 


System::TDateTime SystemTimeToDateTime( SysUtils.hpp 


const SYSTEMTIME &SystemTime) 


Преобразует формат TSystemTime, используе- 
мый в API Windows, в TDateTime 


time_t time(time_t *timer) 


Возвращает текущее время и заносит его в ti- 
тег (если timer не NULL) 


‘Time System::TDateTime Time(void) SysUtils.hpp 
| 
| Возвращает текущее время 


| TimeStampTo- System::TDateTime TimeStampToDateTime( 
| DateTime const TTimeStamp &TimeStamp) 


SysUtils.hpp 
Преобразует структуру типа TTimeStamp в 
TDateTime 


System::Comp TimeStampToMSecs( 
const TTimeStamp &TimeStamp) 


SysUtils.hpp 


| Возвращает 64-разрядное значение числа мил- 
| лисекунд 
| 
| 


| TimeToStr System::AnsiString TimeToStr( 
| System::TDateTime Time) 
| Преобразует время в строку | 


SysUtils.hpp 


} 


Комментарии 
Функции рассмотренного вида используют тип TDateTime, представляющий 
собой число с плавающей запятой, целая часть которого содержит число дней, от- 
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считанное от 0 часов 12/30/1899, а дробная часть равна части 24-часового дня, от- 
считанная от 12 часов дня. Т.е. дробная часть характеризует время и не относится 
к дате. 

Например: 


чение TDateTime 


TR ee 
12/30/1899, 00 часов 
| 


275 1/1/1900, 18 часов 


(1.25 12/29/1899, 6 часов утра 
Prem . 1/1/1996, 00 часов | 


Некоторые функции используют также тип TTimeStamp. Это структура вида: 


struct TTimeStamp 
{ 

int Time; 

int Date; 

ae 

Поле Date содержит число дней с начала календаря (т.е. 1 января 1 года OTO- 
бражается как 1). Обратите внимание, что значения дат в типах TDateTime и 
TTimeStamp разные. Поле Time содержит время в миллисекундах, прошедшее с 0 
часов текущего дня. 

TDateTime обеспечивает более компактное представление дат и времени. Так 
что если вам не нужна точность до миллисекунд, лучше пользоваться типом 
TDateTime. 

Преобразование структуры типа TTimeStamp в TDateTime осуществляется 
функцией TimeStampToDateTime, обратное преобразование — функцией 
DateTimeToTimeStamp. Функция TimeStampToMSecs возвращает в виде 64-раз- 
рядного числа с плавающей запятой общее число миллисекунд, составленное из 
полей Date и Time. 

Имеется еще один формат представления дат и времени, принятый в DOS. 
Этот формат используется в таких функциях, как FileAge, FileGetDate, 
FileSetDate, в none Time структуры типа TSearchRec, применяемой в функциях 
FindFirst и FindNext. Перевод в этот формат значения типа TDateTime осуществ- 
ляется функцией DateTimeToFileDate. 

Наконец, имеется еще системный формат — TSystemTime, определенный как 
тип SYSTEMTIME. Он может требоваться при вызове функций API Windows. 
Преобразование TDateTime в этот формат осуществляется функцией 
DateTimeToSystemTime, а обратное преобразование осуществляется функцией 
SystemTimeToDateTime. 3 

В функциях DateTimeToString и FormatDateTime используется строка фор- 
матирования дат, которая может содержать следующие спецификаторы: 


ИИ ИЕ ПВО ПОСОЛ а О а В ий 


с Печать даты по формату, заданному глобальной переменной 
ShortDateFormat, а затем печать времени в формате, заданном 
глобальной переменной LongTimeFormat. Если дробная часть Da- 
teTime равна 0, время не печатается 


d Печать дня без начального нуля (1 - 31) 
dd Печать дня с начальным нулем (01 - 31) 
ddd Печать дня в виде аббревиатуры (пн-вс) с использованием глоба- 


льной переменной ShortDayNames 


Функции С, С++, библиотек C++Builder, АР! Windows 
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ddddd 


dddddd 


mmmm 
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Печать дня в виде его полного названия (понедельник - воскресе- 
нье) с использованием глобальной переменной LongDayNames 


Печать даты по формату, заданному глобальной переменной 
ShortDateFormat 


Печать даты по формату, заданному глобальной переменной Lon- 
gDateFormat 


Печать месяца без начального нуля (1-12). Ho если спецификатор 
т следует за спецификатором В или ВВ, то он означает печать 
минут 


Печать месяца с начальным нулем (01-12). Но если спецификатор 
mm следует за спецификатором В или hh, то он означает печать 
минут 


Печать месяца в виде аббревиатуры (янв-дек) с использованием 
глобальной переменной ShortMonthNames 


Печать полного названия месяца (Январь-Декабрь) с использова- 
нием глобальной переменной LongMonthNames 


Печать двух последних цифр года (00-99) 
Полная печать года (0000-9999) 

Печать часа без начального нуля (0-23) 
Печать часа с начальным нулем. (00-23) 
Печать минут без начального нуля (0-59) 
Печать минут с начальным нулем (00-59) 
Печать секунд без начального нуля (0-59) 
Печать секунд с начальным нулем (00-59) 


Печать времени по формату глобальной переменной ShortTime- 
Format 


Печать времени по формату глобальной переменной LongTime- 
Format 


Использование 12-часовой шкалы и символов «ат» или «рт». 
Регистр символов совпадает с регистром, в котором записан спе- 
цификатор 


Использование 12-часовой шкалы и символов «a» или «р». Ре- 
гистр символов совпадает с регистром, в котором записан специ- 
фикатор 


Использование 12-часовой шкалы и символов, записанных в гло- 
бальные переменные TimeAMString и TimePMString 


Печать разделителя дат, заданного глобальной переменной Date- 
Separator 


Печать разделителя времени, заданного глобальной переменной 
TimeSeparator 


Символы, заключенные в кавычки, a также любые символы, не 
совпадающие со спецификаторами, просто переносятся в выход- 
ную строку 
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Примеры форматирования: 


| Формат результат - 


и. 14.04.99 8:34:14 


"d/m/yy h:n" 14.4.99 8:34 
"Дата: 4 mmmm ууу г., день — dddd" Hara: 14 Апрель 1999 r., день — среда. 


Более простой, но и менее гибкий способ перевода дат и времени в строку, 
дают функции DateToStr, TimeToStr, DateTimeToStr, использующие установки 
глобальных переменных. 

Несколько функций — StrToDate, StrToDateTime, StrToTime осуществляют 
обратное преобразование — строки в дату, время или дату и время TDateTime. 
Функция StrToDate преобразует строку даты. Строка должна содержать две или 
три цифры, разделенных символом, указанным в глобальной переменной Date- 
Separator. Последовательность указания дня, месяца и года определяется гло- 
бальной переменной ShortDateFormat. Возможные варианты: m/d/y, d/m/y или 
у/т/4. Если указаны только два числа, они интерпретируются как дата (m/d или 
d/m) текущего года. Если год указан не более чем двумя цифрами (от 0 до 99), 
предполагается год текущего столетия. 

Функция StrToTime преобразует строку времени, которая должна содержать 
две или три цифры, разделенные символом, указанным в глобальной переменной 
TimeSeparator: hh:mm:ss. Секунды могут не указываться. Функция StrToDate- 
Time преобразует строку даты и времени с форматами, аналогичными предыду- 
щим функциям. 

При ошибках преобразования в рассмотренных функциях генерируется ис- 
ключение EConvertError. 

Функции из файла dos.h используют для хранения даты структуру типа date: 


Struct date{ 


int da _ year; // текущий год 
char da_ day; // день месяца 
char Ча mon; // номер месяца (1 - январь) 


}; 


Все данные хранятся в виде целых чисел, что облегчает их дальнейшую обра- 
ботку. Приведем пример использования такой структуры. Следующие операторы 
создают структуру D типа date и заносят в нее текущую дату: 


#include <dos.h> 
struct date D; 
getdate (&D) ; 


_ В дальнейшем можно обращаться к полям этой структуры: D.da_year, 
D.da_mon, D.da_day. 
Аналогичная структура предусмотрена и для хранения времени: 


struct time { 


unsigned char ti_min; // минуты 

unsigned char ti hour; // часы 

unsigned char ti_hund; // сотые доли секунды 
unsigned char ti_sec; // секунды 


}; 

Функция time возвращает текущее время в секундах, отсчитанное от 0 часов 1 
января 1970 по Гринвичу. Это время может быть преобразовано в строку с нуле- 
вым символом в конце, включающую год, месяц, день ит.д., с помощью функции 
ctime с учетом поправок на локальное время. Вид строки: 


Функции С, С++, библиотек C++Builder, АР! Windows 911 


Mon Nov 21 11:31:54 1983\n\0 


к сожалению, с английскими сокращениями. 

Время, возвращаемое функцией Ише, может также с помощью функций 
gmtime (время по Гринвичу) или localtime (время с локальной поправкой) преоб- 
разовываться в поля структуры типа tm: 


struct tm { 


int tm sec; // секунды 

int tm min; // минуты 

int tm hour; // часы (0 - 23) 

int tm mday; // день месяца (1 - 31) 

int см моп; // месяц (0 - 11) 

int tm уеаг; // год (календарный минус 1900) 

int tm_wday; // день недели (0 - 6; 0 - воскресенье 
int см удау; // день года (0 -365) 

int tm_isdst; // установлен ли 12-часовой формат 


}; 
Данная структура может быть преобразована в ВОН функцией asctime. Ha- 
пример, операторы: 


time © t = time(NULL) ; 

struct tm *tt = localtime(&t); 
char s[80]; 

$Егсру (5$, asctime(tt)); 


создают структуру типа tm, заносят в нее текущее время, получённое функцией ti- 
me и преобразованное функцией gmtime, после чего формируют строку $. Но учти- 
те, что строка получится аналогичной строке, возвращаемой описанной выше фун- 
кцией сте — т.е. использующей английские сокращения. 


15.3.3 Функции преобразования типов 


Синтаксис / Преобразует [Фа | 


Bounds Windows::TRect Bounds(int ALeft, int Atop, Classes.hpp 
int AWidth, int AHeight) 
Координаты ALeft и АТор и размеры AWidth и 


AHeight в TRect 


| Curr: bool CurrToFMTBCD(System::Currency Curr, DBCommon.hpp 
| ToFMTBCD Bde::FMTBed & BCD, 
int Precision, int Decimals) | 


Значение Curr в тип Bde::FMTBed | 
FMTBCDTo | bool FMTBCDToCurr(const Bde::FMTBed &BCD, |DBCommon.hpp 
Omer System::Currency &Curr) 

Значение BCD в тип Currency | 

TPoint Point(int AX, int AY) Classes. hpp 
| Координаты АХ и AY в TPoint 
| Windows::TRect Rect(int ALeft, int Atop, Classes. hpp 
| int ARight, int ABottom) 


Координаты ALeft, ATop, ARight, ABottom в 
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Комментарии | 

Функции CurrToFMTBCD и FMTBCDToCurr осуществляют взаимное преобра- 
зование типа Currency и типа Bde::FMTBed, используемого для хранения в полях 
BCD баз данных. 

Функции Bounds и Rect осуществляют заполнение структуры типа TRect, 
хранящей информацию о местоположении и размерах прямоугольника и исполь- 
зуемой во многих методах библиотеки компонентов. Определение этого типа см. в 
главе 16. Функция Rect задает значение переменной типа TRect координатами ле- 
вой, верхней, правой и нижней границ - ALeft, ATop, ARight, ABottom. Функция 
Bounds задает значение переменной типа TRect координатами левого верхнего уг- 
ла ALeft и ATop, шириной прямоугольника AWidth и его высотой AHeight. 

В C++Builder 5 эти функции применяются, в частности, для задания значений 
таким свойствам компонентов, как BoundsRect, ClientRect и др. Например, при- 
веденный ниже оператор размещает окно текстового редактора Memol на его роди- 
тельской панели Panell, оставляя слева, внизу и справа зазор в 10 пикселей (для 
более приятного вида), а сверху — зазор 40 пикселей (например, для размещения 
заголовка окна): 


Memol->BoundsRect = Вес (10,40, Panell->ClientWidth-10, 
Panell->ClientHeight-10) ; 


То же самое можно сделать оператором: 


Memol->BoundsRect = Bounds (10,40, Panell->ClientWidth-20, 
Panell->ClientHeight-50) ; 


Функция Point осуществляет заполнение структуры типа TPoint, хранящей 
информацию о координатах точки и используемой во многих методах библиотеки 
компонентов. Определение этого типа см. в главе 16. Тип TPoint может также ис- 
пользоваться в конструкторе типа TRect, позволяющем описывать область двумя 
точками — левый верхний и правый нижний углы. 

Ниже приведен ряд операторов, иллюстрирующих функции Rect и Point, a 
также применение типов TRect и TPoint: 

АВЕ Во eas .ВЗ; 

В = Rect(10,100,20,200) ; 

К1 = В; 


грози е Pl, .P2; 

Pl = Point(10, 100); 
= Point(10, 200); 
R3-= TRect(P1l, P2); 


9 
м 
| 


erect R2 (Pl, | Pid. 


R.Left = 15; 
int W = R.Width(); 
| 


15.4 Строки и символы 


15.4.1 Функции обработки символов 


Функция | Синтаксис / Описание 


|_tolower | шё _tolower(int ch) 


Макрос приведения латинской буквы к нижнему регист- 
ру (без проверки) 
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| 


| 
| 


Функция |Синтаксис / Описание 


_toupper |int _toupper(int ch) 


Макрос приведения латинской буквы к верхнему регист- 
ру (без проверки) 


int isalnum(int с) | 

| Макрос проверки на латинскую букву или цифру 
| isalpha int isalpha(int c) 

Макрос проверки Ha латинскую букву 


int isascii(int с) 


|ctype.h 
Макрос проверки на символ из набора ASCII 


int iscntrl(int с) 
| Макрос проверки Ha управляющий символ 

isdigit | int isdigit(int c) : 
| Макрос проверки на цифру 


| isgraph int isgraph(int c) ctype.h 
| Макрос проверки Ha печатный символ (исключая пробел) 


ctype.h 


int islower(int c) 
Макрос проверки 


на латинскую букву в нижнем регистре 
} 


int isprint(int с) 


Макрос проверки Ha печатный символ (включая пробел) 


int ispunct(int с) 


Макрос проверки на символ пунктуации (любой печатае- 
мый, кроме латинской буквы, цифры, пробела) 


|155 расе int isspace(int с) 


Макрос проверки на пробельный символ (пробел, табуля- 
ция, новая строка) 


isupper int isupper(int c) 


Макрос проверки Ha латинскую букву в верхнем регистре 


iswalnum |int iswalnum(wint_t ©) 


Макрос проверки Ha латинскую букву или цифру 


iswalpha /|int iswalpha(wint_t с) 


Макрос проверки на латинскую букву 


iswascii j/|int iswascii(wint_t с) 


Макрос проверки на символ из набора ASCII 


int iswentrl(wint_t с) ctype.h 
Макрос проверки на управляющий символ | 


liswdigit | ше iswdigit(wint_tc) . ctype.h 
| Макрос проверки на цифру 


iswgraph |int iswgraph(wint_t с) ctype.h 


Макрос проверки Ha печатный символ (исключая пробел) 


be 
Py 
5 
& 
| 
|) 
== 
Vl 


] 


| 
| 


ункция | Cuntraxcuc / Описание 


}iswlower |1 iswlower(wint_t с) ctype.h 


Макрос проверки Ha латинскую букву в нижнем регистре 


int iswprint(wint_t c) ctype.h 


р i 
wv 


Макрос проверки на печатный символ (включая пробел) 


int iswpunct(wint_t с) ctype.h 


Макрос проверки на символ пунктуации (любой печатае- 
мый, кроме латинской буквы, цифры, пробела) 


iswspace ctype.h 


int iswspace(wint_t c) 


| Макрос проверки на пробельный символ (пробел, табуля- 
ция, новая строка) 


|iswupper |int iswupper(wint_t с) ctype.h 
Макрос проверки Ha латинскую букву в верхнем регистре 

| Макрос проверки на шестнадцатеричную цифру 

| isxdigit int isxdigit(int c) ctype.h 
| Макрос проверки Ha шестнадцатеричную цифру 


| toascii int toascii(int с) ctype.h 


Макрос преобразования целого в код ASCII (очистка всех 
битов, кроме 7 младших) — в число от 0 до 127) 


tolower int tolower(int ch) ctype.h 


Макрос приведения латинской буквы к нижнему регист- 
ру, если она в верхнем регистре 


| toupper int toupper(int ch) ctype.h 


Макрос приведения латинской буквы к верхнему регист- 
ру, если она в нижнем регистре 


int towlower(wint_t ch) 


ctype.h 


Макрос приведения латинской буквы к нижнему регист- 
ру, если она в верхнем регистре 


towupper 


int towupper(wint_t ch) 


ctype.h 


Макрос приведения латинской буквы к верхнему регист- 
ру, если она в нижнем регистре 


Комментарии 

Обратите внимание на то, что макросы, распознающие и преобразовывающие 
буквы, не работают с символами кириллицы. Для кириллицы надо использовать 
работающие с кйриллицей функции строк (см. разделы 15.4.2.2 и 15.4.2.3): пере- 
вести символ в строку, преобразовать строку и взять ее первый символ. Например, 
оператор 


Key = Ап510ррегСазе (Key) [1]; 


приведет символ Key типа char к верхнему регистру. 
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15.4.2 Функции обработки строк 


15.4.2.1 Функции работы с областями памяти и строками 


[Функция | Синтаксис /Ommcamme 


| пешссру /| void *memccpy(void *dest, const void *src, int с, size_t п) |mem.h 
| void *memchr(const void *s, int с, size_t п) 

| Возвращает указатель Ha первое вхождение символа с в 

| первых п байтах $; если символ не найден, возвращает 

| NULL | 


Копирует символы из src в dest, пока не встретится сим- 
вол C или не будет скопировано п символов; возвращает 
dest 


int memcmp(const void *$1, const void *s2, size_t п) 
Сравнивает п символов из S1 и $2; результат < 0 при 


sl < $2, = 0 при sl = $2, > 0 при sl > $2 


memcpy void *memcpy(void *dest, const void *src, size_t п) 
| Копирует п байтов из sre в dest; src и dest He должны пе- 


рекрываться в памяти (см. Memmove); возвращает dest 


memicmp |int memicmp(const void *$1, const void *s2, size_t п) 
Сравнивает, игнорируя регистр (не кириллицу), п CHMBO- 
лов из S1 и $2; результат < 0 при sl < $2, = 0 при 
sl = $2, > 0 при $1 > s2 
: ры 


emmove | void *memmove(void *dest, const void *src, size_t п) 


Копирует п байтов из src в dest; src и dest могут пере- 


крываться в памяти (см. Memcpy); возвращает dest 


void setmem(void *dest, unsigned length, char value) 


void *memset(void *s, int c, size_t n) 
Заполняет п байтов блока $ символом с; возвращает $ 


Заполняет блок dest размером length байтом value 


Комментарии 

Приведенные в данном разделе функции могут работать как со строками с ну- 
левым символом в конце, так и со строками без нулевого символа, а также с блока- 
ми памяти, не являющимися строками. 


15.4.2.2 Функции обработки строк с нулевым символом в конце 


Функция ___ Синтаксис / бане [Фа | 


AnsiStrComp |шё AnsiStrComp(char * 51, char * $52) SysUtils.hpp | 


Сравнивает строки Slu 532 с учетом регистра; | 
результат < 0 при S1l< 52, = 0 при S1= 52, | 
> 0 при $1> $2 | 
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| | AnsiStriComp int AnsiStrIComp(char * S1, char * 52) SysUtils.hpp 
| 


Сравнивает строки Slu 52 без учета регистра; 
| Yonago 


результат < 0 при S1< 52, = 0 при $1= 52, 
> 0 при 51> 52 


int AnsiStrLComp(char * $1, char * 52, Cardinal | SysUtils. ns 


MaxLen) 
SysUtils.hpp 


Сравнивает до MaxLen символов строк З1и 52; 
SysUtils.hpp 


результат < 0 при S1< 52, = 0 при S1= S2, 
> 0 при S1> 52 


int AnsiStrLIComp(char * 51, char * 52, Cardi- 
nal MaxLen) 


Сравнивает до MaxLen символов строк Slu S2 
без учета регистра; результат < 0 при $1< 52, 
= 0 при S1= 52, > 0 при 51> 52 


char * AnsiStrLower(char * Str) 


Возвращает строку, все символы которой приве- 
дены к нижнему регистру 


| AnsiStrPos char * AnsiStrPos(char * Str, char * SubStr) SysUtils.hpp 

| Возвращает первое вхождение подстроки SubStr 
в Str или NULL 

[AnsiStrRScan char * AnsiStrRScan(char * Str, char Chr) SysUtils.hpp 
Возвращает указатель Ha последнее вхождение 
символа Chr в Str или NULL 

| инь char * AnsiStrScan(char * Str, char Chr) SysUtils.hpp 

| Возвращает указатель Ha первое вхождение сим- 

| вола Chr в Str или NULL 

| AnsiStrUpper {char * AnsiStrUpper(char * Str) SysUtils.hpp | 

| Возвращает строку, все символы которой приве- | 
дены к верхнему регистру | 


| CompareStr int CompareStr(const System::AnsiString 51, SysUtils.hpp | 
| const System::AnsiString S2) | 
| Сравнивает строки Slu $2 с учетом регистра; | 
| результат < 0 при S1< 52, = 0 при $1= 52, | 
| > 0 при S1> 52 | 
[CompareText int CompareText(const System::AnsiString S1, SysUtils.hpp | 
const System::AnsiString S2) | 

Сравнивает строки Slu 52 без учета регистра; | 

| результат < 0 при $1< $2, = 0 при $1= $2, | 
> 0 при S1> 52 | 


| LineStart char * LineStart(char * Buffer, char * BufPos) SysUtils.hpp | 
| | 

Возвращает указатель на начало последней стро- | 

ки в Buffer, кончающейся в позиции BufPos | 
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вы ик 


Динамически выделят блок памяти под строку 
длиной Size - 1 и возвращает указатель на него; 
блок должен освобождаться функцией StrDispose 


StrAlloc char * StrAlloc(Cardinal Size) SysUtils.hpp 


Cardinal StrBufSize(char * Str) SysUtils.hpp 


Возвращает максимальное число символов, KOTO- 
рые могут разместиться в созданной функцией 
StrAlloc строке Str 


char *strcat(char *dest, const char *src) string.h 
Добавляет строку src в конец строки dest; воз- 
вращает указатель на результирующую строку 

| StrCat char * StrCat(char * Dest, char * Source) SysUtils. 

| Добавляет строку Source в конец строки Dest; hpp 

| возвращает указатель на результирующую строку 

| char *strchr(const char * s, int c) string.h 

| Возвращает указатель Ha первое вхождение с в 

| $, или NULL 

| strcmp int stremp(const char *sl, const char *s2) string.h 
| .| Сравнивает строки $1 и $2; результат < 0 при 

| 51 < $2, = 0 при $1 = $2, > 0 при $1 > $2 


int strempi(const char *$1, const char *s2) 


To же, что stricmp: сравнивает строки $1 и $2 без 
учета регистра (не кириллицу); результат < 0 при 
sl < $2, = 0 при sl = $2, > 0 при $1 > $2 


int StrComp(char * Strl, char * Str2) 


Сравнивает строки Slu $2 с учетом регистра 
(для кириллицы лучше использовать AnsiStr- 
Сотр); результат < 0 при $1< 52, = 0 при 
S1= 52, > 0 при S1> $2 


char * StrCopy(char * Dest, char * Source) | SysUtils.hpp 
Копирует Source в Dest и возвращает Dest 

| strepy char *strepy(char *dest, const char *src) 

em oc Копирует строку src в dest; возвращает dest 

size_t strcspn(const char *s1, const char *s2) 


SysUtils.hpp 


Возвращает длину начальной части строки $1, 
не содержащей ни одного из символов строки $2 


char *strdup(const char *5) 


Выделяет соответствующую область в памяти и 
копирует в нее строку $; возвращает указатель 
на эту область 


char * StrECopy(char * Dest, char * Source) 


Копирует Source в Dest и возвращает указатель 
на конечный нулевой символ Dest 
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char * StrEnd(char * Str) SysUtils.hpp 
| Возвращает указатель на конечный нулевой 
| символ Str 
char *strerror(int errnum) 
| Возвращает указатель Ha строку сообщения 06 
| ошибке с номером errnum 


int stricmp(const char *$1, const char *s2) string.h 
То же, что strempi: сравнивает строки $1 и $2 без 

учета регистра (не кириллицу); результат < 0 при 

sl < $2, = 0 при sl = $2, > 0 при $1 > $2 


StrIComp int StrIComp(char * Strl1, char * Str2) SysUtils.hpp 
| Сравнивает строки Slu S2 без учета регистра. 
| (для кириллицы надо использовать AnsiStrI- 
Comp); результат < 0 при $1< 52, = 0 при 
| $1= 52, > 0 при 51> 52 | 


| StrLCat char * StrLCat(char * Dest, char * Source, SysUtils.hpp 
| | Cardinal MaxLen) 

‚ | Копирует до MaxLen символов строки Source в 
| конец строки Dest и возвращает Dest 


| StrLComp int StrLComp(char * Strl, char * Str2, SysUtils.hpp 
| Cardinal MaxLen) 
| Сравнивает до MaxLen символов строк Slu $2 с 
| учетом регистра (для кириллицы лучше исполь- 
зовать AnsiStrLComp); результат < 0 при 
| 51< S2, = 0 при S1= 52, > 0 при S1> 52 


| StrLCopy char * StrLCopy(char * Dest, char * Source, SysUtils.hpp 
| Cardinal MaxLen) 
| Копирует до MaxLen символов Source в Dest и 
| возвращает указатель на Dest 
зовать AnsiStrLIComp); результат < 0 при 


size_t strlen(const char *s) string.h 

| StrLIComp 

| $1< S2, = 0 при S1= 52, > 0 при $51> 52 

| StrLower char * StrLower(char * Str) SysUtils.hpp 
Возвращает строку, все символы которой приве- 

| дены к нижнему регистру (для кириллицы надо |. 

| | использовать AnsiStrLower) | 


Возвращает число символов в $5, не считая нуле- 
вого символа в конце 


Cardinal StrLen(char * Str) SysUtils.hpp 


Возвращает число символов в Str, не считая Hy- 
левого символа в конце 


int StrLIComp(char * Strl1, char * Str2, 
Cardinal MaxLen) 


Сравнивает до MaxLen символов строк Slu 52 
без учета регистра (для кириллицы надо исполь- 


SysUtils.hpp 


wo 
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[Функция (Синтаксис / Опиаше с 


ан char *strlwr(char *s) 


Преобразует строку $ в нижний регистр (только 
латинские буквы) 


= Le) 


SysUtils.hpp 


StrMove char * StrMove(char * Dest, char * Source, 
Cardinal Count) , 
Копирует Count символов из Source в Dest и 
| возвращает Dest; Source и Dest могут перекры- 
ваться в памяти 


char *strncat(char *dest, const char *src, 
size_t maxlen) 


Копирует до maxlen символов строки src в KO- 
Hell строки dest и добавляет нулевой символ; 
возвращает dest 


ее int strncmp(const char *sl, const char *s2, 


size_t maxlen) 
Сравнивает до maxlen символов строк $1 и 52; 
результат < 0 при $1 < $2, = 0 при $1 = $2, 
> 0 при $1 > $2 


int strncmpi(const char *sl, const char *s2, 
size_t n) 


То же, что strnicmp: сравнивает до maxlen cum- 
волов строк $1 и $2 без учета регистра (не ки- 
риллицу); результат < 0 при $1 < $2, = 0 при 
sl = $2, > 0 при $1 > $2 


| strncpy char *strncpy(char *dest, const char *src, 
| size_t maxlen) 


Копирует до maxlen символов из src в dest; воз- 
вращает dest 


char * StrNew(char * Str) 


StrNew 
Динамически размещает в памяти копию Str и 
| возвращает указатель на нее 
| int strnicmp(const char #51, const char *s2, 
7 size_t maxlen) 
| То же, что strncmpi: сравнивает до maxlen сим- 
волов строк $1 и $2 без учета регистра (не ки- 
риллицу); результат < 0 при $1 < $2, = 0 при 
sl = $2, > 0 при sl > $2 


SysUtils.hpp 


char *strnset(char *s, int ch, size_t n) string.h 
Копирует символ ch в первые п символов $ 


char *strpbrk(const char *$1, const char *s2) 


Возвращает первое вхождение в $1 любого из 
символов строки $2 или NULL 


StrPCopy char * StrPCopy(char * Dest, 
const System::AnsiString Source) 
| Копирует Source в Dest и возвращает Dest 


SysUtils.hpp 


е | 
> | 
we | 
я | 
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| StsPLCopy char * StrPLCopy(char * Dest, SysUtils. hpp | 
const System::AnsiString Source, | 
| Cardinal MaxLen) | 
Копирует до MaxLen символов из Source в Dest | 
| и возвращает Dest 
| char * StrPos(char * Str1, char * Str2) | SysUtils.hpp | 
| Возвращает первое вхождение подстроки Str2 в | 
| Str1 или NULL | 
| char *strrchr(const char *s, int c) string.h | 
| Возвращает последнее вхождение символа с в $ | 
или NULL | 
| strrev char *strrev(char *s) string.h | 
| Инвертирует (переворачивает) строку $ кроме | 
| нулевого символа | 
char * StrRScan(char * Str, char Chr) SysUtils.hpp | 
| Возвращает последнее вхождение символа Chr в | 
| Str или NULL | 
| char * StrScan(char * Str, char Chr) SysUtils.hpp | 
| Возвращает первое вхождение символа Chr в Str | 
| или NULL | 
| char *strset(char *s, int ch); string.h | 
| Заполняет всю строку $ до нулевого символа | 
| символом ch | 


size_t strspn(const char *$1, const char *s2) 


Возвращает число первых символов строки sl, 
входящих в множество символов строки $2 
(последовательность символов безразлична) 


char *strstr(const char *sl, const char *s2) | 
Возвращает первое вхождение подстроки $2 в | 
| строку $1 или NULL | 
| strtok char *strtok(char *s1, const char *s2) 

| Ищет первое вхождение разделителей из строки 

| 52 в строке $1 и усекает строку $1; возможны 

| повторные вызовы 

| StrUpper char * StrUpper(char * Str) SysUtils.hpp 

| i | Возвращает строку, все символы которой приве- 

| дены к верхнему регистру (для кириллицы надо 

| использовать AnsiStrUpper); 


| char *strupr(char *s) | 
| Преобразует строку $ в верхний регистр (только | 
| латинские буквы) | 
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Комментарии 

Функции файла string.h, распознающие регистр символов (strempi, stricmp, 
гг, strncmpi, strnicmp, strupr), не позволяют оперировать с символами кирил- 
лицы, записанными в разных регистрах. Для подобной работы с русскими текста- 
ми надо использовать аналогичные функции файла SysUtils.hpp. Функции этого 
файла могут работать с текстами на русском языке и с многобайтными символами. 

Операции, выполняемые большинством функций, вероятно, понятны из пояс- 
нений в таблице. Поэтому остановимся только на некоторых из них. 

Функции strcat прибавляет к тексту строки, указанной ее первым парамет- 
ром, текст строки, указанной вторым параметром. Она возвращает указатель на 
строку, заданную ее первым параметром и содержащую суммарный текст обеих 
строк. Это позволяет делать вложенные вызовы Strcat, если надо склеить несколь- 
ко текстов.Функция Strcpy копирует строку, являющуюся ее вторым параметром, 
в строку, являющуюся первым параметром и возвращает указатель на результат 
копирования. Функция strstr позволяет искать в строке некоторую заданную по- 
следовательность символов. Многочисленнные примеры применения функций 
streat, зёгеру, strstr и strlen вы можете посмотреть в главе 13 в разделе 13.4.1. 

Теперь рассмотрим функцию strtok, которая работает следующим образом. 
При своем первом вызове для данной строки $1 функция ищет первое появление в 
строке одного из символов, содержащихся в строке $2. Если такой символ найден, 
то он заменяется на нулевой символ, т.е. строка $1 усекается на этом символе. 
Функция возвращает указатель на первый символ усеченной строки $1. Далее 
можно повторно вызывать функцию strtok, задавая ей в качестве первого парамет- 
ра NULL. Функция продолжит обработку той же строки $1 (строку $2 при этом 
можно сменить), найдет вхождение следующего символа из $2, опять заменит его 
нулевым символом и вернет указатель на начало нового просмотренного фрагмен- 
та строки. Таким образом, получается чтение строки по фрагментам. Приведем 
пример. Операторы 


char 8180], 


Dp =, SUrton РР 4 
if (р) Memol->Lines->Add (р); 
while (p) 
{ 

р = strtok(NULG; т.) 

if (р) Memol->Lines->Add (р); 
} 


осуществляют поиск в строке $ символов — разделителей: пробела, запятой, 
точки. Обработанные фрагменты строки заносятся в строки окна Memol. Напри- 
мер, если в $ занесен текст «Это текст строки, которая анализируется.», то приве- 
денный код выдаст в окно Memol строки: 

Это 

текст 

строки 


которая 
анализируется 


Если же мы уберем из второго параметра функции strtok символ пробела, то 
результатом будет: 


Это текст строки 
которая анализируется 


Функция LineStart производит поиск в буфере Buffer назад от позиции 
BufPos символа конца строки «\n». Если символ найден, то функция возвращает 
указатель на него, выделяя таким образом последнюю строку. Обратившись к 
функции повторно и задав в качестве BufPos значение, на 1 меньшее возвращенно- 
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го, можно найти предпоследнюю строку и т.п. Если символ «\п» не найден, то 
функция возвращает указатель на начало ВиЁег. Например, код 


char *Buf = "Это первая строка\пЭто вторая\пЭто третья", 
*P = StrEnd (Buf); 


do 
{ 
P=LineStart (Buf, P-1); 
} while(P != Buf); 
переберет по очереди, начиная с конца, все строки буфера Buf. 


15.4.2.3 Функции обработки строк типа AnsiString 


Функция ___ | Синтаксис /Ommeamme | ait 


| AdjustLine- | System::AnsiString AdjustLineBreaks( 
Breaks - const System::AnsiString S) 


Заменяет в $ символы конца строки на CR/LF — 
стандартные для Unix 


| AnsiCompa- 
| ге5 т 


int AnsiCompareStr(const System::AnsiString 51, 
const System::AnsiString S2) 


Сравнивает строки Slu 52 с учетом регистра; pe- 
зультат < 0 при S1< 52, = 0 при S1= $2, > 0 при 
$1> $2 


int AnsiCompareText(const 


SysUtils.hpp | 


| 
| 


SysUtils.hpp 


| AnsiCompa- 
reText System::AnsiString S1, 


const System::AnsiString S2) 


Сравнивает строки Slu S2 без учета регистра; pe- 
зультат < 0 при 51< 532, = 0 при S1= 52, > 0 при 
$1> $2. 


System::AnsiString AnsiExtractQuotedStr( 
char * &Src, char Quote) 


Возвращает строку Sre с удаленными из ее начала 
и конца символами кавычек, заданными как Quo- 
фе, и с заменой внутри двойных кавычек на оди- 

нарные 


AnsiExtract- 
QuotedStr 


SysUtils.hpp 


System::AnsiString AnsiLowerCase( 
const System::AnsiString S) 


Возвращает строку S, приведенную к нижнему pe- 
гистру (работает с кириллицей) 


| AnsiLower- 
| Case 


SysUtils.hpp 


| AnsiPos int AnsiPos(c3onst System::AnsiString Substr, SysUtils.hpp 
| const System::AnsiString 5) 

Возвращает позицию начала подстроки Substr в 5 
| или 0 
_ AnsiQuo- System::AnsiString AnsiQuotedStr( SysUtils.hpp 
| tedStr const System::AnsiString S, char Quote) 


Возвращает строку S со вставленными в ее начало 

и конец символами кавычек, заданными как Quo- 

| te, и с заменой внутри строки одинарных кавычек 
на двойные 


| 
| 
| 
| 
| 
| 
| 
| 
АЖ = 
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| Функция Синтаксис / Описание Файл 


AnsiUpper- | System::AnsiString AnsiUpperCase( SysUtils.hpp 
Case const System::AnsiString S) 


| Возвращает строку S, приведенную к верхнему ре- 
| гистру (работает с кириллицей) 


‘IsDelimiter | bool IsDelimiter( SysUtils.hpp 
| | const System::AnsiString Delimiters, 

| const System::AnsiString $, int Index) 

| Определяет, является ли символ с индексом Index 

| в строке S одним из разделителей, указанных в 

| строке Delimiters | 


bool IsPathDelimiter(const System::AnsiString 5, | SysUtils.hpp 
int Index); 


Определяет, является ли символ с индексом Index 
в строке $ обратным слешем '\', используемым 
для задания путей к файлам 


|LastDelimi- |int LastDelimiter( SysUtils.hpp 
| ter const System::AnsiString Delimiters, 
| const System::AnsiString 5) 


Возвращает индекс последнего вхождения в стро- 
ку S одного из разделителей, указанных в строке 
Delimiters 


System::AnsiString LowerCase( 
const System::AnsiString S) 


: LowerCase SysUtils.hpp 


| 


Возвращает строку $, приведенную к нижнему pe- 
гистру (для кириллицы используйте AnsiLowerCa- 
5е) 


| 

| QuotedStr System::AnsiString QuotedStr( SysUtils.hpp 
| const System::AnsiString S) 

| Возвращает строку $ co вставленными в ее начало 

| и конец символами одинарных кавычек и с заме- 

| ной внутри строки одинарных кавычек на двой- 

| ные (для многобайтных символов используйте Ап- 

| 


| 


siQuotedStr) 


| String- System::AnsiString StringReplace( | SysUtils.hpp 
| Верасе const System::AnsiString 5, 
const System::AnsiString OldPattern, 
const System::AnsiString NewPattern, 


TReplaceFlags Flags) 


Возвращает строку $ с заменой подстроки OldPat- 
tern на NewPattern; Flags управляет заменами 
подстрок | 


| Trim System::AnsiString Trim( SysUtils.hpp 

| const System::AnsiString S) 

| Возвращает строку $ с удаленными начальными и 

| конечными пробельными и управляющими симво- 
| лами 
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‘TrimLeft System::AnsiString TrimLeft( 
| const System::AnsiString S) 
| Возвращает строку S с удаленными начальными 
| пробельными и управляющими символами 
емо System::AnsiString TrimRight( 

. const System::AnsiString 5) 
| Возвращает строку $ с удаленными конечными 
| пробельными и управляющими символами 


Е ака ОррегСазе( 


const System::AnsiString 5) 


| Возвращает строку $, приведенную к верхнему pe- 
| гистру (для кириллицы используйте AnsiUpperCa- 
| 5е) 


WrapText System::AnsiString WrapText( 
const System::AnsiString Line, 
const System::AnsiString BreakStr, 
const TSysCharSet &BreakChars, 
int MaxCol) 

Возвращает текст Line, разбитый Ha строки дли- 
ной до MaxCol вставкой символов BreakStr и за- 
меной на них символов множества BreakChars 


Комментарии 

Помимо функций, содержащихся в данной таблице, посмотрите в главе 16 
описание класса AnsiString. В нем вы найдете много удобных методов работы со 
строками типа AnsiString. 

Все функции, оперирующие со строками типа AnsiString, учитывают локали- 
зацию и поэтому могут с равным успехом работать как для латинских букв, так и 
для кириллицы. В этом их большое преимущество перед многими функциями, ра- 
ботающими со строками типа Char *. 

Несколько замечаний о приведенных в таблице функциях. В функциях 
IsDelimiter и IsPathDelimiter индексы отсчитываются от 1 (вопреки утверждени- 
ям встроенной справки C++Builder). Соответственно 1 — это первый символ стро- 
ки, 2 — второй ит.д. 

Функция IsDelimiter удобна для просмотра всех символов строки и замены 
каких-то одних символов на другие. Например, код 


AnsiString $, Delimiters; 


Delimiters = "'"; 
a. i409 
for(int i'= 1é.3..<= StrLen(S.c str ());:. 14+) 
if (IsDelimiter (Delimiters,S,i)) 
${i} = и 


заменит в строке S все символы одинарных кавычек на двойные кавычки. 

В этой функции в строке Delimiters не обязательно должны быть именно раз- 
делители. В нее могут быть занесены любые символы. Например, если приведен- 
ный код изменить следующим образом: 

AnsiString $, Delimiters; 

Delimiters = "123456789"; 

~ re 

for(int 1 = 1; .4.<='StrLen(S.ic str()); i++) 


Функции С, С++, библиотек C++Builder, АР! Windows | 925 


if (IsDelimiter (Delimiters,S,i) ) 
$[1] -= 1; 
то все символы цифр в строке, кроме 0, будут уменьшены Ha 1. 

Функция StringReplace возвращает строку $ с заменой подстроки OldPattern 
на NewPattern. Если параметр Flags не включает флаг rfReplaceAll, то функция 
заменят только первое вхождение подстроки OldPattern. Если параметр Flags 
включает флаг rflgnoreCase, то операции выполняются без учета регистра. Напри- 
мер, оператор 


$1 = StringReplace(S, OldPattern, NewPattern, 
TReplaceFlags ()<<rfReplaceAll); 


поместит в строку S1 текст строки $ с заменой в ней всех подстрок OldPattern на 
NewPattern. 

Функция WrapText разбивает заданный текст Line на строки. В качестве сим- 
волов конца строки используются символы, заданные параметром BreakStr. Пара- 
метр MaxCol задает максимальное количество символов в строке. Разбиение на 
строки производится вставкой BreakStr после одного из символов, имеющихся в 
множестве BreakChars. Вставка производится после того из символов в текущей 
строке, который обеспечивает ее максимальную длину в пределах MaxCol. Если ни 
одного символа из BreakChars не встретилось, длина строки может превысить 
MaxCol. Например, операторы 


TSysCharSet bchars; 


bchars << ' ' «« ты << oe << ce << +! << tet 
AnsiString S, 51; 
ma * smae 


S1 = WrapText(S, "\n\r", bchars, 10); 


обеспечивают запись в S1 текста S, разбитого Ha строки длиной до 10 символов, 
причем разбиение проводится после пробелов и знаков пунктуации. Если в $ запи- 
сать текст: «Этот тест показывает разбиение на строки, в частности — на символах 
+ и —», то результат будет следующим: 

"Этот тест " 

"показывает " 

"разбиение " 

"на строки, " 

" B п 

"частности " 

и catia 

"символах +" 

" и -." 

Можно заметить, что вторая строка содержит 11 символов, включая пробел, 
т.е. ее размер больше заданного. 

Конечно, в этом примере указана очень маленькая длина строки и поэтому 
разбиение выглядит не красиво. При нормальной для печати длине строк разбие- 
ние получается лучше. 


15.5 Потоки и файлы 


15.5.1 Атрибуты и флаги файлов, стандартные файлы 


Файлы могут иметь следующие атрибуты, определенные в dos.h: 


CPE LORS поки REO LILES. BALAI AR PLE LER IES REA NRA D LEA NIE AEE ES GE LEE DEA SV LEIS RARER ESOLEED Е а о о оке 


irae SS See SEG PR МАУ 2 it 
FA_HIDDEN : невидимый 
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FA_SYSTEM | системный 


FA_LABEL ‚ метка тома 
FA_DIREC каталог 
FA_ARCH архивный 


Еще один AERC PRAT IRB набор констант атрибутов приведен в разде- 
ле 15.5.6. 

Атрибуты объединяются в одно слово операцией ИЛИ (|). 

При открытии файла доступ к нему определяется следующими флагами (опре- 
делены в файле fentl.h): 


оное АЛАНИИ ИИ ЛИ 


‘O_RDONLY | ie файл OTDEIT только для чтения 


О SN EE EISELE NR а а Бо анны 


O_WRONLY файл отрыт только для записи 


O_RDWR файл отрыт для чтения и записи 

О_ CREAT создание нового файла \ 
O_TRUNC если файл существует, OH урезается до 0 

O BINARY двоичный файл 

O_TEXT текстовый файл 


O_NOINHERIT файл не передается в дочерний процесс 
O_NDELAY не используется, введен для совместимости с UNIX 


О_АРРЕМО файл отрыт для добавления в конец, при каждой операции вы- 
вода указатель файла автоматически устанавливается на конец 


О_ СКЕА если файл существует, то этот флаг не действует, если файл 
создается, то его флаги доступа задаются специальным пара- 
метром mode, принимающим значения, указанные в приведен- 
ной ниже таблице 


O_EXCL используется только вместе с O CREA и означает, что, если 
файл уже существует, возвращается ошибка 


Файлы могут открываться в следующих режимах mode (определены в файле 
sys\stat.h): 


POORER ELLER ДИ АИК BEIGE EES SELL LL EBE EERE ЕСА 


i REP EOS LEE ES LEE LIE IE COLL LALIT, 


$ _IWRITE / : разрешение записи 
S_IREAD разрешение чтения 
$ 1ВЕАШ | S_IWRITE разрешение записи и чтения 


Файлы могут иметь следующие флаги совместного доступа нескольких прило- 
жений (определены в файле share.h): 


ны 


SH_COMPAT Установка режима совместного доступа. Объединяется с дру- 
гими флагами (например, SH_COMPAT | SH_DENWR). Про- 
исходит ошибка, если файл уже открыт с другим режимом 
доступа 
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SH_DENWR Запрещает запись, разрешает повторное открытие файла TO- 
лько для чтения 


SH_DENYNO Разрешает доступ для чтения и записи (оставлен наряду с 
SH_DENYNONE для обратной совместимости) 


SH_DENYNONE Разрешает доступ для чтения и записи. Разрешает повторное 
открытие файла, но только с тем же 5Н_СОМРАТ 


SH_DENYRD Запрещает чтение, разрешгает повторное открытие файла TO- 
лько для записи | 


SH_DENYRW Доступ к файлу обеспечивает только текущий дескриптор 


Флаги могут соединяться в одно слово операцией ИЛИ (|). Из флагов 
SH_DENYRD, SH_DENYNO может быть задан только 1. 

Имеется и другой набор констант режимов, в которых могут быть открыты 
файлы и которые определяют доступ к файлам других приложений (файл 
SysUtils.hpp): : 


1 
a = ——— 


hepa: нь В ара пн head 


[пОрепкеаа [$0000 [открыть только дя ления 
fmOpenWrite [$0001 |открыть только для samme 
fmOpenReadWrite 
|fmShareCompat 


| 

| fmShareExclusive $0010. запрет другим приложениям читать и записы- 

| вать в файл | 

| fmShareDenyWrite | $0020 запрет другим приложениям записывать в 
файл 

| 


fmShareDenyRead |5$0030 запрет другим приложениям читать из файла 
| fmShareDenyNone 0040 полный доступ к файлу других приложений | 


В языках С и C++ файл рассматривается Kak поток (stream), представляющий 
собой последовательность считываемых или записываемых байтов. | 

В C++Builder могут использоваться два подхода к работе с файлами. Первый 
заключается в том, что информация о потоке (файле) заносится в структуру типа 
FILE, определенную в файле stdio.h, и файл оказывается связанным с этой струк- 
турой. Второй подход связывает файл с дескриптором (handle) — целым значени- 
ем, характеризующим размещение информации о файле во внутренних таблицах 
системы. | | 

В начале работы любой программы автоматически открывается три потока со 
своими дескрипторами: 


стандартный входной поток — обычно клавиатура | 

| 
стандартный выходной поток — обычно экран | 
стандартный поток сообщений об ошибках | 


stderr 
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В чистом виде эти потоки используются только в консольных приложениях. 
Но с помощью некоторых функций, описанных в последующих разделах, они мо- 
гут быть перенаправлены в файлы и использоваться в этом случае в приложения 
-Windows. ! 


15.5.2 Управление потоками и файлами, описываемыми 
структурами FILE 


Управление файлами при подходе, описываемом структурами FILE, осущест- 
вляется следующими функциями. 


———————————ж———„„„—А„А——.—’/,/—/,——/— и 


FILE *_fdopen(int handle, char * mode) 


Связывает файл с дескриптором handle, открываемый в | 
режиме mode, с потоком и возвращает указатель Ha свя- | 
зываемую с потоком структуру типа FILE или NULL 


int fileno(FILE *stream) 
Возвращает дескриптор потока stream 


| 

| 

| _flushall |int _flushall(void) stdio.h 
| Очищает буферы всех входных и выходных потоков, за- 

| писывая в выходные потоки содержимое их буферов; воз- 

| 


вращает число открытых и закрытых потоков 


| FILE *_fsopen(const char *filename, const char *mode, stdio.h, 

| int shflag) share.h 
| Открывает файл filename совместного доступа, определя- 

| emoro параметрами shflag и mode; возвращает указатель 


на связываемую с ним структуру типа FILE или NULL 


| fclose int fclose(FILE *stream) stdio.h 
| Закрывает поток stream | 
fflush | int fflush(FILE *stream) stdio.h 


Очищает буфер выходного потока stream, сбрасывая ero 
содержимое в поток; возвращает 0 при успешном завер- 
шении и EOF при ошибке 


FILE *fopen(const char *filename, const char *mode) 


Открывает файл с именем filename в режиме mode и воз- 
вращает указатель на связываемую с ним структуру типа 
FILE или NULL 


| 
| 
| 
| 
| 
| 
lon FILE *freopen(const char *filename, const char *mode, 
| 


FILE *stream) 


Связывает с открытым потоком stream файл с именем fi- 
lename в режиме mode и возвращает указатель на связы- 
ваемую с ним структуру Tuna FILE или NULL 


void setbuf(FILE *stream, char *buf) 


Задает буфер buf для потока stream вместо буфера по 
умолчанию 
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Функция | Синтаксис / Описание 


isetvbuf int setvbuf(FILE *stream, char “buf, int type, size_t size) | stdio.h 


Задает буфер buf размера size для потока stream вместо 
буфера по умолчанию 


FILE *tmpfile(void) stdio.h 


Открывает временный двоичный файл для записи и воз- 
вращает указатель на связываемую с ним структуру типа 
FILE или NULL 


Комментарии 

Открывается файл функцией fopen, в которую передается как параметр стро- 
ка с именем файла filename. Аргумент mode указывает на строку, которая опреде- 
ляет режим открытия. Она может содержать спецификаторы: 


О О О а В В ВЗР О ОО аа 


г открыть файл только для чтения 

r+ открыть существующий файл для обновления — чтения и записи 

а открыть или создать файл для записи данных в конец файла 

a+ открыть или создать файл для чтения или записи в конец файла 

w создать файл для записи; если такой файл уже существует, OH будет 
перезаписан 

wt создать файл для обновления — чтения и записи; если такой файл 


уже существует, он будет перезаписан 


К указанным спецификаторам в конце или перед символом «+» может добав- 
ляться символ «t» — текстовый файл, или «b» — бинарный, двоичный файл. Ha- 
пример, rt, rb, r+t, r+b и т.д. Если ни символ «6», ни символ «<b» не указаны, TO 
тип открываемого файла определяется значением глобальной переменной _fmode, 
определенной в файле fentl.h. Она может принимать значения О_ТЕХТ — тексто- 
вый файл (по умолчанию) или O_BINARY — двоичный файл. 

Если открытие файла прошло успешно, функция fopen возвращает указатель 
на связываемую с потоком структуру типа FILE. Если произошла ошибка, то воз- 
вращается NULL. Типичная процедура открытия файла имеет вид: 

FILE *F; 

if ((F = fopen("Test.txt", "rt")) == NULL) 

{ 

ShowMessage ("Файл не удается открыть"); 
return; 


} 


После того, как файл открыт; с ним связывается указатель, определяющий те- 
кущую позицию чтения и записи. При каждой операции чтения и записи этот ука- 
затель автоматически смещается на величину прочитанного или записанного 
поля. Кроме того указатель может смещаться программно с помощью функций 
fseek и rewind, описанных в разделе 15.5.4. Однако, если файл открыт для обнов- 
ления — чтения и записи, то при работе с ним надо учитывать следующее: 


Ш вывод (запись) не может следовать сразу за вводом (чтением) без предварите- 
льной установки указателя явным образом с помощью функций fseek или re- 
wind 

Ш ввод не может следовать сразу за выводом без предварительной установки ука- 
зателя явным образом с помощью функций fseek или rewind — в противном 
случае ввод может неожиданно выдать признак конца файла 


30 зак 322 
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Функция _fsopen открывает файл filename совместного доступа для несколь- 
ких процессов, определяемого параметрами shflag и mode. Флаги совместного дос- 
тупа, из которых может формироваться Shflag, см. в разделе 15.5.1. Параметр 
mode аналогичен такому же параметру функции fopen. При работе с этой функци- 
ей в DOS предварительно должна быть загружена программа SHARE.EXE. 

Функция freopen связывает с открытым потоком stream файл с именем Ше- 
name в режиме mode. Отличие от функции fopen заключается только в том, что 
поток stream уже был ранее открыт. Это позволяет, в частности, переназначить 
стандартный поток. Например, оператор 


FILE *F = freopen("output.txt", "wt", stdout); 


перенаправляет стандартный выходной поток stdout в текстовый файл «out- 
put.txt». Все последующие выводы в поток stdout будут в действительности на- 
правляться в этот файл. 

Функция _fdopen осуществляет связь между файлами, открытыми с дескрип- 
торами (06 этом подходе см. в разделе 15.5.3), и потоками Tuna FILE. Например, 
оператор 


FILE * stream = fdopen(handle, "w"); 


связывает ранее открытый файл с дескриптором handle со структурой потока stre- 
ат. 

Обратное преобразование — получение дескриптора файла, связанного со 
структурой FILE, осуществляет функция _fileno. В приведенном ниже примере 
создается файл «Test.txt» для записи и определяется его дескриптор. 


FILE *stream; 


int handle; 

stream = fopen("Test.txt", "w"); // создание файла 

handle = _ fileno(stream) ; // определение дескриптора 
fclose (stream) ; // закрытие файла 


Открываемые рассмотренными функциями потоки буферизуются, т.е. обмен 
информацией происходит не непосредственно с файлами, а с промежуточными бу- 
ферами, расположенными в оперативной памяти. Информация переписывается из 
буфера в файл только при переполнении буфера, или при закрытии файла, или 
функциями fflush и _flushall. Первая из них действует на буфер указанного вы- 
ходного потока, вторая — на буферы всех входных и выходных потоков. Для вход- 
ного потока функция очищает буфер, а для выходного — немедленно сбрасывает 
все содержимое в поток, после чего буфер очищается. Потоки остаются открытыми 
и буферы готовы к приему новой информации. 

Программа автоматически осуществляет буферизацию всех потоков. Однако, 
этим процессом можно управлять функциями Setbuf и setvbuf. Если в функции 
зе фи? параметр buf задать равным NULL, то буферизация потока производиться 
не будет. Это может замедлить работу с потоком, но зато обеспечит немедленную 
передачу информации без ожидания того, чтобы буфер переполнился. Если же Бай 
указывает на массив символов, то именно этот массив будет использоваться для 
полной буферизации потока stream вместо буфера по умолчанию. Размер буфера 
может достигать значения BUFSIZ, определенного в файле stdio.h. Например: 


char outbuf [BUFSIZ]; 
setbuf (Е, outbuf); 


Фукнция setbuf должна вызываться сразу поле открытия потока или сразу по- 
сле вызова функции fseek (см. раздел 15.5.4), устанавливающей позицию указате- 
ля потока. В противном случае вызов Setbuf может приводить к непредсказуемым 
результатам. | 
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Функция setvbuf предоставляет более богатые возможности по управлению 
процессом буферизации. В этой функции задание параметра buf = NULL приводит 
к выделению в динамически распределяемой памяти с помощью функции malloc 
места для буфера размером size. Этот буфер автоматически освобождает память 
при закрытии соответствующего потока. Размер открываемого буфера ограничен 
сверху константой UINT_MAX, определенной в файле limits.h. 

Параметр type может принимать следующие значения: 


я Уря 


_ТОЕВЕ Полная буферизация файла. Когда буфер ввода пуст, очередная ¢ опе- 
рация ввода пытается заполнить весь буфер. При выводе выдача со- 
держимого в файл производится после того, как буфер заполнится 
до отказа 


а В В EA NEALE В ВЫ 


_IOLBF Буферизация строк. Когда буфер ввода пуст, очередная операция 
ввода пытается, как и в предыдущем случае, заполнить весь буфер. 
Однако при выводе выдача содержимого в файл производится после 
того, как в потоке появляется символ новой строки 


_IONBF — Небуферизованный ввод/вывод. При этом параметры buf и size иг- 
норируются 


При успешном завершении функция setvbuf возвращает 0. 

Файлы, открытые рассмотренными ранее функциями Фореп и freopen, долж- 
ны закрываться функцией fclose. При этом автоматически открытые буферы пото- 
ков освобождают память. Но если буферы назначались явным образом функциями 
setbuf и setvbuf с параметром buf отличным от NULL, то они автоматически не ос- 
вобождают память. 

Функция tmpfile открывает временный двоичный файл для записи в режиме 
(w+b) и возвращает указатель на связываемую с ним структуру типа FILE. При не- 
удаче возвращается NULL. Если после создания временного файла программа He 
изменяет текущий каталог, то при завершении программы временный файл авто- 
матически удаляется с диска. 

Подробное рассмотрение работы с файлами, описываемыми структурами 
FILE, см. в главе 13 в разделе 13.9.2. 


15.5.3 Управление потоками и файлами, связанными 
с дескрипторами 


Управление файлами осуществляется следующими функциями. 


ое aa 


int creat(const char *path, int mode) io.h, 


Создает новый или переписывает существующий sys\stat.h 


файл в режиме mode; возвращает дескриптор или -1 


int _rtl_close(int handle) 
Закрывает поток с дескриптором handle 


int _rtl_creat(const char *path, int attrib) 


Создает новый или переписывает существующий 
файл ра с атрибутами attrib; возвращает дескрип- 
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| 
| 
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[Функция | Синтаксис /Onmeamne о [фи 


int _rtl_open(const char *filename, int oflags) io.h, dos.h 


Открывает существующий файл filename для чтения 
или записи с атрибутами oflags; возвращает деск- 
риптор или -1 


fentl.h, 
sys\stat.h, 
share.h, 
io.h, stdio.h 


int _sopen(char *path, int access, 
int shflag [, int mode]) 


Открывает файл path совместного доступа, определя- 
емого параметрами access, shflag, mode; возвращает 
дескриптор или -1 


int close(int handle) 
Закрывает поток с дескриптором handle 


int creatnew(const char *path, int attrib) 


Аналогична _rtl_ creat, но выдает ошибку, если 
файл существует 


| | 12$ creattemp(char *path, int attrib) 
| Создает временный файл с уникальным именем и ат- 
рибутами attrib в каталоге path 


int dup(int handle) io.h 
Создает и возвращает дубликат дескриптора handle 


| int dup2(int oldhandle, int newhandle) 
| Создает и возвращает дубликат newhandle дескрип- 
| тора oldhandle 


|FileClose | void FileClose(int Handle) SysUtils.hpp 
| Закрывает файл с дескриптором Handle 


int FileCreate(const System::AnsiString FileName) SysUtils.hpp 


Создает файл FileName и возвращает ero дескриптор 
в случае успеха или -1 


int FileOpen(const System::AnsiString FileName, 
int Mode) 


Открывает файл FileName в режиме Mode и возвра- 
щает его дескриптор или -1 


SysUtils.hpp 


| lock 


— 
© 
=“ 


int lock(int handle, long offset, long length) 
Блокирует в файле handle length байтов, начиная с 


позиции offset от чтения или записи другими про- 
цессами 


int locking(int handle, int cmd, long length) io.h, sys\loc- 


Блокирует или разблокирует в файле handle length | *ing-h 


байтов, начиная с текущей позиции для доступа дру- 
гих процессов 


| setmode int setmode(int handle, int amode) 


С помощью параметра amode задает и возвращает 
тип открытого файла с дескриптором handle: 
О_ВТМАКУ — двоичный, О_ТЕХТ — текстовый 


| 
И 
| 
| 
| 
} 
| 
| 
| 
| 
| 
| 
| 
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чт ел, Е 


unsigned umask(unsigned mode) 


Задает маску режима чтения/записи mode, принима- 
емую по умолчанию функциями Open и creat: 
S_IWRITE, S_IREAD или $ 1ВЕАО|$ IWRITE; воз- 


вращает предыдущую маску 
int unlock(int handle, long offset, long length) 


Разблокирует в файле handle length байтов, начиная 
с позиции offset, для чтения или записи другими 
процессами 


Комментарии 

Функция. creat создает новый или переписывает существующий файл в ре- 
жиме mode. Параметр path указывает имя файла или имя с путем к нему. Вид 
файла — текстовый или двоичный, задается глобальной переменной _fmode — 
О_ТЕХТ или O_BINARY. Если файл существует и для него установлен атрибут за- 
писи, то длина файла усекается до 0. Если же файл существует и имеет атрибут 
только для чтения, то функция _Creat выдает ошибку, а файл сохраняется неиз- 
менным. 

Режим, в котором создается файл, определяется параметром mode, который 
может принимать значения, определенные в файле sys\stat.h и указанные в разде- 
ле 15.5.1. 

При успешном завершении возвращается дескриптор созданного файла. При 
ошибке возвращается -1, а значение еггпо (см. раздел 15.1.5.1) может иметь значе- 
ния EACCES, ENOENT, EMFILE. 

В настоящее время функция _creat считается устаревшей и вместо Hee PeKO- 
мендуется использовать _rtl_creat. Она действует подобно функции _creat, но все- 
гда создает двоичный файл и позволяет своим параметром attrib установить опера- 
цией ИЛИ (|) атрибуты: ЕА_ВООМТХ — только для чтения, ЕА_НТООЕМ — неви- 
димый, FA SYSTEM — системный (подробнее об атрибутах см. в разделе 15.5.1). 

Функция creatnew аналогична функции _rtl_creat во всем, кроме того, что 
возвращает -1 в случае, если файл с данным именем уже существует. 

Функция _rtl_open открывает существующий файл filename для чтения или 
записи с атрибутами oflags. Таблица возможных атрибутов приведена в разделе 
15.5.1. При успешном завершении возвращается дескриптор открытого файла и 
его указатель устанавливается на начало файла. При ошибке возвращается -1, а 
значение еггпо (см. раздел 15.1.5.1) может иметь значения EINVACC, EACCES, 
ENOENT, EMFILE. 

Функция _5ореп открывает файл path совместного доступа, определяемого па- 
раметрами access, shflag, mode. Параметр access задает совокупность О_... флагов 
доступа, перечисленных в разделе 15.5.1. Если среди этих флагов задан О_СВЕА, 
то режим открытия файла определяется параметром mode (см. раздел 15.5.1). Па- 
раметр shflag определяет флаги совместного доступа к файлу нескольких прило- 
жений. Значения этих флагов приведены в разделе 15.5.1. При успешном заверше- 
нии функция возвращает дескриптор открытого файла и его указатель устанавли- 
вается на начало файла. При ошибке возвращается -1, а еггпо (см. раздел 15.1.5.1) 
может принимать значения EINVACC, EACCES, ENOENT, EMFILE. 

Функция creattemp создает временный файл с уникальным именем и атрибу- 
тами attrib в каталоге path. Вид файла — текстовый или двоичный, определяется 
значением глобальной переменной _fmode (О_ТЕХТ или O_ BINARY). Параметр 
attrib может равняться нулю или принимать уже рассмотренные значения 
РА_НТООЕМ, FA_RDONLY или FA_SYSTEM (см. раздел 15.5.1). 
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Число файлов одновременно открытых перечисленными функциями, не долж- 
но превышать HANDLE MAX. 

Функции close, _rtl_close и FileClose закрывают файл, открытый ранее функ- 
циями creat, creatnew, creattemp, dup, dup2, open, _rtl_creat, _rtl_open, 
FileOpen. При этом в выходной файл He записывается автоматически признак KOH- 
ца файла Ctrl-Z. Если этот символ требуется, вам надо предварительно записать его 
явным образом. 

При успешном завершении функций они возвращают 0. При ошибке возвра- 
щают значение -1 и задают глобальной переменной еггпо (см. раздел 15.1.5.1) зна- 
чение EBADF. 

Таким образом, стандартная схема работы с файлами, связанными с дескрип- 
торами, следующая: 


int hout = open("output.txt", О CREAT | О МВОМЬУ, $ ТМВТТЕ); 


close (Попе); 
Например, операторы 
int handle; 
if ((handle = open("Test.txt", О CREAT. |. O TEXT) ) ' == -1) 
{ 
ShowMessage("®amn не удается создать"); 
return; 


} 


close (handle) ; 


пытаются создать новый текстовый файл, а в случае неудачи (функция Open BepHy- 
ла -1) отображают сообщение об ошибке. 

Функции FileOpen, FileCreate и FileClose дают альтернативный подход к OT- 
крытию и закрытию файлов, связанных с дескрипторами. Функция FileOpen от- 
крывает файл в режиме Mode, задаваемом константами fmShare (см. раз- 
дел 15.5.1). В дальнейшем с этими файлами можно работать с помощью функций 
FileRead, FileWrite, FileSeek, описанных в разделе 15.5.4. 

При совместном доступе к файлам нескольких приложений помимо установки 
флагов доступа может использоваться блокировка и деблокировка отдельных 06- 
ластей файла с помощью функций lock, unlock, locking. При работе с этими функ- 
циями в DOS предварительно должна быть загружена программа SHARE.EXE. В 
функции locking режим работы определяется параметром cmd: 


О О LR E НОА Е ОЗЕРО ЯКИХ: 


LK _LOCK Блокировать область. сли не удалось, то прежде, чем отказать- 
ся от блокировки, делается новая попытка через 10 секунд 


LK_RLCK То же, что LK_LOCK 


LK_NBLCK Блокировать область. Если не удалось, то происходит отказ OT 
попытки блокировки 


LK_NBRLCK To же, что LK_NBLCK 


LK _UNLCK — Разблокировать ранее заблокированную область файла 


При успешном завершении функции возвращается 0. При неудаче возвраща- 
ется -1, а значение errno (см. раздел 15.1.5.1) может иметь значения EACCES, 
EBADF, EDEADLOCK — невозможность блокировки, несмотря на повторную по- 
пытку через 10 секунд (при cmd равном LK_LOCK или LK _RLCK), EINVAL — 
ошибка в cmd или не загружена программа SHARE.EXE. 
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Функции dup и dup2 позволяют оперировать с дескрипторами файлов. Функ- 
ция dup создает и возвращает дубликат (псевдоним) дескриптора handle. Дубли- 
кат связан с тем же открытым файлом или устройством, что и исходный дескрип- 
тор, имеет тот же режим доступа (только чтение, только запись, чтение и запись) и 
имеет тот же указатель позиции в файле. Изменение указателя в одном из деск- 
рипторов приводит к синхронному сдвигу указателя в другом дескрипторе. Функ- 
ция dup2 создает и возвращает аналогичный функции dup дубликат newhandle де- 
скриптора oldhandle. Функции dup и dup2 могут использоваться, в частности, для 
перенаправления стандартных потоков. Например, операторы 

int hout = open("output.txt", О CREAT | О ИВОМЬУ, $ ТМВТТЕ); 

dup2 (пой, 1); 


перенаправляют стандартный выходной поток stdout (его дескриптор равен 1 — 
см. раздел 15.5.1) в файл «output.txt». 


15.5.4 Функции ввода/вывода 


|Функция — |Синтаксие / Опа 


| fgetchar |int _fgetchar(void) 
| Вводит символ из потока stdin 


ИИ a) 


int _fputchar(int с) 


Выводит символ с в поток stdout, то же, что 
fputc(c, stdout); при ошибке возвращает EOF 


| _getw int getw(FILE *stream) 
| Вводит целое число из потока stream 


char *cgets(char *str) 


Читает строку символов с консоли 


void clearerr(FILE *stream) 


Очищает индикаторы ошибок и конца файла потока 
stream 


int cprintf(const char *format [, argument, ...] 
Выводит на экран список аргументов argument по 
формату format (см. раздел 15.1.4.1) 


int cputs(const char *str) 


Выводит строку на экран; возвращает последний 


символ 


int cscanf(char *format [, address, ...]) 
Вводит данные с консоли в список аргументов по 
адресам argument по формату format; возвращает 


число успешно введенных полей или EOF при кон- 
це файла 


int eof(int handle) 


Возвращает 0 при достижении конца потока (фай- 
ла), связанного с дескриптором handle 
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| Функция Синтаксис / Опа о [фа | 
int Гео (ЕП *stream) | 
Возвращает 0 при достижении конца потока (фай- 
ла) stream 

| int ferror(FILE *stream) , ; stdio.h 

| Проверяет ошибки ввода/вывода потока stream и 

| возвращает 0 при отсутствии ошибки 
int fgetc(FILE *stream) stdio.h 

| Вводит символ из потока stream и возвращает ero 

| обратно 

fgetpos stdio.h 

| Заносит в POS текущую позицию файла stream; при 

| успехе возвращает 0 

fgets char *fgets(char *s, int п, FILE *stream) stdio.h 

| Вводит в $ и возвращает строку до п символов из 

| потока stream 

| FileRead int FileRead(int Handle, void *Buffer, int Count) SysUtils.hpp 

| Выводит из файла с дескриптором Handle, открыто- 

| го функциями FileOpen или FileCreate, Count бай- 

| тов в буфер Buffer; возвращает число прочитанных 

| байтов или -1 
int FileSeek(int Нап Те, int Offset, int Origin) SysUtils.hpp 
Перемещает указатель файла с дескриптором Hand- 
le, открытого функциями FileOpen или FileCreate, 

FileWrite SysUtils.hpp 
ment по формату format; возвращает число успеш- 

но записанных байтов или EOF при ошибке 


Ha Offset байтов от позиции Origin; возвращает 0 
int fputc(int с, FILE *stream) stdio.h 
Выводит символ с в поток stream 


int fgetpos(FILE *stream, fpos_t *pos) 


int Count) 


Вводит в файл с дескриптором Handle, открытый 
функциями FileOpen или FileCreate, Count байтов 
из буфера ВиЁег; возвращает число записанных 
байтов или -1 


int fprintf(FILE *stream, 
const char *format [, argument, ...]) 


Выводит в файл stream список аргументов argu- 


| 
| 
| 
| 
| 
| 
| 
| 


при успешном завершении 
int FileWrite(int Handle, const void *Buffer, 

int fputs(const char *s, FILE *stream) stdio.h 
Выводит строку $ в поток stream; при ошибке воз- 

вращает ЕОЕ 


— 
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Функция |Синтаксис / Описание Файл 


size_t fread(void *ptr, size_t size, size_t п, 
FILE *stream) 
Неформатированное чтение из Stream в ptr п эле- 
ментов данных размером $12е каждый; возвращает 
число успешно прочитанных байтов (п * size) 


int fscanf(FILE *stream, 
const char *format [, address, ...]) 


= 


stdio.h 


Вводит данные из файла stream в список apryMeH- 
тов по адресам argument по формату format; воз- 

вращает число успешно введенных полей или ЕОЕ 
при конце файла 


| fseek int fseek(FILE *stream, long offset, int fromwhere) 


| Перемещает указатель файла stream на offset бай- 
| тов OT позиции fromwhere; возвращает 0 при 

| успешном завершении 

int fsetpos(FILE *stream, const fpos_t *pos) 


Устанавливает указатель потока stream в позицию 
pos 


long int ftell(FILE *stream) 
Возвращает текущую позицию файла stream 
size_t fwrite(const void *ptr, size_t size, size_t п, 


FILE *stream) 


Неформатированная запись из ptr в stream п эле- 
ментов данных размером Size каждый; возвращает 
число успешно записанных байтов (п * size) 


int getc(FILE *stream) 
Вводит символ из потока stream 


af 
@ 
= 
© 


int getch(void) 
Вводит символ с консоли без эхо на экране 


getchar int getchar(void) stdio.h 


Вводит символ из stdin; To же, что getc(stdin) 


| 
| 
| 
| 
| 


int getche(void) 


| getche 
| Вводит символ с консоли с эхо Ha экране 


char *getpass(const char *prompt) 


| getpass 
| Вводит пароль с консоли до восьми символов после 


печати на экране приглашения prompt; возвращает 
введенную строку 


| Вводит строку из stdin 
int kbhit(void) 
Проверяет нажатие клавиши консоли; если ни одна 


клавиша не нажата — возвращает 0 


| 
| 
} 
| 
| 
| 
| 
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Функция 


long lseek(int handle, long offset, int fromwhere) 


| 
| 
| 
| 
| 
J 


< 


3 
© | 
= 
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Перемещает указатель файла с дескриптором hand- 
le на offset байтов от позиции fromwhere; возвра- 
щает 0 при успешном завершении 


stdio.h 


void perror(const char *s) 


Выводит в стандартный выходной поток ошибок со- 
общение $ 


int printf(const char *format [, argument, ...]) 


Выводит в стандартный поток stdout список аргу- 
ментов argument по формату format (см. раз- 
дел 15.1.4.1) 


int putc(int с, FILE *stream) 


Выводит символ с в поток stream 


int putch(int с) 
Выводит символ с на экран 


int putchar(int с) 


stdio.h 


| putchar 


Makpoc, выводящий символ c в stdout; эквивален- 
тен putc(c,stdout) 


int puts(const char *s) 
Выводит строку $ в stdout и добавляет символ HO- 


stdio.h 


вой строки 
int puttext(int left, int top, int right, 
int bottom, void *source) 


Выводит содержимое блока памяти source на экран 
в текстовом режиме в прямоугольник с координата- 
ми left, top, right, bottom 


int _putw(int м, FILE *stream) 
Выводит в поток stream целое w 


int read(int handle, void *buf, unsigned len) 


read 


Чтение из файла с дескриптором handle в буфер buf 
len байтов 


int scanf(const char *format [, address, ...]) 
Вводит данные из потока stdin в список аргументов 


по адресам argument по формату format (см. раз- 
дел 15.1.4.1) 


int sprintf(char *buffer, 
const char *format [, argument, ...]) 


Выводит в строку buffer список аргументов argu- 
ment по формату format (см. раздел 15.1.4.2) 


int sscanf(const char *buffer, 
const char *format [, address, ...]) 


Вводит данные из строки buffer в список apryMeH- 
тов по адресам argument по формату format 


4 
| 
| 
| a“ 


| 
| 
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long tell(int handle) 


Возвращает текущую позицию файла с дескрипто- 
pom handle 


int ungetc(int c, FILE *stream) stdio.h 
| Возвращает символ ch в поток stream, чтобы OH 
| стал следующим символом для чтения 
| int ungetch(int ch) | conio.h 
| Возвращает символ Ch на консоль, чтобы OH стал 
| следующим символом для чтения 
| vfprintf 111% vfprintf(FILE *stream, stdio.h 

const char *format, va_list arglist) 
Выводит в файл stream список аргументов arglist 
по формату format (см. раздел 15.1.4.1) 


| vfscanf int vfscanf(FILE *stream, stdio.h 
const char *format, va_list arglist) 
Вводит данные из потока stream в список адресов 
аргументов arglist по оке format (см. раз- 
| дел 15.1.4.2) 


ia int vprintf(const char *format, va_list arglist) stdarg.h 
Выводит в stdout список аргументов arglist mo фор- 
мату format (см. раздел 15.1.4.1) 
[vscant int vscanf(const char *format, va_list arglist) stdarg.h 
Вводит данные из потока stdin в список адресов ap- 
гументов arglist по формату format (см. раз- 
дел 15.1.4.2) 
vsprintf int vsprintf(char *buffer, const char *format, stdarg.h 
va_list arglist) 
Выводит в строку buffer список аргументов arglist 
по формату format (см. раздел 15.1.4.1) 
| caked? int vsscanf(const char *buffer, stdarg.h 
| const char *format, va_list arglist) 
| Вводит данные из буфера buffer в список адресов 
аргументов arglist по формату format (см. раз- 
дел 15.1.4.2) | 


int write(int handle, void *buf, unsigned len) 
Выводит в файл с дескриптором handle из буфера 
т | buf len байтов НА. ось авы 


Комментарии 

Для работы с текстовыми файлами чаще всего используются функции scanf 
для чтения и printf для записи. 

Функции printf, sprintf, vfprintf, vprintf, vsprintf производят форматирован- 
ный вывод данных из списка указанных в них аргументов. Строка форматирова- 
ния подробно рассмотрена в разделе 15.1.4.1. Функции возвращают число успеш- 
но записанных байтов или EOF при ошибке. 
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Функции fscanf, scanf, cscanf, sscanf, vfscanf, vscanf, vsscanf производят 
форматированный ввод данных в список адресов аргументов. Строка форматирова- 
ния подробно рассмотрена в разделе 15.1.4.2. Число спецификаций в строке фор- 
матирования и число аргументов в списке должны совпадать. Функции возвраща- 
ют число успешно введенных полей, а если достигнут конец файла, то возвращают 
EOF. Обратите внимание на то, что указываются не сами переменные, в которые 
осуществляется ввод данных, а их адреса. Например: 

ЕТЬЕ *Е; 

if ((F = fopen("Test2.txt", "rt")) == NULL) 

{ 

ShowMessage ("Файл не удается открыть"); 
return; ; 


} 


ant. 31, 44: 


double r; 

if (fscanf(F, "%$а%а%1е", &11, &12, &r) != 3) 
ShowMessage ("Ошибка чтения"); 

else 

{ 

} 

fclose(F); 


Функции vfprintf и vfscanf работают co списком аргументов переменной дли- 
ны типа va_list, который объявлен в файле stdarg.h (см. раздел 15.7.4). Они могут 
использоваться внутри функций, принимающих переменное число параметров. 
Например: 

#include <stdio.h> 

#include <stdarg.h> 


FILE *fp; 


void pr(char *format, ...) 
{ 

fp = tmpfile(); 

if (fp == NULL) 

{ 


ShowMessage ("Временный файл не может быть создан"); 
‚2499 ив у: 

} 

va_list ар; 

int arg; 

va_start(ap, format); > 

arg = vfprintf(fp, format, ap); 

va_end(ap); 


} 
Вызов такой функции может иметь, например, вид: 
pet" $a-80.-30"; 2:0, 20, 30): 


Функции getchar, _fgetchar, cgets, cprintf, fputchar, putch, puttext, getch, 
getche, cputs, getpass, cscanf, kbhit, ungetc, ungetch, vprintf, vscanf He могут ис- 
пользоваться в приложениях с графическим интерфейсом для Wins2. 

В приложениях с графическим интерфейсом для Win32 при использовании 
функций scanf, gets должен быть перенаправлен поток stdin, а при использовании 
функций printf, putchar, puts должен быть перенаправлен поток stdout. 

Функции getchar, fgetchar, getc, fgetc возвращают читаемый символ, преоб- 
разованный в целое без знака. 
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Функции getchar, fgetchar, getc, gets, fgets, fgetc, fpute при ошибке преоб- 
разования или при окончании файла возвращают EOF. 

Функции getc, fgetc, getchar после чтения возвращают символ в поток. При 
этом функции getc увеличивают указатель потока на 1, подготавливая чтение сле- 
дующего символа. 

Функция _getw возвращает целое, прочитанное из потока. Поток (файл) дол- 
жен быть открыт в текстовом режиме. Функции putw, puts записывают соответст- 
венно целое и строку в поток. При ошибке преобразования или при окончании 
файла все эти функции возвращают EOF. Поскольку EOF является допустимым 
возвращаемым значением, для проверки конца файла или ошибки преобразования 
надо использовать функции feof и ferror. 

Функция gets читает последовательность символов до символа конца строки, 
который не помещает в возвращаемую строку, заменяя его нулевым символом. 

Функция fgets читает последовательность символов до заданного числа симво- 
лов п или до символа конца строки, который помещает в возвращаемую строку, 
помещая после него нулевой символ. 

Функция puttext, используемая только в консольных приложениях, выводит 
содержимое блока памяти, на который указывает Source, на экран в текстовом ре- 
жиме в прямоугольник с координатами left, top, right, bottom. Координаты лево- 
го верхнего угла (1,1). Каждой позиции на экране соответствуют 2 байта, первый 
из которых — символ, а второй — атрибуты вывода. Функция возвращает ненуле- 
вое значение при успешном выводе и 0 — при ошибке. 

Функции fseek и 1зеек перемещают указатель файла Ha Offset байтов от пози- 
ции fromwhere. Для текстового файла параметр offset должен быть равен 0 или со- 
ответствовать допустимому значению, возвращенному функцией ftell. Параметр 
fromwhere, определяющий точку, относительно которой производится смещение 
offset, может принимать значения: 


А ар О D STEIN EEL DE ESE NEE О Я а а осы 


SEEK_SET 0 начало файла 
SEEK_CUR 1 текущая позиция файла 
SEEK_END 2 конец файла 


Функции возвращают 0 при успешном завершении. 
Функции FileRead, FileWrite и FileSeek используются для работы с файлами, 
открытыми функциями FileOpen или FileCreate. 


15.5.5 Функции обработки имен файлов 


Функция | Синтакоис /Ommeamme ation 


char *_mktemp(char *template) 


Генерирует, заносит в template и возвращает 
уникальное имя файла, которое может в даль- 
нейшем использоваться для создания времен- 
ных файлов 


System::AnsiString ChangeFileExt( 
const System::AnsiString FileName, 
const System::AnsiString Extension) 


| ChangeFileExt SysUtils.hpp 


Возвращает имя файла FileName с изменен- 
ным расширением Ha Extension; сам файл не 
переименовывается 
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SysUtils.hpp 


System::AnsiString ExpandFileName( 


| ExpandFileName 
| const System::AnsiString FileName) 


Расширяет имя файла FileName, добавляя к 
нему текущие путь и диск; проверка сущест- 
вования такого файла не проводится 


System::AnsiString ExpandUNCFileName( 
const System::AnsiString FileName) 


| ExpandUNCFile- SysUtils.hpp 


Расширяет имя файла FileName, добавляя к 
нему текущие путь и том в формате UNC: 
«\\<servername>\<sharename>», если том 
указывает на сеть 


ExtractFileDir System::AnsiString ExtractFileDir( SysUtils.hpp 


const System::AnsiString FileName) 


Извлекает из FileName и возвращает путь к 
файлу 


System::AnsiString ExtractFileDrive( SysUtils.hpp 


| ExtractFileDrive 
| const System::AnsiString FileName) 


Возвращает диск файла FileName (например, 
«с:») или в формате UNC: «\\<serverna- 
me>\<sharename>>», если путь указывает на 
сеть 


System::AnsiString ExtractFileExt( ? SysUtils.hpp | 
const System::AnsiString FileName) 


Возвращает расширение файла FileName 


System::AnsiString ExtractFileName( 


ExtractFileName 
| const System::AnsiString FileName) 


Возвращает имя файла, извлеченное из File- 
Маше, т.е. конец строки после последнего об- 
ратного слеша или двоеточия 


System::AnsiString ExtractFilePath( 
const System::AnsiString FileName) 


ExtractFilePath 


Возвращает путь к файлу, извлеченный из Fi- 
leName, включая последний обратный слеш 
или двоеточие, отделяющие путь от имени 


| ExtractRelative- 
| Path 


System::AnsiString ExtractRelativePath( 
const System::AnsiString BaseName, 
const System::AnsiString DestName) 


Возвращает относительный путь файла Dest- 
Маше относительно каталога BaseName, 
включая форматы вида «..\» 


System::AnsiString ExtractShortPathName( 
const System::AnsiString FileName) 


ExtractShort- 
| Рай Маше 


Возвращает путь и имя файла FileName, пре- 
образовывая имена в формат 8.3 


в 
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———— — 


| Функция Отаноне Фа / Описание 


| bool MatchesMask( Masks. hpp 
| const System::AnsiString Filename, 

| const System::AnsiString Mask) 

| Проверяет Filename на использование маски 

| Mask 

| MinimizeName System::AnsiString MinimizeName( filectrl.hpp 
| const System:: AnsiString Filename, 

| Graphics::TCanvas * Canvas, int MaxLen) 

| Минимизирует uma Filename, сокращая путь 

| до размера, вмещающегося при изображении | 

| на канве Canvas в MaxLen пикселей 


| ProcessPath void ProcessPath( filectrl.hpp 
| const System::AnsiString EditText, 

| char &Drive, System::AnsiString &DirPart, 

| System::AnsiString &FilePart) 

| Разделяет путь процесса EditText на драйвер 

| Drive, путь DirPart и имя FilePart 

| 

| tmpnam char *tmpnam(char *s) stdio.h 
| Создает уникальное имя файла, которое MO- 

| жет в дальнейшем использоваться для созда- 

р _ | | ния временных файлов | 


Комментарии 

Все функции (кроме tmpnam и _mktemp) возвращают строку типа AnsiString 
(см. главу 16), содержащую результат преобразования имени файла FileName. Могут 
работать с многобайтными символами. Если FileName не содержит пути или расши- 
рения, то соответствующие функции ExtractFile... возвращают пустую строку. 

Не забывайте, что обратный слеш в строке пути к файлу должен повторяться 
дважды (см. раздел 15.1.3). Например: 


"C:\\Program Files\\Bcb.exe" 


Функция ExtractFileDir возвращает путь к файлу в TOM виде, который нужен 
для передачи в функции CreateDir, GetCurrentDir, RemoveDir, SetCurrentDir 
(см. раздел 15.5.6). 

Функция ExtractShortPathName возвращает путь и имя файла FileName, co- 
кращая имена каталогов и файлов до формата 8.3. Например, строка 


C:\Program Files\Borland\CBuilder\Bin\Bcb.exe 


будет возвращена как 
C:\Progra~1\Borland\CBuilder\Bin\Bcb.exe ' 


Функция MatchesMask проверяет Filename на использование маски Mask. 
Маска может содержать обычные алфавитно-цифровые символы, множества, сим- 
волы «*» — любое количество любых символов и «?» — любой один символ. Мно- 
жества заключаются в квадратные скобки [ ]. В скобках без пробелов записывают- 
ся возможные символы или диапазоны в виде <символ>-<символ>. Например, 
‹а-с». Если первый символ в множестве — восклицательный знак «!», то это MHO- 
жество содержит символы, которые не должны встречаться. Сравнение с маской 
призводится без учета регистра. Функция MatchesMask возвращает true, если 
Filename соответствует маске, false, если не соответствует и генерирует исключе- 
ние при синтаксически неверной маске. Например, маске 
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‚па-ы).; \test\\*..*" 


будут соответствовать все имена файлов, расположенных на дисководах а: или b: в 
каталоге «test». 

Функция MinimizeName минимизирует имя Filename, сокращая путь до раз- 
мера, вмещающегося при изображении на канве Canvas в MaxLen пикселей. Вме- 
сто выброшенных частей пути изображаются точки. Например, оператор 


Labell->Caption = MinimizeName("C:\\Program Files\\Bcb.exe", 
Labell->Canvas, 100); 


приведет к появлению в метке Labell надписи: 
C:\...\Beb.exe 


Функции tmpnam u_mktemp создают уникальное UMA файла, которое может 
в дальнейшем использоваться для создания временных файлов. Последовательное 
обращение к функции tmpnam может создавать до ТМР_МАХ = 65 535 уникаль- 
ных имен. Параметр $ этой функции должен задаваться или равным NULL, или 
указывать на массив размером не менее L_tmpnam символов (эта константа опре- 
делена в stdio.h). В случае параметра равного NULL, функция tmpnam сама созда- 
ет необходимый объект с именем файла и возвращает указатель на него. 

Если вы создаете затем временный файл с именем, сгенерированным tmpnam 
или _mktemp, то должны сами позаботиться о его удалении в конце работы про- 
граммы. Автоматически он не удаляется. 


15.5.6 Управление каталогами и файлами на дисках 


| Функция _ | Синтакоис /Onueamme 


|_getdewd char * _getdcwd(int drive, char *buffer, int buflen) 


Заносит в буфер buffer размером buflen текущий Ka- 
талог диска drive (0 — текущий диск, 1 — А ит.д.); 
возвращает указатель Ha buffer или NULL; при buf- 
fer = NULL создает буфер и возвращает указатель 
на него 


int _rmdir(const char *path) 


Удаляет каталог path (пустой, He текущий и не кор- 
невой); возвращает 0 при успехе или -1 


int _rtl_chmod(const char *path, 

int func [, int attrib]) 
При func = 0 возвращает текущие атрибуты файла, 
при func = 1 устанавливает файлу атрибуты attrib 


int _waccess(const wchar_t *filename, int amode) 


Определяет, существует ли файл filename и какие 
операции с ним доступны; режим работы задается 
параметром amode 


int _wrtl_chmod(const wchar_t *path, int Ёипс, ...) |10.В, dos.h 


При func = 0 возвращает текущие атрибуты файла, 
при func = 1 устанавливает файлу атрибуты attrib 
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access int access(const char *filename, int amode) 
Определяет, существует ли файл filename и какие 
операции с ним доступны; режим работы задается 
параметром amode 

| int chdir(const char *path) 

| Задает path в качестве текущего каталога; возвраща- 

| ет 0 при успехе или -1 

| chmod int chmod(const char *path, int amode) 

| Изменяет режим доступа amode к файлу path; воз- 

| вращает 0 при успехе или -1; amode содержит одно 

| или оба значения S_IWRITE и S_IREAD 

| int chsize(int handle, long size) 

| Изменяет размер файла с дескриптором handle, от- 

| крытого для записи, до size байтов; возвращает 0 

| или -1 

| CreateDir bool CreateDir(const System::AnsiString Dir) 

| Создает каталог Dir и возвращает true в случае yc- 
пеха 


DeleteFile bool DeleteFile(const System::AnsiString FileName) | Sys- 
| Удаляет файл FileName с диска и возвращает true в Utils.hpp 


случае успеха 


Directory- bool DirectoryExists(const System::AnsiString Name) | Sys- 
Exists Определяет, существует ли каталог Name Utils.hpp 
DiskFree int DiskFree(Byte Drive) ) Sys- 
Возвращает число свободных байтов Ha диске Drive Utils.hpp 
или -1, если Drive ошибочный (Drive =0 — текущий 
диск, 1 — А, 2 -Вит.д.) 
int DiskSize(Byte Drive) Sys- 
Возвращает размер в байтах диска Drive или -1, Utils.hpp 
если Drive ошибочный (Drive =0 — текущий диск, 
1—А, 2 -Вит.д.) 
FileAge int FileAge(const System::AnsiString FileName) Sys- 


Возвращает дату создания файла FileName или -1, Utils.hpp 
FileDateTo- 


если такого файла нет 

System::TDateTime FileDateToDateTime( Sys- 
DateTime 

bool FileExists(const System::AnsiString FileName) | Sys- 

Определяет, существует ли файл FileName Utils.hpp 


int FileDate) | Utils.hpp 
FileGetAttr (int FileGetAttr(const System::AnsiString FileName) | Sys- 
Возвращает атрибуты файла FileName вены | 


FileDate, заданные в формате DOS 


Возвращает в формате типа TDateTime дату и время 
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| FileGetDate 
filelength 


|FileSearch 


Files etAttr 
| FileSetDate 


| FindClose 
| | FindFirst 
| FindNext 


fnmerge 


int FileGetDate(int Handle) 


Возвращает дату создания файла с дескриптором 
Handle или -1, если такого файла нет 


long filelength(int handle) 


Возвращает длину в байтах файла с дескриптором 
handle; при ошибке возвращает -1 


System::AnsiString FileSearch( 
const System:: AnsiString Name, 
const System::AnsiString DirList) 


Ищет в списке каталогов DirList файл Name; воз- 
вращает полный путь к файлу или пустую строку 


int FileSetAttr(const System::AnsiString FileName, 
int Attr) 


Устанавливает файлу FileName атрибуты Attr; воз- 
вращает 0 или код ошибки 


int FileSetDate(int Handle, int Age) 


Устанавливает дату Age файлу с дескриптором Han- 
Че; возвращает 0 или код ошибки 


void FindClose(TSearchRec &F) 


Завершает последовательность поиска функциями 
FindFirst и FindNext co wr debe Е и освобождает 
память 


Sys- 
Utils. hpp 


Sys- 
Utils. hpp 


Sys- 
Utils. hpp 


int FindFirst(const System::AnsiString Path, 
int Attr, TSearchRec &F) 


Начинает поиск файлов по шаблону Path с атрибута- 
ми Attr; заносит результат в Е; возвращает 0 или 
код ошибки 


int findfirst(const char FAR *_ path, 
struct ffblk FAR *_ ffblk, int attrib) 


Начинает поиск файлов по шаблону __ path с атри- 


бутами __ а г; заносит результат в __ НЫК; возвра- 
щает 0 при успехе или -1 


int FindNext(TSearchRec &F) 


Продолжает поиск файлов, начатый функцией Find- 
First со структурой Е; заносит результат в Е; возвра- 
щает 0 или код ошибки 


int findnext(struct ffblk FAR *_ ffblk) 


Продолжает поиск файлов, начатый функцией find- 
first со структурой __НЫК; возвращает 0 при успехе 
или -1 


Sys- 
Utils. hpp 


void fnmerge(char *path, const char *drive, 
const char *dir, const char *name, const char ext) 


Формирует строку path пути к файлу из ero отдель- 
ных составляющих: диска drive, каталога dir, имени 
файла паше и расширения ext 
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ForceDirec- 
| tories 


рить: у ‘Gicaniitins 


int fnsplit(const char *path, char *drive, char *dir, 
char *name, char *ext) 


Разделяет строку path пути к файлу Ha ero отдель- 
ные составляющие: диск drive, каталог dir, имя 
файла name и расширение ext 


void ForceDirectories(System::AnsiString Dir) 


Ctrl.hpp 


Создает каталог Dir и все промежуточные родитель- 
ские каталоги, если они отсутствуют 


int fstat(int handle, struct stat *statbuf) 


Заносит в структуру statbuf информацию об откры- 
том файле с дескриптором handle; возвращает 0 или 
-1 


рн int getcurdir(int drive, char *directory) 
Заносит в directory текущий каталог диска drive 
(0 — текущий диск, 1 — Аит.д.) без имени диска и 
начального символа «\» 


| 'GetCurrent- |System::AnsiString GetCurrentDir() Sys- 
| Dir Возвращает текущий каталог Utils.hpp 


char *getcwd(char *buf, int buflen) 


Возвращает и сохраняет в буфере buf размером buf- 
len полный путь к текущему каталогу, включая 

 getdisk 

getftime 


диск; возвращает указатель на buf или NULL; при 
buf = NULL создает буфер и возвращает указатель 

GetSystem- 

Directory 


Ha Hero 
int getdisk(void) 
Возвращает текущий диск: 0 — А, 1 — Вит.д. 


int getftime(int handle, struct ftime *ftimep) 


Читает время и дату создания файла handle в струк- 
туру ftimep; возвращает 0 или -1 


UINT GetSystemDirectory( 
LPTSTR IpBuffer, UINT uSize) 


Функция API Windows, заносит в буфер 1рВиЁег 
размером uSize системный каталог Windows 


UINT Get WindowsDirectory( 
LPTSTR IpBuffer, UINT uSize) 


Функция API Windows, заносит в буфер IpBuffer 
размером uSize каталог Windows 


int isatty(int handle) 


Возвращает ненулевое значение, если файл с деск- 
риптором handle связан с одним из устройств: тер- 
минал, консоль, принтер, последовательный порт 


Get Windows- 
Directory 


eo 


int mkdir(const char *path) 


Создает каталог path; возвращает 0 при успехе или 


| 
| 
| 
| 
к 
aie 


| 
| 
| 
| 
| 
| 
| 
| 
| 
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Функция Синтаксис / Описание Файл | 
гетоуе int remove(const char *filename) stdio.h 
Макрос, удаляет с диска файл filename; возвращает 


| 
| 
| 
| 
| 


0 или -1 


RemoveDir bool RemoveDir(const System::AnsiString Dir) Sys- 
Удаляет с диска каталог Dir Utils. hpp 


| 
| 
| 
| 
| 
| 
| 


———_—_ —————АА———„/,/,/————/—/—/—/—/— 


searchpath char *searchpath(const char *file) 
Ищет файл Ше в каталогах, указанных в перемен- 
ной окружения РАТН; возвращает полный путь к 
файлу или NULL 
SetCurrent- | bool SetCurrentDir(const System::AnsiString Dir) | Sys- 
Dir Задает Dir в качестве текущего каталога Utils.hpp 
int setdisk(int drive) 
Устанавливает в качестве текущего диск drive: 0 — A, 
1 — Вит.д.; возвращает число доступных дисков 
setftime int setftime(int handle, struct ftime *ftimep) 
| Устанавливает время и дату создания файла handle 
по данным структуры ftimep; возвращает 0 или -1 


int stat(const char *path, struct stat *statbuf) 
Заносит в структуру statbuf информацию об откры- 
том файле path; возвращает 0 или -L ___ 


Ч 
| 
| 
| 
| 
| 
| 


sys\stat.h 


| rename int rename(const char *oldname, stdio.h 
const char *newname) 
Переименовывает файл oldname, давая ему новое 
имя пеупаше; может использоваться для перемеще- 
ния файла без изменения диска; возвращает 0 или -1 


RenameFile | bool RenameFile(const System::AnsiString OldName, | Sys- 
const System::AnsiString NewName) | Utils.hpp 
Переименовывает файл OldName, давая ему новое имя 
NewName; если файл с именем NewName уже сущест- 
вует или нет файла OldName, возвращается false 


Комментарии 
Функции fstat и stat заносят в структуру типа stat информацию 06 открытом 
файле. Структура имеет поля: 


ее 


битовая маска режима файла 


st_dev номер диска файла или дескриптор, если файл на устройстве 

st_rdev TO же, что st_dev 

st_nlink — константа 1 

st_size размер файла в байтах 

st_atime время последнего открытия (в Windows) или изменения (в DOS) 
`° 5 шише то же, что st_atime 


st_ctime To же, что st_atime 
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Маска st_mode содержит информацию о режиме открытого файла и включает 
в себя следующие биты. 
Должен быть установлен один из следующих битов: 


ини oes а ae a 
S_IFCHR .- если дескриптор ссылается на устройство 
S_IFREG если дескриптор ссылается Ha обычный файл 


Должен быть установлен один или оба следующих битов: 


О О а О О О о APBELIEBE LALO LDPE LS. 


S_IWRITE пользователю разрешена запись в файл. 


S_IREAD пользователю разрешено чтение из файла 


Системы HPFS и NTFS учитывают следующее различие между полями 
st_atime, st_mtime и st_ctime: 


IROL LOOL LENO LILIES SE LORE LSE LG ELLER В О LEE REBEL SS i Se a 


st_atime время последнего доступа к файлу 
st_mtime время последней модификации файла 
st_ctime время создания файла 


Следующий пример демонстрирует работу функции stat: 


#include <stdio.h> 
#include <time.h> 
#include <sys\stat.h> 


struct stat statbuf; 
FILE *stream; 
if ((stream = fopen("TEST.TXT", "r+t")) == NULL) 
{ 
ShowMessage ("Невозможно открыть файл"); 
return; 
} 
stat ("TEST.TXT", é&statbuf); // чтение информации 
Ес1озе (stream); 


// отображение информации: 
if (statbuf.st mode & $ ТЕСНВ) 
Мето1->1пез->Ааа ("Дескриптор устройства"); 
if (statbuf.st mode & $ ТЕВЕС) 
Мепо1->1пе$->Аада ("Ссылка на файл"); 
if (statbuf.st mode & $ IREAD) 
Memol->Lines->Add("PaspemeHo чтение из файла"); 
if (statbuf.st_mode & S_IWRITE) 
Memol->Lines->Add("PaspemeHa запись в файл"); 
Мемо1->Г1пе5->Ааа ("Файл расположен на диске " + 
AnsiString((char) ('A'+tstatbuf.st dev))); 
Memol->Lines->Add("Pasmep файла в байтах: " + 
IntToStr(statbuf.st size)); 
Мемо1->1пез->Ааа ("Последний раз файл был открыт " + 
AnsiString(ctime (&éstatbuf.st ctime))); 


Функции remove и _unlink удаляют с диска указанный файл. Если файл от- 
крыт, то перед удалением его надо закрыть. Файл с атрибутом только для чтения 
не может быть удален. Сначала надо изменить его атрибут функциями Chmod или 

rtl_chmod. 
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Функции access и _Waccess определяют разрешенный доступ к файлу, задан- 
ному параметром filename. Различаются они только типом строки, содержащей 
имя файла. Функции проверяют, существует ли файл, и если существует, то разре- 
шено ли чтение, запись или выполнение этого файла. 

Параметр ато4е определяет, что именно должно проверяться: 


BERRIES GIO GREE EERE EEE ELLE О В О А О ао аа В а анны 


06 Проверка разрешения чтения и записи 

04 Проверка разрешения чтения 

02 Проверка разрешения записи 

01 Проверка, является ли файл выполняемым 
00 Проверка существования файла 


В DOS, 05/2 и Windows все существующие файлы имеют разрешение чтения. 
Поэтому значения amode 00 и 04 дают одинаковый результат. В DOS разрешение 
записи подразумевает и разрешение чтения. Поэтому 06 и 02 также дают одинако- 
вый результат. . 

Если в качестве filename задан не файл, а каталог, то функции просто прове- 
ряют, существует ли каталог. 

Функции возвращают 0, если файл имеет запрошенный уровень доступа. В 
противном случае возвращается 1, а глобальная переменная еггпо устанавливает- 
ся в одно из следующих состояний: 


ЕМОЕМТ путь или файл не найден 
EACCES ошибка доступа 


Функции FindFirst, FindNext и FindClose осуществляют поиск файлов, удов- 
летворяющих некоторым условиям. В своей работе они используют для хранения 
информации о файле структуру TSearchRec: 

struct TSearchRec 


{ 


int Time; // время создания 
int Size; // размер файла 
int Attr; // атрибуты 
System: :AnsiString Name; // имя файла 

int ExcludeAttr; 

int FindHandle; // дескриптор 


_WIN32_ FIND DATAA FindData; 
Е. ; 


Поле Attr этой структуры содержит слово атрибутов файла. Атрибуты файлов 
определяются комбинациями следующих именованных констант: 


Атрибут 
файл только для чтения 
невидимый файл 
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Начинается поиск вызовом функции FindFirst. В нее в качестве аргумента 
Path передается шаблон поиска, а в качестве аргумента Attr — слово атрибутов, 
которыми должны характеризоваться искомые файлы. Это слово формируется из 
указанных выше констант атрибутов операцией поразрядного ИЛИ. Если соответ- 
ствующий файл нашелся, функция возвращает 0, а в указанную ее параметром Е 
структуру типа TSearchRec заносится информация о файле. Если после этого вы- 
звать функцию FindNext с той же структурой F в качестве параметра, то будет 
продолжен поиск следующего файла, удовлетворяющего заданным условиям. По- 
сле того, как поиск всех файлов закончен или после того, как решено поиск пре- 
рвать, вызывается функция FindClose, которая освобождает выделенную под орга- 
низацию поиска память. 

Например, следующие операторы осуществляют поиск всех файлов и подката- 
логов текущего каталога и выводят результаты в окно редактирования Memol: 


TSearchRec sr; | 

Мемо1->С1еаг(); 

if (FindFirst("*.*", faAnyFile | faDirectory, sr) == 0) 

{ 

Memol->Lines->Add(sr.Name+", размер: "+IntToStr(sr.Size)); 
while (FindNext(sr) == 0) 
Memol->Lines->Add(sr.Name+", размер: "+IntToStr(sr.Size)); 

} 


FindClose(sr) ; 


Приведем более сложный пример. Следующий обработчик щелчка на кнопке 
Buttonl обеспечивает в текущем каталоге и во всех его подкаталогах поиск и уда- 
ление файлов с расширением .tds: 


void _ fastcall TForml::ButtonlClick(TObject *Sender) 
{ 
AnsiString CurDir = GetCurrentDir(); 
TSearchRec sr; 
if (FindFirst("*.*", faAnyFile | faDirectory, sr) == 0) 
{ 
if (CompareText (ExtractFileExt (sr.Name),".tds") == 0) 
DeleteFile(sr.Name) ; 
else if((sr.Attr == faDirectory) &&(sr.Name !=".") 
&&(sr.Name !="..")) 
{ 
SetCurrentDir (ExtractFileDir(sr.Name) ); 
ButtonliClick (Sender) ; 
_SetCurrentDir (CurDir) ; 


} 


while (FindNext(sr) == 0) 
{ 
if (CompareText (ExtractFileExt (sr.Name),".tds") == 0) 
DeleteFile(sr.Name) ; 
else if((sr.Attr == faDirectory) &&(sr.Name !=".") 


&&(sr.Name !="..")) 
{ 
SetCurrentDir(sr.Name) ; 
ButtoniClick (Sender) ; 
SetCurrentDir (CurDir) ; 
} 
} 
} 
FindClose (sr); 


} 


Приведенная функция использует рекурсивный вызов самой себя при перехо- 
де в подкаталоги. ; 
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Альтернативный вариант цоиска файлов, удовлетворяющих шаблону, предос- 
тавляют функции findfirst и findnext. Они используют для хранения информации 
о файле структуру типа ffblk: 


struct ffblk { 


long ff reserved; 
long ЕЕ fsize; // размер файла 
unsigned long ff attrib; // атрибуты 
unsigned short ff ftime; // время создания 
unsigned short ЕЁ fdate; // дата создания 
char ff name[256]; // имя файла 
}; 
Поле атрибутов ff_attrib в этой структуре формируется из констант FA_..., оп- 


ределенных в файле dos.h и рассмотренных в разделе 15.5.1. Поля # те и 
ff_fdate содержат битовые поля даты и времени. В поле ff_ftime биты 0 - 4 хранят 
пары секунд, биты 5 - 10 хранят минуты, биты 11 - 15 — часы. В none ff_fdate 
биты 0 - 4 хранят день, биты 5 - 8 — месяц, биты 9 - 15 — год, отсчитываемый 
от 1980. | 

Сам по себе поиск, осуществляемый функциями findfirst и findnext, не отли- 
чается от рассмотренного выше для функций FindFirst и FindNext. 

Функция FileSearch ищет в списке каталогов DirList файл Мате. Список 
DirList представляет собой перечень обычным образом записанных путей к ката- 
логам, разделенных точками с запятой. При успешном поиске функция возвраща- 
ет имя файла с полным путем к нему (если файл найден в текущем каталоге, воз- 
вращается только имя файла). Если файл не найден, возвращается пустая строка. 

Функция searchpath ищет файл Ше в списке каталогов, указанных в перемен- 
ной окружения PATH. Возвращает полный путь к файлу или NULL. 

Функция FileExists определяет, существует ли указанный файл. 

Функция fnmerge формирует строку path пути к файлу из его отдельных со- 
ставляющих: диска drive, каталога dir, имени файла name и расширения ext. В 
итоге получается строка вида drive:\path\name.ext. Каждая из составляющих 
пути (dir, path, name, ext) может быть задана равной NULL. Тогда эта составляю- 
щая в результирующий путь не включается. Функция fnsplit осуществляет обрат- 
ную операцию: разделяет полный путь к файлу на его составляющие. 

Функция DirectoryExists определяет, существует ли каталог Name. Если 
Маше содержит полный путь, то проверяется наличие именно указанного катало- 
га. В противном случае Name воспринимается как путь относительно текущего ка- 
талога. 

Функции CreateDir и ForceDirectories создают переданный им как параметр 
каталог Dir. Функция ForceDirectories отличается от других подобных функций 
тем, что она может создать не только конечный каталог, но одновременно и его ро- 
‚ дительские каталоги, если они отсутствуют. Например, оператор 


ForceDirectories ("C:\\Test\\Testl1") ; 


создаст не только каталог Testl, но и ero родительский каталог Test, если OH OT- 
сутствует. Проверить, создан ли нужный каталог этой функцией, можно с помо- 
щью функции DirectoryExists. | 

Функции getcurdir и GetCurrentDir позволяют определить текущий каталог 
на заданном или текущем диске. 

Функция API Windows GetSystemDirectory, заносит в буфер строку, характе- 
ризующую системный каталог Windows. Это тот каталог, в котором размещены 
файлы библиотек, драйверов, шрифтов. Приложение не должно создавать ка- 
кие-то файлы в системном каталоге. Создавать свои файлы можно в каталоге, воз- 
вращаемом другой аналогичной функцией — GetWindowsDirectory, дающей путь 
к каталогу Windows. Этот каталог содержит файлы приложений Windows, файлы 
инициализации .ini и файлы справок „.Шр. В этом каталоге вы можете хранить 
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файлы инициализации и файлы справок своего приложения. Если приложение 
создает другие файлы, которые вы хотите хранить, не допуская к ним других 
пользователей, то помещайте их в каталог, указанный в переменной окружения 
НОМЕРАТН. При соответствующей установке этот каталог различен для всех 
пользователей. 

Параметр 1рВиЁЙег функций GetSystemDirectory и GetWindowsDirectory яв- 
ляется указателем на строку с нулевым символом в конце, в которую передается 
найденный путь. Этот путь записывается без заключительного обратного слеша 
«\», если только каталог не является корневым. 

Параметр uSize указывает максимальный размер буфера в символах. Его ве- 
личина должна быть не менее значения МАХ_РАТН. 

При успешном выполнении функции копируют путь в рВийЁег и возвращают 
число символов в строке, не считая последнего нулевого. Если длина строки боль- 
ше, чем uSize, то возвращенное значение позволяет узнать требуемый размер бу- 
фера. 

Если функция не смогла успешно завершиться, то она возвращает нулевое 
значение. В этом случае узнать причину отказа можно, вызвав GetLastError (см. 
раздел 15.7.5). 

Приведем пример. Если ваш системный каталог Windows назван WIN- 
DOWS\SYSTEM и расположен на диске C:, то операторы 


char $[МАХ PATH]; 
GetSystemDirectory(s,MAX PATH); 


занесут в $ путь: C:\WINDOWS\SYSTEM. Полученный путь можно, например, испо- 
льзовать для проверки, имеются ли на компьютере пользователя нужные библио- 
теки, драйверы и шрифты. 

Функции FileGetAttr, FileSetAttr, rtl_chmod позволяют определять или ус- 
танавливать атрибуты файла (см. описание атрибутов в разделе 15.5.1). Устанав- 
ливая атрибуты их можно объединять в одно слово атрибутов операцией поразряд- 
ного ИЛИ. Возвращенные функциями FileGetAttr и _rtl_chmod атрибуты можно 
проверять с помощью операции поразрядного И. 

Функция _г _сВто@ позволяет определить или установить атрибуты файла 
(см. их описание в разделе 15.5.1). При func = 0 функция возвращает слово теку- 
щих атрибутов файла path, а при func = 1 устанавливает файлу path атрибуты 
attrib. Например, следующий оператор устанавливает для файла, заданного стро- 
кой SFile, атрибут «невидимый»: 


_rtl_chmod(SFile, 1, РГА НТООЕМ); 


Возвращенные функциями FileGetAttr и _rtl_chmod атрибуты можно прове- 
рять с помощью операции поразрядного И. 

Следующие два оператор добавляют к атрибутам файла, заданного строкой 
SFile, атрибут «невидимый»: 


int attrib = rtl chmod(SFile, 0); 
_rtl_chmod(SFile, 1, attrib | FA _HIDDEN); 


Следующие операторы определяют и отображают в окне редактирования 
Memol атрибуты файла SFile: 


int attrib = rtl_chmod(SFile, 0); 
if(attrib == -1) 
|. 
Memol->Lines->Add("SrP<LB RTXDx " + IntToStr(errno) ); 
return; 
} 
if (attrib & FA_RDONLY) 
Memol->Lines->Add(SFile + " - файл только.для чтения"); 
if (attrib & FA HIDDEN) 
Memol->Lines->Add(SFile + " - невидимый файл"); 
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if (attrib & FA_SYSTEM) 


Memol->Lines->Add(SFile + " - системный файл"); 
if (attrib & FA DIREC) 

Memol->Lines->Add(SFile + " - каталог"); 
if (attrib & FA ARCH) 

Memol->Lines->Add(SFile + " - архивный файл"); 


Функции FileAge, FileGetDate и FileSetDate оперируют с данными о времени 
создания файла в формате DOS. В этом же формате хранится значение поля Time 
структуры типа TSearchRec, используемой в функциях FindFirst и FindNext. 
Преобразование этого формата в тип TDateTime может осуществляться функцией 
FileDateToDateTime. См. также раздел 15.3.2, посвященный преобразованиям 
форматов дат и времени. 

Функция getftime читает время и дату создания файл, заданного своим деск- 
риптором handle (он может быть определен функцией Шепо), и заносит их в струк- 
туру типа ftime, на которую указывает параметр ftimep. Функция setftime выпол- 
няет обратную задачу: задает файлу время и дату в соответствии с данными, запи- 
санными в структуру ftimep. Файл должен быть доступен для записи. В противном 
случае произойдет ошибка EACCES. После установки времени и даты в файл ниче- 
го нельзя записывать, пока он не закрыт. Иначе установка будет изменена. 

При успешном завершении функции возвращают 0. В противном случае воз- 
вращается -1, а глобальная переменная еггпо устанавливается в одно из следую- 
щих состояний: 


EACCES — ошибка доступа 
EBADF ошибочный номер файла 
EINVFNC ошибочный номер функции 


Структура типа ftime имеет вид: 


struct ftime { 


unsigned ft_tsec:’5; // пары секунд 
unsigned ft min: 6; // минуты 
unsigned ft hour: 5; // часы 
unsigned ft day: 5; // день 
uhsigned ft month: 4; // месяц 
unsigned ft year: 7; // год - 1980 


}; 


Следующий код в качестве примера определяет дату создания файла 
«Test.txt», уменышает день на 1 (делает дату вчерашней — предполагается, что 
день не равен 1) и устанавливает файлу эту измененную дату: 

FILE *stream; 


sta: : ft-ime: ft; 
char buffer[80]; 


if ((stream = fopen("TEST.TXT", "r+t")) == NULL) 
{ 
ShowMessage ("Невозможно открыть файл для записи"); 
return; 
} 
getftime(fileno(stream), &ft); // чтение даты 


sprintf (раЕЕег, "Дата создания файла: %u/tu/%su", 

ft.ft day, ft.ft_ month, ft.ft year+1980); 
ShowMessage (buffer); 
ft ft! day-; // изменение даты 
setftime(fileno(stream), &ft); // установка даты 
fclose (stream) ; 
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15.6 Управление процессами 


15.6.1 Функции управления текущим процессом 


void _c_exit(void) 


Выполняет все действия, аналогичные функции exit, по 
закрытию файлов и очистке буферов, но не вызывает 
функций окончания и не прерывает выполнение про- 
граммы 


void _cexit(void) process.h 


Выполняет все действия, аналогичные функции exit, по 
закрытию файлов, очистке буферов и вызову функций 
окончания, но не прерывает выполнение программы 


void _exit(int status) stdlib.h 


Завершает выполнение программы, HO в отличие OT exit 
не сбрасывает буферы, не закрывает файлы и не вызы- 
вает функции окончания; status — устанавливаемый 
код завершения 


Регистрирует функцию окончания func; при успехе воз- 
вращает 0 


void exit(int status) 


Завершает выполнение программы, закрывая все OT- 
крытые файлы, сбрасывая выходные буферы в соответ- 
ствующие потоки, и вызывая все зарегистрированные 
функцией atexit функции окончания; status — уста- 
навливаемый код завершения 


int raise(int sig) 
Генерирует сигнал sig; при успешной генерации возвра- 


void ( USERENTRY *signal(int sig, 
void ( USERENTRY *func) (int sigl, int subcode})))(int) 


Комментарии 

Функция atexit регистрирует в системе функцию окончания. Эта функция бу- 
дет вызываться при завершении работы программы функциями exit и _cexit. 
Обычно в этой функции предусматривается «зачистка мусора» — освобождение 
динамически распределенной памяти, уничтожение временных файлов, разрыв 
соединений с базами данных и т.п. Например, оператор 


atexit (Exitl); 


регистрирует функцию окончания, которую вы можете записать в виде: 
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void Ех1 {1 (void) 
{ 


} 


Всего в приложении может быть зарегистрировано до 32 функций окончания. 
При завершении приложения они срабатывают в последовательности, обратной 
последовательности их регистрации, т.е. последняя зарегистрированная функция 
будет вызываться первой. 

Семейство функций exit выполняет операции по завершению работы прило- 
жения. Наиболее полное завершение выполняет функция exit. Прежде, чем завер- 
шить приложение, она закрывает все открытые файлы, сбрасывает выходные бу- 
феры в соответствующие потоки, вызывает все зарегистрированные функцией 
atexit функции окончания. Параметр status функции exit — это устанавливаемый 
код завершения. 

Приведенная ниже таблица показывает, какие из этих операций выполняются 
другими функциями семейства exit, а какие нет. 


Вызов функций Завершение 
окончания приложения 


& 


Функция signal указывает обработчик func сигнала, переданного в Hee пара- 
метром sig. Сигнал — это некоторое непредвиденное событие (прерывание), кото- 
рое может вызвать преждевременное завершение программы. Его основное отли- 
чие от исключения в том, что после генерации сигнала можно вернуться в ту точку 
кода, в которой был сгенерирован сигнал. В случае исключения это невозможно. 
Сигналы могут поступать от внешних устройств, генерироваться в результате не- 
которых аварийных ситуаций или преднамвренно генерироваться функцией raise. 

В файле signal.h предопределены следующие сигналы: 


a БОНО 


Аварийное завершение программы. Генерируется только вызовом 
функций abort, raise и необработанными исключениями. Дейст- 
вие по умолчанию — вызов _ех (3) 


SIGBREAK Прерывание нажатием клавиш Ctrl-Break 


SIGFPE Ошибка арифметической операции, например, деления на нуль 
или операции, вызвавшей переполнение. Действие по умолча- 
нию — вызов _ exit(1) 


SIGILL Появление в коде недопустимой команды. Действие по умолча- 
нию — вызов _ exit(1) 

SIGINT Получение интерактивного сигнала (например, прерывание 
Ctrl+C). Действие по умолчанию — прерывание INT 23h 

SIGSEGV Нарушение доступа к памяти. Действие по умолчанию — вызов 
_exit(1) 


SIGTERM «Мягкое» завершение процесса. Действие по умолчанию — вызов 
_exit(1) | 
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SIGUSRI1, Определенные пользователем (только в Win32) сигналы пользова- 
SIGUSR2, теля, генерируемые функцией raise. Действие по умолчанию — 
SIGUSR3 игнорирование сигнала 


В функцию signal передаются два параметра: целочисленный номер сигнала 
sig и указатель func на функцию обработки сигнала. Обработчик func может быть 
определенной пользователем функцией или одним из трех предопределенных об- 
работчиков: SIG_DFL — завершение программы, SIG_IGN — игнорирование сиг- 
налов данного вида, и SIG_ERR — генерация ошибки. Например: 


signal ($ТСТМТ, SIG ERR); // генерация сообщения об ошибке 


или 
519па1 ($ТСТМТ, SIG IGN); // игнорирование сигнала SIGINT 


Если вы хотите задать свой обработчик стандартного сигнала или определен- 
ного вами сигнала, это может выглядеть так. Пусть, например, вы хотите преду- 
смотреть в своей программе обработчик некоторого вводимого вами сигнала 
SIGUSR1. Назовем функцию этого обработчика Handl SIGUSR1. Определите в 
программе тип указателя на функцию fptr: 


typedef void (*fptr) (int); 
Не забудьте также вставить в файл директиву 
#include <signal.h> 


Далее где-то в начале программы (например, в событии формы OnCreate) надо 
ввести оператор: 


31апа1 ($160$81, (fptr)Handl $160$81); 


Этот оператор установит функцию Handl SIGUSRI1 как обработчик сигнала 
SIGUSR1. В нужных местах программы вставьте оператор генерации вашего сиг- 
нала: 


га1зе ($1С0$81); 


Рассмотрим подробнее последовательность операций системы при выполнении 
этого оператора. Если в программе задан приведенным выше оператором signal об- 
работчик пользователя для данного события, то происходит обращение к этому об- 
работчику, но прежде система сбрасывает установку на SIG_DFL. Это значит, что 
при следующей генерации этого сигнала, если не повторить вызов функции signal, 
система забудет прежнюю установку и не будет опять обращаться к обработчику 
пользователя. Поэтому обычно в конце обработчика повторяют вызов signal. С 
учетом этого обработчик сигнала может иметь вид: 


void Handl $1С0$81 (int М) 
{ 


if (MessageDlg ("Продолжать?", mtConfirmation, . 
TMsgDlgButtons() << mbYes<< mbNo,0) == mrYes) 
// повторная установка обработчика: 
signal (SIGUSR1, Напа1 $160$81); 


else exit (EXIT SUCCESS) ; 
} 


Обработчик принимает одно целое значение, соответствующее номеру сигна- 
ла. В нем предусматриваются некоторые действия, необходимые при появлении 
данного сигнала. Затем, если выполнение программы должно продолжаться, надо 
повторно установить обработчик сигнала с помощью функции Signal, как показано 
в приведенном примере. 
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Функция abort вызывает аварийное завершение программы генерацией сигна- 
ла SIGABRT. Если в приложении не предусмотрен обработчик этого сигнала, TO 
функция abort заносит сообщение «Abnormal program termination» в поток ошибок 
stderr и завершает выполнение программы вызовом _ exit с кодом завершения 3. 


15.6.2 Функции выполнения порождаемых процессов 
exec... и spawn... 


| Функция | Синтаксис /Ommcanme | Pat 


int cwait(int *statloc, int pid, int action); 
Обеспечивает ожидание завершения указанного порож- 
денного процесса, заносит в statloc статус завершения, 


возвращает Ш порожденного процесса или -1 


int execl(char *path, char *аг50, *arg1, ..., *argn, МОТ.) process.h 
Выполняет порожденный процесс path с аргументами 


БИ агЕО - argn 
| int execle(char *path, char *arg0O, *arg1, ..., *argn, process.h 
NULL, char **env 
| Выполняет порожденный процесс path с аргументами 
| argO - argn и с окружением env 
int execlp(char *path, char *arg0,*argl, ..., *argn, process.h 
NULL) 
Выполняет порожденный процесс path с аргументами 
| argO - argn, с поиском в PATH 


execv int execv(char *path, char *argv{]) 
Выполняет порожденный процесс path с аргументами 
argv[] 


int execlpe(char *path, char *arg0, *arg1, ..., *argn, 
NULL, char **env) 


Выполняет порожденный процесс path с аргументами 
аг50 - argn, с поиском в PATH и с окружением env 


| execve int execve(char *path, char *argv[], char **env) process.h 

| Выполняет порожденный процесс path с аргументами 

argv[] и с окружением env 

int execvp(char *path, char *argv[]) 


| spawnl int spawnl(int mode, char *path, char *аг20, arg1, ..., process.h, | 


Выполняет порожденный процесс path с аргументами 
argv[], с поиском в PATH 


int execvpe(char *path, char *argv[], char **env) 


Выполняет порожденный процесс path с аргументами 
argv[], с поиском в PATH и с окружением env 


argn, NULL) stdio.h 


Выполняет в режиме Mode порожденный процесс path с 
аргументами argO - argn 
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ое 


int spawnle(int mode, char *path, char *arg0, argl, . process.h, 


argn, NULL, char *envp[]) stdio.h 


Выполняет в режиме Mode порожденный процесс path с 
аргументами аг20 - argn и с окружением envp 

| spawnve 

spawnvp 


process.h, 
stdio.h 


int spawnlp(int mode, char *path, char *аг20, arg1, 
argn, NULL) 


Выполняет в режиме mode порожденный процесс path с 
аргументами аг50 - argn, с поиском в PATH 


process.h, 
stdio.h 


int spawnlpe(int mode, char *path, char *arg0, argl, 
argn, NULL, char *envp[]) 


Выполняет в режиме mode порожденный процесс path с 
аргументами аг50 - argn, с поиском в PATH и с окру- 
жением епур 


process.h, 
stdio.h 


int spawnv(int mode, char *path, char *argv[]) 


Выполняет в режиме Mode порожденный процесс path с 
аргументами argv | 


process.h, 
stdio.h 


int spawnve(int mode, char *path, char *argv{[], 
char *envpf[]) 


Выполняет в режиме Mode порожденный процесс path с 
аргументами argv[] и с окружением епур 


process.h, 
stdio.h 


int spawnvp(int mode, char “path, char *argv{]) 


Выполняет в режиме mode порожденный процесс path с 
аргументами агйу[], с поиском в PATH 


process.h, 
stdio.h 


e|int spawnvpe(int mode, char *path, char *argvf[], 
char *епур[]) 


Выполняет в режиме mode порожденный процесс path с 
аргументами argv|], с поиском в PATH и с окружением 
епур 


int system(const char *command) stdlib.h 


Выполняет команду Command операционной системы и 

возвращается в приложение 

int wait(int *statloc) 

| Обеспечивает ожидание завершения одного или более | 
порожденных процессов, заносит в Statloc статус завер- 

| шения, возвращает ID порожденного процесса или -1 | 


Комментарии 


Функции exec... загружают в память и выполняют некоторую внешнюю про- 
грамму path, называемую порожденным процессом. Вызванная программа заме- 
щает в памяти вызвавший ее процесс. Таким образом, родительский процесс за- 
вершается и начинается новый. 

Различия между функциями exec... определяются их суффиксами, которые 
обозначают следующее: | 


ИТАК АОН ИРИ РИ LOA BREE EERE ELE, 


] В процесс передается список указателей на аргументы аг50, argl, . 
argn. Обычно используется, если число аргументов заранее известно, 


SOBER AMG IES Hi BE 
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У В процесс передается указатель argv[] на массив указателей на аргумен- 
ты argO, argl, ..., argn. Обычно используется, если число передаваемых 
аргументов может изменяться 


р Файл загружаемой программы ищется в каталогах, указанных в пере- 
менной окружения PATH. Если параметр path не содержит явного указа- 
ния каталога, поиск ведется сначала в текущем каталоге, а затем в ка- 
талогах, указанных в PATH. Если функция не содержит суффикса р, то 
файл ищется только в рабочем каталоге 


е В порождаемый процесс может быть передан аргумент епу, указываю- 
щий на окружение порождаемого процесса. Если функция не содержит 
суффикса e, то порождаемый процесс наследует окружение родительско- 
го процесса. 


Каждая из функций ехес... должна передать в порождаемый процесс хотя бы 
один аргумент (аг=0), и по соглашению этот аргумент — копия path. Впрочем, пе- 
редача другого значения не является ошибкой. Суммарная длина всех аргументов 
(не учитывая нулевых символов, но учитывая пробелы) не должна превышать 128 
символов. 

В функциях с суффиксом | аргументы перечисляются непосредственно в опе- 
раторе вызова функции как указатели на строки с нулевым символом в конце. Ко- 
личество аргументов не ограничено. Последним аргументом передается NULL, что 
является признаком окончания списка. 

В функции с суффиксом у в качестве параметра передается указатель на мас- 
сив произвольной длины, содержащий указатели на строки, являющиеся аргумен- 
тами порождаемого процесса. Последним из указателей в массиве должен быть 
NULL, показывающий, что список аргументов завершился. 

В функции с суффиксом е передается массив указателей епу на строки, опре- 
деляющие переменные окружения порождаемого процесса. Эти строки обычно 
имеют вид 


<имя переменной> = <значение> 


Если env = NULL, то для функций с суффиксом е так же, как и для всех ос- 
тальных функций, порождаемый процесс наследует окружение родительского 
процесса. 

Файлы, открытые на момент вызова порождаемого процесса, остаются откры- 
тыми и для этого процесса. Однако, в порожденный процесс не передается режим, 
в котором отрыты файла (текстовый или двоичный). Если режим отличается от 
принятого по умолчанию, то в порожденном процессе надо произвести его установ- 
ку функциями, рассмотренными в разделах 15.5.2 и 15.5.3. 

Поиск файла path, загружаемого функциями ехес..., осуществляется следую- 
щим образом. Если в параметре path явно указано расширение файла или стоит 
точка, ищется файл такой, который задан. Если же расширение не задано, то сна- 
чала ищется файл такой, который задан. Если он не находится; к имени добавля- 
ется расширение .exe и поиск повторяется. Если файл опять не находится, к имени 
добавляется расширение .com и поиск повторяется. Функции без суффикса р ведут 
поиск файла только в текущем каталоге (если только каталог не задан явно в 
path). А функции с суффиксом р сначала ведут поиск в текущем каталоге, а за- 
тем — в каталогах, указанных в переменной окружения РАТН. 

Все функции возвращают 0 при успешной загрузке порожденного процесса, а 
при ошибке возвращают -1. В этом случае глобальная переменная еггпо (см. раз- 
дел 15.1.5.1) может принимать значения EACCES — нарушение права доступа, 
EMFILE — слишком много открытых файлов, ЕМОЕМТ — не найден путь или 
файл, ЕМОЕХЕС — ошибка формата, ЕМОМЕМ — не хватает памяти. 
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Приведем примеры. Оператор 


if (execl("Fl.exe", "Fl.exe", NULL) ) 
ShowMessage ("Программа Fl.exe не выполнена"); 


завершает текущий процесс и передает управление программе с выполняемым 
файлом Е1.ехе. Этот файл должен быть расположен в рабочем каталоге. Иначе 
функция execl вернет -1 и будет выдано сообщение функцией ShowMessage. Ана- 
логичное сообщение будет выдано если, например, для загрузки Fl.exe не хватает 
оперативной памяти. 

Оператор 


ехес1р ("пс", "пс", NULL); 
передает управление программе Norton Commander (файл пс.ехе), если только 


путь к этой программе указан в переменной окружения РАТН. 
Оператор 


char * prog = “command.com"; 
execlp(prog,prog, NULL); 


передает управление DOS, если только путь к файлу command.com указан в пере- 
менной окружения PATH. 
Оператор 


execlp ("Winword", "Winword","F.doc",NULL) ) 


запускает редактор Word и передает в него файл F.doc. 
Вызов редактора Word можно оформить иначе: 


char *arg[5] = {"Winword"}; // может принять до трех аргументов 
ага [1] = "Fl.doc"; 
arg(2) = “F2.doc"; 


ехесур (arg[0],arg) ; 


В массив arg при его объявлении заносится в качестве нулевого аргумента имя 
программы «Winword>, а остальные четыре элемента массива по умолчанию полу- 
чают значения NULL. После этого в элементы с индексами 1 и 2 заносятся имена 
передаваемых в Word файлов. Следующий элемент остается прежним — NULL. В 
результате функция ехесур передаст управление программе Winword и загрузит в 
редактор два указанных файла. 

Прежде, чем рассматривать функции spawn..., обладающие широкими воз- 
можностями, надо обсудить две вспомогательные функции: смай и wait. 

Функция май обеспечивает ожидание завершения порожденного процесса 
или нескольких процессов. Окончания процессов, запущенных из этих порожден- 
ных процессов с вытеснением родителей функция не ждет. 

Если параметр statloc функции wait He NULL, то он указывает на целое, пред- 
ставляющее собой статус завершения порожденного процесса. При нормальном его 
завершении биты этого целого означают следующее: 


о IE ESAELE REESE EGE SEEGER а о НЯ 


биты 0-7 Нули 


биты 8-15 '‘ Старшие разряды кода возврата порожденного процесса. Это то 
значение, которое передает программа в функцию exit или в опе- 
ратор return функции main. Если порожденный процесс просто 
покинул main без оператора return, то значение этих битов не 
определено 


31] Зак. 322 
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При аварийном завершении порожденного процесса биты его статуса означают: 


о ИИ И вии ИСИ LEER GE ОИ Ик 


биты 0-7 1 неисправимая ошибка. 

у. ps генерация исключения 

3 прерывание внешним сигналом 
биты 8-15 Нули 


При нормальном завершении функция май возвращает идентификатор поро- 
жденного процесса. При неудаче возвращается -1, а переменная еггпо равна 
EINTR — ненормальное завершение процесса, или ECHILD — порожденного про- 
цесса нет. 

Функция смай подобна wait, но дает большую гибкость. Помимо параметра 
statloc, рассмотренного выше она имеет еще два параметра: pid и action. Если па- 
раметр pid задан равным 0, это означает, что происходит ожидание окончания лю- 
бого порожденного процесса. Но в качестве значения pid может быть задан иденти- 
фикатор конкретного порожденного процесса. Тогда происходит ожидание завер- 
шения именно указанного процесса. 

Параметр action может принимать одно из двух значений: WAIT CHILD — 
ожидание . окончания указанного дочернего процесса, или 
WAIT GRANDCHILD — ожидание окончания не только самого порожденного 
процесса, но и всех дочерних процессов, порожденных им. 

Теперь можно рассмотреть функции spawn... . Они подобны рассмотренным 
функциям exec..., но обладают более широкими возможностями благодаря нали- 
чию параметра mode, задающего режим выполнения порождаемого процесса. Этот 
параметр может принимать следующие значения: 


PRISE: АИ: АЯКС а SEO ELE IE EB а а а акр 


P_WAIT Родительский процесс ждет завершения порожденного процесса, 
после чего продолжается выполнение родительского процесса 


P_NOWAIT — Родительский процесс продолжает выполняться пока выполняет- 
ся порожденный процесс. Поскольку функция возвращает ID по- 
рожденного процесса, можно применить функцию смай или wa- 
it, чтобы обеспечить ожидание завершения порожденного процес- 
са. Этот режим недоступен в 16-разрядных Windows и DOS 


P_NOWAITO Идентичен P_NOWAIT, но ID порожденного процесса не сохра- 
няется операционной системой, так что применение функций 
cwait или wait невозможно 


P_DETACH Идентичен P_NOWAITO, но порожденный процесс выполняется 
в фоновом режиме, так что не имеет доступа к клавиатуре и 
дисплею 


P_OVERLAY Порождаемый процесс замещает в памяти родительский. То же, 
что вызов соответствующей функции ехес... 


‚ Приведем пример. Операторы 


if (spawnlp(P МАТТ, "аг)","аг)","е doc.arj al.txt", NULL)) 

5помМеззаде ("Программа аг) не выполнена"); 
else 

{ 
Memol->Clear (); 
Memol->Lines->LoadFromFile("al.txt") ; 
DeleteFile("al.txt"); 
} 
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запускают архиватор arj, извлекающий из архива doc.arj файл al.txt. Приложе- 
ние ждет, пока программа аг] закончит работу, затем загружает разархивирован- 
ный файл в окно редактирования Memol и удаляет этот файл с диска. 

В приведенном примере все аргументы, передаваемые в порождаемый про- 
цесс, объединены в одной строке. Тот же самый результат получился бы, если пе- 
редать их все в отдельности: 


if (spawnlp(P WAIT, "arj",“arj",%e","doc.arj","al.txt", NULL) ) 


Операции, подобные рассмотренным выше, невозможно было бы выполнить 
функциями ехес..., поскольку они не обеспечивают возвращения в исходное при- 
ложение. Нельзя было бы выполнить эти операции и функциями Spawn... при ре- 
жиме, отличном от P_WAIT, поскольку в этом случае оператор загрузки файла в 
окно редактирования выполнялся бы раньше, чем успевал распаковываться ар- 


хив. Впрочем, можно было бы использовать и режим P_NOWAIT, но с добавлени- 
ем функций cwait или wait: 


int ID = зрамп1р(Р_ NOWAIT,"arj","arj","e doc.arj al.txt", 


NULL) ; 

if(ID == -1) 

ShowMessage("IIporpamMma arj не выполнена"); 
else 
{ 

if (wait(NULL) != ID) 

ShowMessage ("Ошибка разархивации"); 
else 


{ 
Memol->Clear (); 
Memol->Lines->LoadFromFile("al.txt"); 
DeleteFile ("al.txt") ; 


} 


В этом коде функция зрамш выполняется в режиме P_NOWAIT, не обеспе- 
чивающем ожидание конца порожденного процесса. Но затем вызывается функ- 
ция wait, которая обеспечивает ожидание. Если эта функция вернет значение, OT- 
личное от идентификатора порожденного процесса, значит при выполнении поро- 
жденного процесса произошло его аварийное завершение. 

Надо отметить, что приведенный выше пример разархивации файла обладает 
двумя недостатками. Первый из них связан с тем, что выполняется программа arj, 
предназначенная для DOS. Поэтому при ее выполнении вызывается сеанс DOS, и 
после его окончания пользователь видит окно DOS, которое ему надо закрыть, что- 
бы продолжить работу. Это, конечно, очень неудобно. Устранить этот недостаток 
легко, например, написанием пакетного файла arj.bat вида: 


@echo off 

arj}.exe e doc %1 

exit 

В нем помимо команда разархивации предусмотрена команда exit — оконча- 
ние сеанса работы с окном DOS. Тогда обращение к разархивации в приложении 
может быть даже короче, чем раньше: 


if (spawnlp(P WAIT, "ar}.bat", "arj.bat","al.txt", NULL) ) 


Обращение к пакетному файлу arj.bat позволяет порожденному процессу ав- 
томатически, без вмешательств пользователя вернуться в родительский процесс. 
Остается еще один недостаток рассмотренного примера — на время выполнения 
разархивации получаются неприятные изменения экрана, связанные с выходом в 
РОБ. Но этот недостаток может быть снят только функциями, рассмотренными в 
разделе 15.6.3. 
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Приведем еще один пример использования функции spawnlp. Пусть вы разра- 
ботали пользовательский интерфейс, в котором хотите предоставить пользователю 
возможность запускать различные приложения. Ваш интерфейс достаточно боль- 
шой и поэтому желательно запускать из него внешние приложения в оверлейном 
режиме. Эту задачу можно решить следующим образом. 

Пусть имя вашего приложения POverlay. Создайте еще одно приложение, на- 
званное, например, OMenage. Это приложение будет управлять запуском требуе- 
мых проврамм. Оно может быть очень маленьким, не содержать ни одной формы и 
располагаться в оперативной памяти одновременно с запускаемыми программами. 
Весь текст его файла следующий: 


#include <vcl.h> 
#pragma hdrstop 
#include <process.h> 
WINAPI WinMain (HINSTANCE, HINSTANCE, LPSTR lpCmdLine, int) 
{ 
spawnlp(P WAIT, 1lpCmdLine,lpCmdLine, NULL); 
spawnlp(P_ OVERLAY, "POverlay.exe","POverlay.exe", NULL); 
return 0; 


} 


Первый вызов функции spawnlp обеспечивает запуск в режиме ожидания того 
приложения, имя которого передано через командную строку IpCmdLine. Второй 
вызов spawnlp обеспечивает оверлэйный вызов вашего основного приложения 
POverlay.exe. 

Предположим, что в вашем основном приложении POverlay имя запускаемой 
программы записано в окне редактирования Editl. Тогда вызов этой программы 
может осуществляться оператором: 

if (spawnlp (Р_ОУЕВГАУ, "ОМепаде.ехе" , "ОМепаде .ехе",Еа1+1->Техе, 

NULL) ) 


ShowMessage("IIporpamma " + Editl->Text + " He выполнена;"+ 
" нет файла OMenage.exe") ; 


Этот оператор прервет выполнение приложения POverlay и загрузит на его ме- 
сто в памяти короткую (примерно 10 К) программу OMenage.exe, передав в нее как 
параметр имя запускаемого приложения. Программа OMenage.exe вызовет в ре- 
жиме ожидания эту программу, а по окончании ее работы удалится из памяти и 
опять вызовет основное приложение POverlay. Таким образом, во время выполне- 
ния вызываемой программы в памяти будет находиться не ваше большое приложе- 
ние POverlay, а только маленькая программа управления OMenage.exe. 

Описанное взаимодействие программ имеет некоторый недостаток: при воз- 
врате в РОуе! ау текст в окне Edit1 будет утерян. Этот недостаток легко устранить. 
Измените основной файл приложения РОуе ау следующим образом: 

#include <vcl.h> 

#pragma hdrstop 

USERES ("POverlay.res"); 

USEFORM ("UOverlayl.cpp", Forml); 

#include "UOverlayl.h" ‹ // включение головного файла приложения 


О вина 
WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR lpCmdLine, int) 
{ 
try 
{ 
Application->Initialize(); 
Application->CreateForm( classid(TForml,), &Forml) ; 
Forml->Editi->Text = lpCmdLine; // Загрузка окна Editi 
Application->Run() ; 
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catch (Exception &exception) 


{ 
} 


return 0; 


Application->ShowException (&exception) ; 


} 


По сравнению CO стандартным файлом, созданным C++Builder, в него добавле- 
но две строки (отмечены комментариями): директива, включающая головной файл 
модуля UOverlayl.h, содержащего описание вашей формы Forml1, и оператор, 3a- 
гружающий в окно Editl текст, переданный через командную строку. Еще одно 
изменение по сравнению со стандартным. файлом — введение в заголовок функции 
WinMain параметра IpCmdLine — ссылки на командную строку. Если в файле 
приложения POverlay сделаны такие изменения, то в приложении OMenage вто- 
рой вызов функции должен быть изменен на следующий: 


spawnlp(P OVERLAY, "POVERLAY.exe", "POVERLAY.exe", lpCmdLine, 
NULL) ; ’ 


Этот вызов отличается от того, что был раньше, передачей в программу той ко- 
мандной строки, которая была задана при вызове OMenage. Таким образом, в про- 
грамму POverlay вернется имя запускавшейся программы, которое будет загруже- 
но в окно Edit1. 

Функция System выполняет команду Command и возвращает управление в вы- 
звавшее приложение. Команда command может быть командой операционной сис- 
темы, командой выполнения программы DOS или пакетного (batch) файла. Про- 
грамма должна быть в текущем каталоге или в одном из каталогов, перечислен- 
ных в переменной окружения РАТН. Команда выполняется командным процессо- 
pom DOS, что вызывает в Windows в ряде случаев неприятное изменение экрана на 
время выполнения команды. Функция system возвращает 0 при успешном начале 
работы командного процессора и -1 в случае неудачи. Приведем примеры: . 


// команда DOS dir с занесением результатов 
// в текстовый файл dir.txt 
+ “system ("dir >> Gir. Cress; 


// команда DOS mkdir, создающая каталог c:\\ttt 
system("mkdir c:\\ttt"); 


// выполнение Norton Commander 
system("nc") ; 


15.6.3 Функции API Windows для запуска из приложения 
внешних программ 


Методика запуска из приложения внешних программ изложена в главе 6 в 
разделе 6.1. Ниже даются справочные сведения по упоминаемым там процедурам 
и функциям API Windows. 


15.6.3.1 Сообщения об ошибках при запуске внешних программ 


Если описанные далее функции возвращают значение меньшее или равное 32, 
это указывает на ошибку. Значения ошибок означают следующее (в Windows 95, 
98, 2000 и МТ для некоторых из этих ошибок имеются именованные константы): 


Значение | Именованная константа | Пояснение 


Системе не хватает памяти, выполняе- 
мый файл испорчен или произошло оши- 
бочное перераспределение памяти. 


fe) 
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Именованная константа | Пояснение 


ERROR_FILE_NOT_ | Файл He найден. 
FOUND | 


SE_ERR_ACCESS- Была попытка динамически связаться с 
DENIED задачей, была ошибка многопроцессорно- 
го выполнения или ошибка защиты сети. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
1 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
|] 
| 


Значение 


— 
> 


_ 
bo 


== 
— 


ERROR BAD FORMAT |Ошибочный выполняемый файл. Или это 
не приложение Windows, или ошибка в 
.ехе файле. 


Приложение спроектировано для другой 
операционной системы. 


Приложение спроектировано для MS-DOS 
4.0. 


Неизвестный тип выполняемого файла. 


| 
| 
Попытка запустить приложение, работа- | 
ющее только на более ранних версиях 


— 
© 


_ 


| 
| 
| 
| 
| 
| 
| 
| 


=" 
Or 


Windows. 


Попытка запустить второй экземпляр 
приложения, содержащего сегменты дан- 
ных, не помеченные «только для чте- 
ния». 


—_ 
© 


Попытка запустить архивированный 
файл. Файл должен быть разархивиро- 
ван, прежде чем его можно будет загру- 
3UTb. 


Ошибочный файл одной из DLL, требуе- 
мой для приложения. 

Приложение требует 32-битного расши- 
рения Windows. 


SE_ERR_SHARE 


SE_ERR_ASSOCIN- Файл, связанный с указанной операцией 
COMPLETE не полный или ошибочный. 


SE_ERR_DDETIMEOUT |Транзакция DDE не может быть выпол- | 
`|нена из-за нехватки времени. 
SE_ERR_DDEFAIL Транзакция DDE закончилась ошибкой 

SE_ERR_DDEBUSY 


bo 
ыы 


21 


—_ 
© 


Транзакция DDE не может быть выполне- 
на, поскольку выполняется другая транзак- 
ция DDE. 


———— ий = 2 - чекенный 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
] 
| 
| 
| 
| 
| 
| 
| 
| 
| 
} 
| 
| 
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31 SE_ERR_NOASSOC Нет приложения, связанного с файлом 


указанного типа, или нет файла, связан- 
ного с указанной операцией. 


15.6.3.2 Функция ShellExecute 


Открывает или печатает указанный файл или открывает указанную папку 
| 


Модуль ShellAPI 


Определение 

HINSTANCE ShellExecute ( 

HWND hwnd, // дескриптор родительского окна 
LPCTSTR lpOperation, // строка выполняемой операции 
LPCTSTR 1рЕ11е, // строка с именем файла или папки 


LPCTSTR lpParameters, // строка параметров` выполняемого файла 

LPCTSTR:lpDirectory, // строка каталога по умолчанию 

INT nShowCmd // режим открытия файла 

); 

Описание 

Функция ShellExecute позволяет выполнить любое приложение Windows. 
Можно также открыть файл документа, что означает выполнение связанного с ним 
приложения и загрузку в него этого документа. Например, обычно с документами, 
имеющими расширение .doc, связан Word. В этом случае открыть файл, напри- 
мер, с именем «ЁПе.4ос» означает запустить Word и передать ему в качестве пара- 
метра имя файла «Ше.4ос». Кроме описанных возможностей функция 
ShellExecute позволяет распечатать указанный файл или открыть указанную пап- 
ку. Последнее означает, что будет запущена программа «Проводник» с открытой 
указанной папкой. 

Параметры функции означают следующее: 


Описание 


| 
Родительское окно, в котором отображаются сообщения запус- | 
каемого приложения. | 
| 


IpOperation | Указывает Ha строку с нулевым символом в конце, которая | 
. определяет выполняемую операцию. Эта строка может содер- | 
жать текст «ореп» (открыть) или «print» (напечатать). Для | 
Windows 95, 98 и МТ определено еще одно значение: «explore» 
(исследовать) — открыть папку. Если параметр 1рОрегайоп ра- 
вен NULL, To по умолчанию выполняется операция «open». 


| 
определяет передаваемые в приложение параметры, если File- | 
Name определяет выполняемый файл. Если IpFile указывает на | 
строку, определяющую открываемый документ, то этот пара- | 
метр задается равным NULL. | 


| lpDirectory Указывает на строку с нулевым символом в конце, которая | 
| определяет каталог по умолчанию. | 
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|nShowCmd Определяет, режим открытия указанного файла. Этот параметр 
может иметь значения: | 
| SW_HIDE Окно делается невидимым и фокус передается 
другому окну | 


| SW_MINIMIZE |Свертывает (минимизирует) указанное окно и 
| активизирует следующее в 7-последовательно- 
| сти окно верхнего уровня в списке системы 


ТРИ SW_MAXIMIZE Развертывает (максимизирует) указанное 
| окно 


SW_RESTORE |Активизирует и отображает окно. Если это 

| окно свернуто или развернуто, то оно восста- 

| навливается до своих первоначальных разме- 
ров и отображается в первоначальной пози- 

| ции (почти то же самое, что 

| SW_SHOWNORMAL) 

| SW_SHOW Активизирует и отображает окно в его теку- 

щей позиции и с текущими размерами 


SW_SHOW- Только для Windows 95, 98, 2000 и NT. Уста- 

DEFAULT навливает состояние в соответствии с флагом 
З\/ _ в структуре STARTUPINFO, передавае- 
мой в функцию CreateProcess программой, 


запускающей приложение. Приложение дол- 
жно вызывать Show Window с этим флагом, 
чтобы задать начальное состояние своего 
главного окна 


SW_SHOW- Активизирует и отображает окно в разверну- 
MAXIMIZED TOM виде (максимизированном) 


SW_SHOW- Активизирует и отображает окно в свернутом 


MINIMIZED виде (в виде пиктограммы) 


Se SW_SHOW- Отображает окно в свернутом виде (в виде 


MINNOACTIVE |пиктограммы). Активным остается то окно, 
которое было активным до этого 


SW_SHOWNA |Отображает окно в его текущей позиции и с 
текущими размерами. Активным остается то 
окно, которое было активным до этого 


SW_SHOW- 


a Отображает окно в его последней позиции и с 
МОАСТТУАТЕ 


последними размерами. Активным остается 
то окно, которое было активным до этого 


SW_SHOW- 
NORMAL 


Активизирует и отображает окно. Если это 
окно свернуто или развернуто, то оно восста- 
навливается до своих первоначальных разме- 
ров и отображается в первоначальной пози- 

ции (почти то же самое, что SW_RESTORE) 


Функция возвращает дескриптор открытого приложения или дескриптор сер- 
вера DDE приложения. Если возвращаемое значение меньше или равно 32, это 
указывает на ошибку. Значения ошибок приведены в таблице раздела 15.6.3.1. 
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Примеры 


/ 
1. Пусть вы хотите открыть файл документа с именем <¢file.doc», т.е. запустить 
Word (обычно именно он связан с файлами .doc), загрузив в него указанный 
файл. Тогда вы можете написать оператор: 


ShellExecute (Handle, NULL, "file.doc",NULL,NULL, SW. RESTORE) ; 


2. Печать документа осуществляется аналогично рассмотренному выше, только 
надо задать соответствующее значение параметра IpOperation: 


ShellExecute (Handle, "print", "file.doc",NULL, NULL, SW_RESTORE) ; 


Выполнение этого оператора будет протекать следующим образом. Запустится 
Word, связанный с файлами .doc, в него загрузится файл «file.doc», затем из 
Word запустится печать с атрибутами по умолчанию, после чего файл 
«file.doc» выгрузится из Word. 


3. Ниже дан пример открытия приложения «Калькулятор»: 
ShellExecute (Handle, "open", "Calc",NULL, МОЬЬ, SW_ ВЕЗТОВЕ); 
4. Следующий пример открывает папку c:\Program Files\Borland: 


ShellExecute (Handle, "open","c:\\Program Files\\Borland", 
NULL, NULL, SW_ RESTORE) ; | 


а оператор 


ShellExecute (Handle, "explore", 
"c:\\Program Files\\Borland", 
NULL, NULL, SW_RESTORE) ; 


открывает программу «Проводник» с открытой папкой ¢:\Program Files\Bor- 
land. 

15.6.3.3 Функция FindExecutable 

Возвращает имя и путь приложения, связанного с указанным файлом 
Модуль ShellAPI 


Определение 

HINSTANCE FindExecutable ( 

LPCTSTR lpFile, // строка с именем файла документа 
LPCTSTR lpDirectory, // строка каталога по умолчанию 
LPTSTR lpResult // строка с именем выполняемого файла 
); j 

Описание 


Функция FindExecutable позволяет получить имя выполняемого файла .exe, 
связанного с файлом, указанным параметром IpFile. Параметр IpDirectory опреде- 
ляет каталог по умолчанию. Оба параметра являются указателями на строки с ну- 
левым символом в конце. Параметр IpResult является указателем на буфер в виде 
строки с нулевым символом в конце, в который функция заносит имя и путь при- 
ложения, связанного с файлом IpFile. 

При успешном завершении функция FindExecutable возвращает значение, 
большее 32. Если возвращено меньшее значение, это свидетельствует об ошибке. 
Значения ошибок приведены в таблице раздела 15.6.3.1. 


Пример 
Операторы 


char APchar[254]; 
FindExecutable ("Doc.doc", NULL, APchar) ; 
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Labell->Caption = APchar; 


приведут к тому, что в метку Labell будет занесено имя приложения, связан- 
ного с файлом типа .doc, например: 


С: \MSOFFICE\WINWORD\WINWORD. EXE 


15.6.3.4 Функция WinExec 
Запускает указанное приложение 


Определение 


UINT WinExec ( 
LPCSTR lpCmdLine, // адрес командной строки 
UINT uCmdShow // режим открытия приложения 
); 
Описание 
Функция WinExec позволяет выполнить указанное приложение. Параметр 
IpCmdLine является указателем на строку с нулевым символом в конце, содержа- 
щую имя выполняемого файла и, если необходимо, параметры командной строки. 
Если имя указано без пути, то Windows ищет выполняемый файл в следующей 
последовательности: 


| 


Каталог, из которого загружено приложение. 
Текущий каталог. 


1. 
2. 
3. Системный каталог Windows, возвращаемый функцией GetSystemDirectory. 
4. Каталог Windows, возвращаемый функцией GetWindowsDirectory. 

5. 


Список каталогов из переменной окружения РАТН. 


Параметр uCmdShow определяет форму представления окна запускаемого 
приложения Windows. Возможные значения этого параметра см. в разде- 
ле 15.6.3.2. Для приложений He Windows, для файлов PIF ит.д. состояние окна оп- 
ределяет само приложение. 

При успешном выполнении запуска приложения функция WinExec возвраща- 
ет значение, большее 31. Если возвращено меньшее значение, это свидетельствует 
об ошибке. Значения ошибок приведены в таблице раздела 15.6.3.1. 

Достоинством функции WinExec является ее совместимость с ранними вер- 
сиями Windows. Собственно для этого она и сохраняется в \/1МЗ2, хотя для Win32 
рекомендуется пользоваться функцией CreateProcess (06 этой функции CM. встро- 
енную в C++Builder справку). 

При работе с Win32 функция WinExec завершает работу, если вызванное при- 
ложение вызывает функцию GetMessage или заканчивается выделенный лимит 
времени. Таким образом, ожидание можно прервать, предусмотрев в процессе, за- 
пущенном с помощью WinExec, в нужный момент вызов функции GetMessage. 


_ Примеры 
Оператор 


WinExec("file.exe", SW RESTORE) ; 


запускает программу Ше.ехе. Оператор 
WinExec ("nc",SW_ ВЕЗТОВЕ); 


запускает Norton Commander. Оператор 
WinExec ("COMMAND.COM", SW_RESTORE) ; 


приводит к запуску MS-DOS. 
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15.7 Функции различного назначения 


15.7.1 Функции динамического распределения памяти 


Функция Синтаксис / Описание 


| size_t _msize(void *block) } 

| Возвращает размер блока с указателем block, вы- 
| деленного ранее функциями malloc, саПос, real- 
| loc; только для 32-разрядных приложений 
|_new_handler | typedef void (*pvf)(); 

| pvf _new_handler 

| Указатель на функцию, вызываемую при невоз- 

| можности выделить память операцией new 


void *alloca(size_t size) | malloc.h 


| 
| Выделяет пространство размером Size в стеке; 
возвращает указатель на него или NULL 


| AllocMem void * AllocMem(Cardinal Size) SysUtils.hpp 
| Динамически выделяет область памяти размером 

| Size байтов и возвращает указатель (void *) на 

| выделенную область; эта область в дальнейшем 

| может быть освобождена процедурой FreeMem 


void *calloc(size_t nitems, size_t size) 

Выделяет память под nitems элементов размером 

Size каждый; возвращает указатель на выделен- | 
ный блок памяти или NULL 


void free(void *block) stdlib.h 

Освобождает блок памяти block, выделенный pa- 

нее функциями Calloc, malloc, геаПос 

void GetMemoryManager( System.hpp 
TMemoryManager &MemMegr) 

Возвращает указатель MemMgr на функции поль- 

зователя, выделяющие и освобождающие память 


| void *malloc(size_t size) stdlib.h или 
Выделяет блок памяти размером Size; возвращает | 
указатель Ha этот блок или NULL 


` геаПос void *realloc(void *block, size_t size) 

| Изменяет размер блока block, выделенного ранее 
| функциями malloc, саПос, геаПос, на size; воз- 

| вращает указатель на выделенный блок памяти 

| или NULL 


| Set_new typedef void (new * new_handler)(); 
| handler new_handler set_new_handler( 
| new_handler my_handler) 


Устанавливает функцию my_handler, которая бу- 
дет вызываться при невозможности выделить па- 
мять операцией new 


———_—_ — = a 
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|Функция Синтаксис / Описание ‘| Файл 


Зе Метогу- |уо14 SetMemoryManager( System.hpp 

| Manager const TMemoryManager &Мет Мог) | 
| Устанавливает параметром MemMgr функции по- | 
| льзователя, выделяющие и освобождающие па- | 


МЯТЬ 


| SysFreeMem extern PACKAGE int SysFreeMem(void * P) System.hpp 
Освобождает память, выделенную под блок с ука- | ИЛи Share- 
Mem.hpp 


зателем Р заказным диспетчером памяти 


 SysGetMem extern PACKAGE void * SysGetMem(int Size) System.hpp 

_| Выделяет блок памяти размером Size, если BBe- чеки orig 

ден заказной диспетчер памяти; возвращает ука- ee 
затель Ha блок или NULL 


| | SysRealloc- extern PACKAGE void * SysReallocMem( System.hpp 
| Mem 7 void * P, int Size) | uuu Share- 


Изменяет размер блока с указателем Р до размера | Mem-hpp 


Size, если введен заказной диспетчер памяти; 
возвращает указатель на блок или NULL 


| THeapStatus System::THeapStatus GetHeapStatus(void) System.hpp 
Заносит информацию о состоянии heap в структу- fee 


Е соя THeapStatus 


Комментарии 

Для функций, в которых в приведенной таблице указано два заголовочных 
файла — System.hpp или ShareMem.hpp, файл System.hpp надо подключать, если 
динамически распределяется глобальная область памяти, а файл ShareMem.hpp 
надо подключать, если динамически распределяется область памяти, которую мо- 
гут совместно использовать различные процессы. | 

Для динамического распределения выделяется специальная область памя- 
ти — пеар. Динамическое распределение памяти в этой области может произво- 
диться несколькими способами: с помощью библиотечных функций malloc, calloc, 
realloc, free или с помощью операций new и delete (см. в главе 12 в разделе 12.9). 

Функция malloc выделяет в heap блок размером в size байтов. В случае успеш- 
ного выделения памяти функция возвращает указатель на выделенный блок. Если 
не хватило места для блока требуемого размера или если size = 0, возвращается 
NULL. 

Другая функция — calloc выделяет память под nitems объектов, размер каж- 
дого из которых равен $12е. Таким образом общий объем выделяемой памяти со- 
ставляет nitems * size. Выделенная память инициализируется нулями. В случае 
успешного выделения памяти функция возвращает указатель на выделенный 
блок. Если не хватило места для блока требуемого размера или если Size = 0 или 
nitems = 0, возвращается NULL. 

Еще одна функция — realloc позволяет изменить размер ранее выделенного 
блока памяти. Она изменяет размер блока в heap, на который указывает block, до 
размера size. При этом предполагается, что block указывает блок памяти, выде- 
ленной ранее функциями malloc, саПос или геаПос. Если же аргумент block задан 
равным NULL, то функция геаПос работает так же, как описанная выше функция 
malloc. 

Если размер size задан равным нулю, TO выделенный ранее блок, на который‘ 
указывает block, освобождается, а функция возвращает NULL. Таким образом, 
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функция с size равным 0 может использоваться не для выделения памяти, а для 
освобождения памяти, выделенной ранее. 

Если блок нового размера не может быть выделен, то нба геаПос возвра- 
щает NULL. Если же память выделилась успешно, то возвращается адрес выделен- 
ного блока. При этом он может отличаться от начального значения block, посколь- 
Ky функция при необходимости осуществляет копирование содержимого блока в 
новое место. 

Функция free освобождает блок памяти, выделенный ранее функциями 
malloc, calloc или realloc, на который указывает block. 

Рассмотрим примеры использования описанных функций. Следующий код 
динамически выделяет функцией malloc память под строку, а затем, после выпол- 
нения с ней каких-то операций, освобождает выделенную память. 

#include <stdio.h> 


#include <alloc.h> 
char *str; 


// str - указатель на строку, под которую выделена память 
str = (char *) ма11ос (100); 


// освобождение памяти 
free(str); 


В этом примере можно было бы использовать для выделения памяти функцию 
calloe: 


str = (char *) calloc(100, sizeof(char)); 


Размер выделенной функциями malloc или calloc памяти можно было бы из- 
менить, например, следующим оператором: 


str = (char *) realloc(str, 20); 


Впрочем, к тому же результату привел бы и более простой оператор: 


realloc(str, 20); 


Необходимо помнить, что рассмотренные функции возвращают NULL (0), 
если память не удалось выделить. Поэтому прежде, чем использовать возвращен- 
ные ими указатели, надо обязательно проверять, не равны ли они NULL. Иначе 
возможно очень тяжелые ошибки при работе программы. 

_new_handler является указателем на функцию, вызываемую при невозмож- 
ности выделить память операцией new. По умолчанию эта функция просто завер- 
шает приложение. Но имеется возможность заменить функцию по умолчанию сво- 
ей функцией. Если происходит возврат из этой функции, то делается повторная 
попытка динамически выделить память. | 

Установка новой функции, на которую указывает _new_handler, производит- 
ся функцией set_new_handler. Вариант этой функции set_new_handler(Q) уста- 
навливает функцию по умолчанию. Собственная функция не получает никаких па- 
раметров и не возвращает никакого значения. Она может выполнять одно из сле- 
дующих действий: 

‚ Ш вернуться после освобождения памяти (тогда будет сделана повторная попыт- 
ка выделить память) 


Ш сгенерировать исключение типа Ба4_аПос или одного из производных от 
bad_alloc классов 


Ш завершить приложение функциями abort или exit 


Функция set_new_handler возвращает указатель на прежнюю функцию. Это 
можно использовать для последующего ее восстановления. Таким образом, вызов 
функции установки может иметь вид: 


руЕ set new handler(pvf р); 
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Функция THeapStatus заносит информацию о состоянии памяти в структуру 
типа THeapStatus, содержащую поля: 


О SEAS SELLER A AE AIA ROIS SRE RE RY RA RRR SRSA SE ch NE ОЕ 


LEER LILLE LEELA LE LOGIE 


TotalAddrSpace Общее текущее адресное пространство в байтах, доступное 
программе. Увеличивается по мере увеличения динамиче- 
ски распределяемой памяти 


TotalUncommitted Общее число байтов в TotalAddrSpace, которое He выделе- 
но для своппируемого файла 


TotalCommitted Общее число байтов в TotalAddrSpace, которое выделено 
для своппируемого файла. Справедливо соотношение Total- 
Uncommitted + TotalCommitted = TotalAddrSpace 


TotalAllocated Объем в байтах динамически выделенной в программе об- 
ласти памяти 


TotalFree Полное число байтов, доступное для программы. Если это 
число превышается и доступно достаточно виртуальной па- 
MATH, то OS увеличивает доступное адресное пространство. 
Соответственно увеличивается и TotalAddrSpace 


FreeSmall Число байтов небольших блоков памяти, которые могут 
быть еще выделены вашей программе 


FreeBig Число байтов больших блоков памяти, которые могут быть 
еще выделены вашей программе. Большие свободные бло- 
ки могут создаваться объединением смежных малых сво- 
бодных блоков или динамическим выделением большого 
блока 


Unused Общее число байтов, которые не могут использоваться про- 
граммой. Справедливо соотношение: Unused + FreeBig + 
FreeSmall = TotalFree 


Overhead ; Число байтов, требуемое диспетчером динамически распре- 
деляемой памяти для управления всеми блоками 


HeapErrorCode Индикатор внутреннего состояния динамически распреде- 
ляемой памяти 


Поля TotalAddrSpace, TotalUncommitted и TotalCommitted относятся к па- 
MATH, выделенной для программы системой. А поля TotalAllocated и TotalFree от- 
носятся к области динамически распределяемой памяти (в дальнейшем для крат- 
кости будем называть ee heap). Так что для проверки возможностей динамического 
выделения памяти надо ориентироваться Ha TotalAllocated и TotalFree. 

Функция SetMemoryManager позволяет пользователю заменить функции, 
выделяющие и освобождающие память, своими собственными. Эти функции поль- 
зователя задаются полями параметра MemMgr типа TMemoryManage. Структура 
типа TMemoryManage имеет поля: 


ИИА RR LEI I EE EOC IER ИИ 


GetMem Указывает 1 на а функцию, выделяющую в памяти блок с заданным 
числом байтов Size и возвращающую указатель на выделенный 
блок (аналог функции malloc). Параметр Size функции GetMem не 
должен быть равен нулю. Если GetMem не может выделить блок 
заданного размера, она должна возвращать NULL 
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ЕгееМет 


Realloc- 
Mem 


Указывает на функцию, освобождающую блок памяти, на который 
указывает ее параметр (аналог функции free). Параметр функции 
FreeMem не должен быть равен NULL. Если FreeMem успешно 
освободила память, она должна возвращать 0. В противном случае 
должно возвращаться. ненулевое значение 


Указывает на функцию, которая изменяет размер блока, на кото- 
рый указавает ее параметр, до заданной новой величины Size (ана- 
лог функции realloc). Указатель, передаваемый в функцию Real- 
locMem, не должен быть равен NULL, а параметр Size не должен 
быть равен 0. Функция ReallocMem должна изменить размер бло- 
ка, при необходимости переместив его на новое место, если нельзя 
обеспечить требуемый размер на прежнем месте. Информация, хра- 
нившаяся в прежнем блоке, должна быть сохранена, но вновь вы- 
деляемое пространство может не инициализироваться. Функция 
должна возвращать указатель на блок или NULL, если изменить 
размер блока невозможно 


Функции пользователя, которые устанавливаются функцией Зе МетогуМа- 
nager, могут оперировать с объектами, их конструкторами и деструкторами, стро- 
ками и т.п. Функция GetMemoryManager возвращает структуру типа ТМетогу- 
Manager, содержащую указатели на установленные функции. Через поля этой 
структуры можно обращаться к установленным функциям. 

Приведем пример. Пусть вы хотите вести учет числа обращений к функциям 
динамического распределения памяти и учет объемов выделяемой и освобождае- 
мой памяти. Это можно сделать следующим кодом: 


#include <malloc.h> 


TMemoryManager* mmNew; 
TMemoryManager* mmOld; 
long alloc, dealloc, Nalloc, Ndealloc; 


void * _fastcall NewGetMem(int Size) 


{ 


alloc += Size; 
Nalloc++; 
return mmOld->GetMem(Size) ; 


} 


int _fastcall NewFreeMem(void *р) 


{ 


dealloc 


= msize(p); 


Ndealloc ++; 
return mmOld->FreeMem (р); 


} 


void * _fastcall NewReallocMem(void *p, int Size) 


{ 


alloc += Size; 


dealloc 


= msize(p); 


Nalloct+t+; 
Ndealloc ++; 
return mmOld->ReallocMem(p, Size); 


} 


__fastcall TForml::TForml (TComponent* Owner) 


{ 


TForm (Owner) 
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mmNew = new. TMemoryManager(); 
mmOld = new TMemoryManager (); 
mmnNew->GetMem = NewGetMem; 
mmNew->FreeMem = МемЕгееМеп; 
mmNew->ReallocMem = NewReallocMem; 
GetMemoryManager (*mmO1q) ; 
SetMemoryManager (*mmNew) ; 


} 


void __fastcall TFormi::ButtonlClick(TObject *Sender) 
{ 
Labell->Caption = "Nalloc = "+IntToStr(Nalloc) + 
» "Ndealloc = "+IntToStr(Ndealloc)+ 
" выделено " +IntToStr(alloc) 
" освобождено " +IntToStr(dealloc); 


} 


В этом примере при щелчке на кнопке Ви Йоп] в метке Labell отображается 
сообщение о динамическом распределении памяти. 


15.7.2 Функции вызова диалоговых окон с сообщениями 


15.7.2.1 Процедуры ShowMessage и ShowMessageFmt 


В приложениях часто приходится отображать различные простые диалоговые 
окна, чтобы дать пользователю какие-то указания или задать несложный вопрос, 
на который возможен один из стандартных ответов: да, нет, отменить, прервать. В 
законченном приложении желательно эти окна проектировать самому, обеспечи- 
вая единство стиля всех окон приложения, русские надписи на кнопках и т.п. Но 
при разработке прототипа будущего проекта и в процессе отладки удобно пользо- 
ваться готовыми диалоговыми окнами и вызывающими их процедурами. 

Простейшей из таких процедур является ShowMessage, отображающая окно 
сообщения с кнопкой ОК. Ее объявление: 


void ShowMessage(const System:;:AnsiString Msg) 


Текст сообщения задается параметром Msg. Заголовок окна совпадает с име- 
нем выполняемого файла приложения. 

Имеется также похожая процедура ShowMessageF mt, позволяющая выводить 
в аналогичное окно форматированное сообщение. Объявление этой процедуры име- 
ет вид: 


void ShowMessageFmt (const System::AnsiString Msg, 
const System::TVarRec *Params, const int Params Size) 


Параметр Msg в этой процедуре задает строку описания формата (см. раз- 
дел 15.1.4.3), а параметры Params и Params_Size задают массив параметров, фор- 
матируемых строкой Msg, и размер этого массива. Для передачи массива в функ- 
цию удобно использовать макрос OPENARRAY (см. раздел 15.7.4). Тогда вызов 
функции ShowMessageFmt имеет вид: 


ShowMessageFmt (Msg, OPENARRAY (TVarRec, (argl,arg2,...))); 
Приведем примеры использования этих процедур. 
5ПпомМеззасе ("Работа приложения успешно завершена."); 
ShowMessageFmt ("Задано %d параметров из %а ", 

OPENARRAY (TVarRec, (N1,N2))); 


На рис. 15.2 а показано окно, создаваемое первым из этих операторов, a на 
рис. 7.1 6 — вторым при М1 = 5, N2 = 7. Еще один пример окна с несколькими 
строками табулированного текста вы можете увидеть на рис. 15.1 в разделе 15.1.3. 
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Рис. 15.2. a) 
Сообщения, выдаваемые 
функциями ShowMessage (а) 

и ShowMessageFmt (6) 


15.7.2.2 Функции MessageDlig, MessageDligPos и CreateMessageDialog 


Рассмотренные в разделе 15.7.2.1 процедуры отображают окна, в которых 
пользователь, прочтя текст, должен просто нажать ОК. Следующие функции OTO- 
бражают окна, в которых пользователю задается какой-то вопрос и анализируется 
полученный ответ. Основная из этих функций — Меззаве я. Она объявлена сле- 
дующим образом: 

int MessageDlg(const System::AnsiString Msg, 

TMsgDlgType DlgType, 
TMsgDlgButtons Buttons, int HelpCtx) 

Вызов MessageDlg отображает диалоговое окно и ожидает ответа пользовате- 
ля. Сообщение в окне задается параметром функции Msg. 

Вид отображаемого окна задается параметром DigType. Возможные значения 
этого параметра: 


| Значение Описание | 


mtConfirmation Окно подтверждения, содержащее зеленый вопроситель- 
ный знак (см. рис. 15.3 a) 


mtInformation Информационное окно, содержащее голубой символ <i» 
(см. рис. 15.3 6) 


Окно ошибок, содержащее красный стоп-сигнал (см. 
рис. 15.3 в) 
mt Warning Окно замечаний, содержащее желтый восклицательный 
| знак (см. рис. 15.3 г) 


Заказное окно без рисунка. Заголовок соответствует име- 


Рис. 15.3. 

Примеры диалоговых 
окон, выводимых 
функциями MessageDlig 
и MessageDlgPos 
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Параметр AButtons определяет, какие кнопки будут присутствовать в окне. 
} 
Тип TMsgDligBtns параметра AButtons является множеством, которое включает 
различные кнопки. Возможные значения видов кнопок: 


р 
_mbNo 


Кнопка с надписью «Cancel» 


Кнопка с надписью «Нер» 


Кнопка с надписью «Abort» 


Кнопка с надписью «Retry» 


| _mblIgnore Кнопка с надписью «Ignore» 


| ЪАП _| Кнопка с надписью. «All» — 


Необходимые кнопки заносятся в Buttons операцией «<<», поскольку пара- 
метр Buttons является множеством. Если не занести в этот параметр ничего, в 
окне не будет ни одной кнопки и пользователю придется закрывать окно систем- 
ными кнопками Windows. 

Кроме множества значений, соответетвующих отдельным кнопкам, определе- 
ны три константы, соответствующие множествам часто используемых сочетаний 
кнопок: 


_| Включает в окно кнопки Abort, Retry и Ignore 


Эти предопределенные множества имеют тип TMsgDigButtons и могут непо- 
средственно включаться в вызов функции вместо параметра Buttons. 

Параметр HelpCtx определяет экран контекстной справки, соответствующий 
данному диалоговому окну. Этот экран справки будет появляться при нажатии 
пользователем клавиши Fl. Если вы справку не планируете, при вызове 
MessageDlg надо задать нулевое значение параметра HelpCtx. 

Функция MessageDlg возвращает значение, соответствующее выбранной 
пользователем кнопке. Возможные возвращаемые значения: 


mrNone mrAbort ’ mrYes 
mrOk mrRetry mrNo 
mrCancel mrignore mrAll 


Приведем примеры использования функции MessageDlg. Первый пример ил- 
люстрирует диалог при окончании работы приложения: 


if (MessageDlg ("Действительно хотите закончить приложение?", 
mtConfirmation, TMsgDlgButtons() << mbYes<< mbNo, 0) == mrYes) 
{ 
MessageDlg("Pa6oTa приложение закончена", mtInformation, 
TMsgDlgButtons() << mbOK, 0); 
Close(); 
} 
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Первый вызов MessageDlg приводит к отображению окна типа mtConfir- 
mation с вопросом о завершении приложения (см. рис. 15.3 а). Если пользователь. 
нажимает кнопку Yes, то выводится второе окно типа mtInformation с сообщением 
о завершении (см. рис. 15.3 6). 

Следующий пример иллюстрирует диалог при генерации исключения (см. 
рис. 15.3 ви 15.3 г): 


catch: -(-- st F 

{ 

MessageDlg("Mpousouna ошибка.", mtError, TMsgDlgButtons() << mbOK, 0); 
MessageDlg("BynbTe внимательнее.", mtWarning, 


TMsgDlgButtons() << mbOK, 0); 
} 


Следующий пример иллюстрирует работу с базой данных, когда после редак- 
тирования пользователем записи ему предлагается вопрос о сохранении ее в базе 
данных (см. рис. 15.3 д). Если пользователь выбирает кнопку Yes, запись сохраня- 
ется методом Post; если пользователь выбирает кнопку Мо, результаты редактиро- 
вания уничтожаются методом Cancel; если же пользователь выбирает кнопку 
Cancel, форма закрывается. 


switch (MessageDlg("GBRDZbP HBVPZh > ;??", mtCustom, mbYesNoCancel, 0)) 

{ 

case mrYes: Tablel->Post(); 
break; 

case mrNo : Tablel->Cancel(); 
break; 

case mrCancel : Close(); 


} 


Имеется также функция MessageDlgPos, во всем подобная MessageDlg, но 
отображающая диалоговое окно сообщений в заданном месте экрана. Объявление 
этой функции: | 

int MessageDlgPos(const System::AnsiString Msg, 


TMsgDlgType DligType, TMsgDlgButtons Buttons, 
пе DSL pce, зах. THC x) 


Вызов MessageDlgPos отображает диалоговое окно в заданном месте экрана и 
ожидает ответа пользователя. Координаты определяются параметрами Х и У. Oc- 
тальные параметры тождественны функции MessageDlg. Например, оператор 


MessageDlgPos ("Будьте внимательнее.", mtWarning, 
_TMsgDigButtons() << прок, 0, 250, 0); 


вызовет появление окна сообщения вверху экрана (параметр У=0) примерно в цен- 
тре. А оператор | 
MessageDlgPos ("Ошибка в этом окне!", mtError, 


TMsgDlgButtons() << прок, 0, 
BoundsRect.Left, BoundsRect.Bottom) ; 


отобразит диалоговое окно вблизи нижнего левого угла формы, в которой записан 
данный оператор. 
Функция CreateMessageDialog, определенная следующим образом: 
extern PACKAGE Forms::TForm* CreateMessageDialog ( 
const System::AnsiString Msg, TMsgDlgType DlgType, 
TMsgDlgButtons Buttons) 


позволяет создать диалоговое окно сообщения в виде объекта формы. Функция TO- 
лько создает окно, но не отображает его. Отображение осуществляется обычными 
для форм методами Show или ShowModal. При использовании метода ShowModal 
можно анализировать ответ пользователя так же, как это делается для любых мо- 
дальных форм. 
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Использованные для задания типа диалога DigType и кнопок окна Buttons 
типы данных ТМ$ Туре и ТМ50]ВиЙоп$ были описаны выше. 

Функцию CreateMessageDialog имеет смысл применять для создания диало- 
гового окна, которое будет использоваться в приложении многократно. При этом 
преимуществом этого окна по сравнению с теми, которые создавались ранее рас- 
смотренными функциями, заключается в том, что вы можете задать русскую над- 
пись в заголовке окна, как делаете это для любой формы. В то же время существен- 
ным недостатком применения функции CreateMessageDialog является то, что объ- 
ект диалогового окна хранится в памяти все время, пока он не будет уничтожен 
явно методом Егее. Это приводит к непроизводительным затратам памяти. 

Приведем пример использования CreateMessageDialog. Операторы 


ТРогм *FMess; 


FMess = СгеафеМеззадер1а1од ("Будьте внимательнее.", mtWarning, 


TMsgDlgButtons() << прок); 
FMess->Caption = "Предупреждение"; 


создают объект FMess диалогового окна, задают текст его сообщения и заголовок 
«Предупреждение». Вид этого окна (рис. 15.4) идентичен приведенному ранее на 
рис. 15.3 г, за исключением заголовка «Предупреждение» вместо непонятного не 
слишком опытному пользователю заголовка «Warning». Оператор 


FMess->ShowModal () ; 
отображает окно как модальную форму. Оператор 


FMess->Free(); 


уничтожает объект, после чего окно уже не сможет отображаться. 


Рис. 15.4. | Предупреждени 


Окно, созданное функцией CreateMessageDialog 


15.7.2.3 Функция TApplication->MessageBox 


Основным недостатком рассмотренных в разделах 15.7.11.1 и 15.7.11.2 функ- 
ций и процедур являлось отсутствие русификации диалоговых окон (английские 
надписи на кнопках) и невозможность указать текст заголовка окна (кроме функ- 
ции CreateMessageDialog). Эти недостатки позволяет устранить метод Message- 
Вох переменной Application типа TApplication, доступной в любом приложении 
C++Builder. Поскольку это метод компонента, он выходит за рамки тематики этой 
главы. Но поскольку тематически этот метод очень близок рассмотренным выше 
функциям, обсудим его в данном разделе. 

Метод объявлен следующим образом: 


int _fastcall MessageBox(const char * Text, 
const char * Caption, int Flags); 


Он отображает диалоговое окно с заданными кнопками, сообщением и заго- 
ловком и позволяет проанализировать ответ пользователя. Во многих отношениях 
это окно подобно окнам, создаваемым функциями MessageDlg и CreateMessage- 
Dialog. Но имеются и существенные отличия, связанные с возможностью русифи- 
кации окна: Заголовок окна может быть написан по-русски, что отличает эту 
функцию от функции MessageDlg (впрочем, в окне, созданном CreateMessage- 
Dialog, это тоже можно сделать). Другим приятным отличием являются русские 
надписи на кнопках (в русифицированных версиях Windows). 
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Функция MessageBox инкапсулирует функцию MessageBox API Windows. 
Параметр Text представляет собой текст сообщения, которое может превышать 
255 символов. Для длинных сообщений осуществляется автоматический перенос 
текста. Параметр Caption представляет собой текст заголовка окна. Он тоже может 
превышать 255 символов, но не переносится. Так что длинный заголовок приводит 
к появлению длинного и не очень красивого диалогового окна. 

Параметр Flags представляет собой множество флагов, определяющих вид и 
поведение диалогового окна. Этот параметр может комбинироваться операцией 
сложения по одному флагу из следующих групп. 


Флаги кнопок, отображаемых в диалоговом окне 


М 


Значение (в скобках даны надписи в русифи- 

цированных версиях Windows) 

B_ABORTRETRYIGNORE |Кнопки Abort (Стоп), Retry (Повтор) и Ignore (Про- 
пустить). 


М о eae Кнопка ОК. Этот флаг принят по умолчанию. 
МВ_ОКСАМСЕГ, Кнопки ОК и Cancel (Отмена). 
MB_RETRYCANCEL | Кнопки Retry (Повтор) и Cancel (Отмена). 


МВ_УЕЗМО Кнопки Yes (Да) и No (Нет) 
MB_YESNOCANCEL Кнопки Yes (Да), № (Нет) и Cancel (Отмена) 


| 
| 
| 
| 
| 


Флаги пиктограмм в диалоговом окне 


Пиктограмма 
MB_ICONEXCLAMATION, Восклицательный знак 
MB_ICONWARNING ‚ | (замечание, предупреждение). 
MB_ICONINFORMATION, Буква i в круге (подтверждение). 
MB_ICONASTERISK 


MB_ICONQUESTION 


MB_ICONSTOP, MB_ICONERROR, |Знак креста на красном круге 
И рек ока 


о 


Флаги, указывающие кнопку по умолчанию 
(которая в первый момент находится в фокусе) 
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| ‚ 


Флаги модальности 


@xar |Шояснение | | 
| 


| MB APPLMODAL Пользователь должен ответить на запрос, прежде чем 

| сможет продолжить работу с приложением. Ho он мо- 
жет перейти в окна другого приложения. Он может так- 
же работать со всплывающими окнами данного прило- 

жения. Этот флаг принят по умолчанию. 


| 
|| 


| 


|MB_SYSTEMMODAL | To же самое, что MB_APPLMODAL, но окно диалога 

| отображается в стиле \$_ЕХ_ТОРМОБЗТ, то есть все- 
гда остается поверх других окон, даже если пользова- 
тель перешел к другим приложениям. Используется 
для предупреждения о серьезных ошибках, требующих 


немедленного вмешательства. 


лаг 


Флаг | Пояснение 


| MB_HELP | Добавляет в окно кнопку Нер (Справка), щелчок на которой 
| или нажатие клавиши [Е] генерирует событие Help. 


| 
| 


Возможны еще некоторые флаги, определяющие характер поведения окна при 
работе в сети нескольких пользователей, позволяющие отображать тексты справа 
налево (для восточных языков) и т.п. 

Функция возвращает нуль, если не хватает памяти для создания диалогового 
окна. Если же функция выполнена успешно, то возвращаемая величина свиде- 
тельствует о следующем: / 


| Значение 
| IDABORT 
| 


IDIGNORE Выбрана кнопка Ignore (Пропустить) 
IDNO 
Sl a eS aah li Bcc 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


ЕАН 


Рассмотрим пример. Ниже приведен текст, предусматривающий проверку 
правильности ввода данных перед пересылкой записи в базу данных. 


if (проверка введенных данных) 
{ 
if (Application->MessageBox ( 

"Хотите занести текущую запись в базу данных?", 

"Подтвердите занесение в базу данных", 

МВ _YESNOCANCEL + МВ ICONQUESTION) != IDYES) 
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{ 
DataSet->Cancel (); 
АБогС (); 
} 
} 
else 
{ 


Application->MessageBox ("Ошибочные данные", "Ошибка", 
МВ ICONSTOP) ; 
Abort (); 


} 


Отображаемые этим кодом окна приведены на рис. 15.5. Безусловно они более 
удачны, чем приведенные в предыдущих разделах, за счет русификации. 


Рис. 15.5. И Подтвердите 
Диалоговые окна, >. 
отображаемые 
функцией Application-> 
MessageBox 


15.7.2.4 Функции InputBox и InputQuery 


Функции, описанные в этом разделе, предлагают пользователю диалоговое 
окно, в котором он должен ввести в окошко редактирования некоторый текст. 
Этим они прежде всего отличаются от функций, рассмотренных в предыдущих 
разделах, поскольку в тех функциях реакция пользователя сводилась к нажатию 
какой-то из кнопок. 

Функция InputBox объявлена в модуле Dialogs следующим образом: 

extern PACKAGE AnsiString _ fastcall InputBox ( 

const AnsiString ACaption, 


const AnsiString APrompt, 
const AnsiString ADefault); 


Она предлагает пользователю диалоговое окно (см. рис. 15.6) с заголовком 
ACaption, с предложением APrompt пользователю что-то написать и с окошком 
редактирования, в котором предварительно загружено начальное значение текста 
ADefault. Если пользователь нажмет в окне OK, то функция вернет введенную им 
строку текста. Если же пользователь в диалоге нажал Cancel, или нажал Esc, или 
закрыл окно системной кнопкой, то функция вернет строку ADefault, даже если 
перед этим пользователь что-то написал в окошке редактирования. 

Например, оператор 


AnsiString Name = Тпро®Вох ("Пожалуйста, представьтесь", 
"Укажите, как в дальнейшем обращаться к Вам", 
"Неизвестный"); 


отобразит окно, представленное на рис. 15.6, и вернет текст введенный пользовате- 
лем, или строку «Неизвестный». Еще один пи использования InputBox при- 
веден в разделе 15.7.2.5. 


Рис. 15.6. 7 редставьтес 
Окно, отображаемое функцией InputBox 


Неизвестный 
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Понять по возвращенному результату, написал ли пользователь какой-то 
текст, или отказался от ввода, можно, сравнив возвращенный результат со значе- 
нием ADefault. Впрочем, результат останется неизменным и в случае, если поль- 
зователь ничего не написал в диалоге, но нажал кнопку ОК. Если надо достоверно 
знать, отказался ли пользователь от диалога, или нажал ОК, следует использовать 
похожую на InputBox функцию InputQuery: 

extern PACKAGE bool _ fastcall InputQuery ( 

const AnsiString ACaption, 
const AnsiString APrompt, 
AnsiString &Value); 


Смысл параметров ACaption и APrompt тот же, что в функции InputBox. Па- 
pametp Value — это строка текста в окошке редактирования. Вы можете присво- 
ить ей начальное значение, а после вызова InputQuery в параметре Value будет Ha- 
ходиться ответ пользователя. | 

Функция InputQuery возвращает true только в том случае, если пользователь 
вышел из диалога, нажав ОК. В остальных случаях (при нажатии Е5с, при щелчке 
на системной кнопке окна или на кнопке Cancel) возвращается false, а значение 
параметра Value сохраняется тем, какое было до обращения к InputQuery. 

Например, операторы: 

AnsiString Name = "Неизвестный"; 

if(! InputQuery("Noxanyucra, ‘представьтесь", | 

"Укажите, как в дальнейшем обращаться к Вам", Name) ) 


ShowMessage ("Вы не представились, господин Неизвестный"); 
else ShowMessage ("Здравствуйте, господин "+Namet+" !"); 


отобразят окно, представленное на рис. 15.6 и после окончания диалога выдадут 
сообщение, зависящее от того, нажал ли пользователь в диалоге ОК, или нет. 


15.7.2.5 Функция SelectDirectory 


Функция SelectDirectory предоставляет пользователю возможность указать в 
стандартном диалоге каталог. Функция объявлена в модуле FileCtrl и имеет две 
перегруженных формы. Первая форма: 

extern PACKAGE bool _fastcall SelectDirectory ( 

const AnsiString Caption, 


const WideString Root, 
AnsiString &Directory) ; 


Функция вызывает стандартный диалог Windows для поиска каталога (пап- 
ки) — см. примеры на рис. 15.7. Параметр Caption содержит строку, отображае- 
мую в диалоге как указание пользователю (текст «Укажите каталог установки 
программы» на рис. 15.7. Параметр Root задает корневой каталог, внутри которо- 
го пользователь может выбирать подкаталоги. За пределы каталога Root пользова- 
тель выйти не может. При вызове SelectDirectory в примере рис. 15.7 а указано 
Root = «d:\\». Если указать вместо Root пустую строку или отсутствующий на 
компьютере каталог, то в диалоговом окне отобразится дерево всех папок 
(рис. 15.7 6) и пользователь имеет возможность выбрать на любом диске любой ка- 
талог. 

Выходной параметр Directory содержит результат выбора пользователя. 
Функция возвращает true, если пользователь выбрал каталог и нажал ОК. Если 
пользователь нажал Отмена или закрыл каталог, не произведя выбора, то функция, 
возвращает false. 

Рассмотрим пример. Пусть вы делаете программу установки вашего приложе- 
ния и хотите, чтобы пользователь указал каталог, в котором надо установить про- 
грамму. Соответствующий диалог можно оформить следующим образом: 
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#include <FileCtrl.hpp> 
AnsiString Dir; 


if (SelectDirectory("YkaxuTe каталог установки программы", 
р. Dir) ) 
Dir = InputBox("MoxetTe уточнить каталог", 
"Программа расположится в каталоге:", 
Dir): 
else 
{ 
Application->MessageBox("Bsl не указали каталог", 
"Установка прерывана !", 
MB ICONSTOP) ; 
Application->Terminate() ; 
er 


В этом примере вызов функции SelectDirectory приводит к появлению окна, 
представленного на рис. 15.7 6, поскольку параметр Root указан пустой строкой. 
Если пользователь выбрал каталог и нажал OK, то SelectDirectory возвращает 
true. В этом случае пользователю предлагается диалоговое окно, вызываемое 
функцией шри Вох (см. раздел 15.7.2.4). Оно показано на рис. 15.8 а. В этом окне 
пользователь может, если хочет, уточнить каталог. Если же пользователь в окне 


Рис. 15.7. < OGsop папок 
Диалоговое окно поиска каталога при > 
заданном (а) и не заданном (6) значении Root 


Ен (0: 
# Г] Ath 
#24 ©55 
(J 0 
2] Database 
49) Dbaccess 
>) Dbibase 
£9 Dbpar 
i 2) Dbpar2 
EY Базе 
‘i t) Msdospar 


LO Ariens. 


6) 


Рабочий стол 
=) 2 Мой компьютер 


3-25 Диск 3,5 (А:] 
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Рис. 15.8. a) 
Продолжение диалога 
выбора каталога 


рис. 15.7 6 не выбрал каталог, то функцией Application.MessageBox вызывается 
окно, показанное на рис. 15.8 6, и установка прерывается. 
Функция SelectDirectory имеет еще вторую форму: 
enum TSelectDirOpt { sdAllowCreate, 
sdPerformCreate, sdPrompt }; 


typedef Set<TSelectDirOpt, sdAllowCreate, sdPrompt> 
TSelectDirOpts; 


extern PACKAGE bool __fastcall SelectDirectory ( 
AnsiString &Directory, 
TSelectDirOpts Options, 
int HelpCtx); 


Эта форма вызова функции предоставляет более гибкий диалог (рис. 15.9). Bos- 
вращаемое значение по-прежнему указывает, выбрал ли пользователь каталог. Па- 
раметр Directory, как и раньше, содержит выбранный пользователем каталог. Если 
перед вызовом SelectDirectory задано начальное значение Directory, то именно этот 
каталог будет раскрыт в окне диалога в первый момент времени. Параметр HelpCtx 
является ссылкой на контекстную справку, содержащую подсказку по действиям 
пользователя. А параметр Options является множеством следующих опций: 


ИИ ; SOR IEE: 


sdAllowCreate В диалоговом окне отображается окошко редактирования Di- 
rectory Мате (см. рис. 15.9), в котором пользователь может 
написать каталог, который отсутствует. Эта опция не созда- 
ет сам каталог. Это задача приложения, которое прочтет 
имя каталога и при необходимости создаст его 


яя: Я 


sdPerformCreate Применяется только в сочетании с sdAllowCreate и обеспе- 
чивает создание каталога, если указанный пользователем ка- 
талог отсутствует 


sdPrompt Применяется только в сочетании с sdAllowCreate. Если по- 
льзователь указал несуществующий каталог, ему предлага- 
ется вопрос, надо ли его создавать. Если пользователь отве- 
TH утвердительно (нажал ОК) и опция sdPerformCreate 
включена в множество Options, то каталог будет создан. 
Если же опция sdPerformCreate не задана, то приложение 
должно само создать нужный каталог 


Если множество Options пустое, то пользователь не может указать каталог, 
которого не существует. 

Если применить эту форму функции SelectDirectory в приведенном выше при- 
мере, то начало кода может иметь вид: 


#include <FileCtrl.hpp> 
AnsiString Dir = "d:\\"; 


if (SelectDirectory(Dir, TSelectDirOpts() << sdAllowCreate 
<< sdPerformCreate << sdPrompt, 0)) 
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Рис. 15.9. 


Вторая форма диалога выбора Direc 
каталога _JDADATABASE 


Diecones “4 


С) Currency 
С) OBACCESS 
С) DBIBASE 

| С) DBPAR 

| С) DBPAR2 


В этом коде задается начальное значение каталога и в параметр Options вклю- 
чены все опции: sdAllowCreate, sdPerformCreate и sdPrompt. Вызываемое диало- 
говое окно подобно приведенному на рис. 15.9, но не будет иметь кнопки Help, по- 
скольку идентификатор контекстной справки задан равным нулю. 

Если пользователь напишет в окошке редактирования Directory Мате каталог, 
который отсутствует в дереве, ему будет предложено окно запроса, показанное на 
рис. 15.10. Если пользователь нажмет в нем Мо, то вернется в окно рис. 15.9. Если 
же он нажмет Yes, то отсутствующий каталог будет создан. 


Рис. 15.10. 
Запрос создания отсутствующего каталога 


Как видно, вторая форма функции SelectDirectory дает дополнительную гиб- 
кость диалогу. Но она имеет существенный недостаток: окна рис. 15.7 и 15.9 со-. 
держат английские тексты. От окна запроса на создание каталога (рис. 15.10) без- 
условно лучше отказаться. Если допустимо создание нового каталога без дополни- 
тельного запроса, то следует задавать Options равным [54АПомСгеафе, 
sdPerformCreate]. Если же запрос все-таки нужен, то лучше задать Options рав- 
ным [sdAllowCreate], а запрос и создание каталога обеспечить программно с помо- 
щью ранее рассмотренных средств. Так что от английского окна запроса избавить- 
ся несложно. Но санглийскими надписями в основном диалоговом окне (рис. 15.9) 
сделать ничего невозможно. 


15.7.2.6 Диалоги доступа к данным — функции LoginDialog 
и LoginDialogEx 


Имеются две функции — LoginDialog и LoginDialogEx, вызывающие стан- 
дартные окна Windows, содержащие запрос имени и пароля пользователя для дос- 
тупа к базам данных (см. рис. 15.11). Объявление функции LoginDialog в файле 
Dblogdlg имеет вид: 

extern PACKAGE bool _ fastcall LoginDialog ( 

const AnsiString ADatabaseName, 


AnsiString &AUserName, 
AnsiString &APassword) ; 


Параметр ADatabaseName является строкой, содержащей имя базы данных, с 
которой требуется соединиться. Параметр AUserName — строка, содержащая имя 
пользователя. При вызове функции LoginDialog в этот параметр можно записать 
имя пользователя по умолчанию и оно будет отображаться в диалоге в окошке User 
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Мате (см. рис. 15.11). А по окончании диалога в параметре AUserName содержит- 
ся имя, указанное пользователем, или имя по умолчанию, если пользователь его 
не изменял. Параметр APassword — строка, содержащая пароль, введенный поль- 
зователем в процессе диалога. 

Функция LoginDialog возвращает true, если пользователь завершил диалог, 
щелкнув в нем на кнопке ОК. В этом случае программа может пытаться открыть 
базу данных с указанными именем и паролем пользователя или предварительно 
проверить, зарегистрирован ли такой пользователь, правильный ли указан пароль 
и какой уровень доступа разрешен этому пользователю. Если пользователь пре- 
рвал диалог, то возвращается false. 


Рис. 15.11. 
Запрос пароля функцией LoginDialog 


Пример использования функции LoginDialog: 
#include <Dblogdlg.hpp> 


AnsiString DatabaseName = "BCDEMOS", 
UserName = "Иванов", Password; 
if(! LoginDialog (DatabaseName, UserName, Password) ) 
ShowMessage ("Вы не указали имя и пароль!"); 
else 


В диалоговом окне, отображаемом функцией LoginDialog, пользователь мо- 
жет изменять имя, указываемое в окошке User Мате. Другая функция LoginDia- 
logEx — позволяет запретить изменение имени. Объявление этой функции имеет 
вид: 

extern PACKAGE bool _fastcall LoginDialogEx ( 

const AnsiString ADatabaseName, 
AnsiString &AUserName, 


AnsiString &APassword, 
bool NameReadOnly) ; 


`Отличие от функции LoginDialog заключается только в параметре NameRead- 
Only. Если положить его равным true, то изменение имени пользователем окажется 
невозможным. Само диалоговое окно при этом не будет отличаться от приведенного 
на рис. 15.11. Только окошко User Name, в котором по-прежнему будет отображать- 
ся указанное параметром AUserName имя, окажется недоступным для изменений. 

Существенным недостатком рассмотренных функций LoginDialog и LoginDia- 
logEx являются нерусифицированные диалоговые окна. Так что в большинстве 
приложений вряд ли стоит использовать эти функции. Окно, подобное рис. 15.11, 
очень легко создать самому, причем с русскими надписями. 


15.7.3 Функции воспроизведения звуков 


| Веер extern PACKAGE void Beep(void) SysUtils.hpp | 
| Функция C++Builder, воспроизводит стандартный | 
a звуковой сигнал | ze | 
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Функция Синтаксис / описание Файл | 


BOOL Beep(DWORD 4мЕгеч, 
DWORD dwDuration); 


Функция API Windows, только для Windows NT, 
воспроизводит звуковой сигнал с частотой dwFreq 
Герц и длительностью dwDuration миллисекунд 


| MessageBeep | BOOL MessageBeep(UINT uType); 


Функция API Windows, воспроизводит звуковой 
сигнал типа uType 


| PlaySound BOOL PlaySound(LPCSTR pszSound, mmsys- 
| HMODULE hmod, DWORD fdwSound) | tem.hpp 
| Функция API Windows, воспроизводит звук ука- 

| занного волнового файла, или звука системного 


| события, или звука из ресурса 


| 
| 
| 


Комментарии 

Функция C++Builder Веер воспроизводит стандартный звуковой сигнал, вызы- 
вая функцию MessageBeep API Windows с нулевым параметром. При этом воспроиз- 
водится стандартный звуковой сигнал, установленный в Windows, если компьютер 
имеет звуковую карту и стандартный сигнал задан (он устанавливается в «Панели 
управления» после щелчка на пиктограмме Звук). Если звуковой карты нет или стан- 
дартный сигнал не установлен, звук воспроизводится через динамик компьютера. 

Воспроизведение асинхронное, т.е. приложение продолжает выполняться во 
время воспроизведения звука. 

Функция Веер API Windows, примененная в Windows МТ, синхронно воспро- 
изводит звук простого тона через динамик и не возвращается до окончания звука. . 
В Windows МТ параметр dwFreq задает частоту звука в герцах. Он может иметь 
значения в диапазоне от 37 до 32,767 (от 0x25 до Ox7FFF). Параметр dwDuration 
устанавливает длительность звука в миллисекундах. 

Воспроизведение синхронное: функция не возвращается до окончания воспро- 
изведения звука. 

Все сказанное относится только к Windows МТ. В Windows 95 и 98 параметры 
игнорируются и функция становится подобной функции Веер C++Builder. Отли- 
чие этих функций остается только в том, что Beep C++Builder ничего не возвраща- 
ет, а Веер API Windows при успешном выполнении возвращает ненулевое значе- 
ние. При аварийном завершении она возвращает нуль. Тогда более развернутую 
информацию об ошибке можно получить вызовом функции GetLastError (см. раз- 
дел 15.7.5). 

Компилятор автоматически разбирается, какая именно из функций Веер ис- 
пользована в программе, по наличию или отсутствию параметров. 

Функция MessageBeep воспроизводит звуковой сигнал указанного типа. Зву- 
ки асоответствующие различным типам сигналов, хранятся в реестре в разделе 
[sounds] и устанавливаются пользователем с помощью программы «Панель управ- 
ления» щелчком на пиктограмме Звук. 

Целый без знака параметр uType функции MessageBeep определяет воспроиз- 
водимый звук. Для него предопределены следующие константы: 


Значение 
OxFFFFFFFF 
|MB_ICONASTERISK ___ 
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ХАОС СООО ССОО СООО СООО ОСД СООО ДО ООО ан ананивниннийни ЖЕНЕ TROPEZ 
— 
| MB_ICONEXCLAMATION 


| MB_ICONHAND 
MBICONQUESTION — 
т oe alta gg 852 yr 


При успешном завершении функция возвращает ненулевое значение (true). 
Если функция вернула нулевое значение, то получить информацию oO ошибке 
можно с помощью вызова GetLastError (см. раздел 15.7.5). 

После инициализации воспроизведения звука функция MessageBeep возвраща- 
ет управление в точку вызова и воспроизведение звука производится асинхронно. 

Если функция MessageBeep не нашла указанный тип звука, она пытается BOC- 
произвести стандартный звук. Если и он не установлен или если компьютер не 
снабжен звуковой картой, то звук воспроизводится через динамик компьютера. 

Функция PlaySound API Windows воспроизводит звук указанного волнового 
файла, или звука системного события, или звука из ресурса. 

Параметр pszSound представляет собой строку с нулевым символом в конце и 
определяет воспроизводимый звук. В зависимости от значений флага fdwSound 
(SND_FILENAME, SND_ALIAS или SND_RESOURCE) параметр pszSound мо- 
жет определять имя волнового файла, псевдоним системного события или иденти- 
фикатор ресурса. Если ни один из этих флагов не указан, функция ищет в реестре 
Windows или в файле У/М.1М указанное имя звука. Если звук найден, TO OH вос- 
производится. Если звук не найден, то параметр pszSound интерпретируется как 
имя файла. 

Звук, указанный параметром pszSound, должен помещаться в доступную па- 
мять и должен подходить для установленного драйвера устройства воспроизведе- 
ния волновых файлов. Функция PlaySound ищет файл звука в следующих катало- 
гах: текущем, каталоге Windows, системном каталоге Windows, каталогах, пере- 
численных в переменной среды РАТН, в списке каталогов, предоставляемых се- 
тью. Более подробно последовательность поиска в каталогах рассмотрена в доку- 
ментации по функции ОрепЕ Пе. 

Если указанный звук не находится, функция PlaySound воспроизводит сис- 
темный звук по умолчанию. Если функция не может найти и его, то воспроизведе- 
ния не будет, а вернется значение false. 

Если параметр pszSound задан равным 0, то воспроизведение любого волново- 
го файла прерывается. Для прерывания воспроизведения звука, не связанного с 
волновым файлом, надо указывать SND PURGE в параметре fdwSound. 

Параметр hmod используется только при параметре fdwSound равном 
SND_RESOURCE. В этом случае hmod является дескриптором выполняемого фай- 
ла, содержащего ресурс, который должен загружаться. В противном случае значе- 
ние hmod задается равным 0. 

Параметр fdwSound задает флаги воспроизведения звука. Флаги могут комби- 
нироваться друг с другом операцией ИЛИ «|». Возможны следующие значения 
флагов: 


о о В В О О а о В ВЫ сы 


SND_ALIAS Параметр pszSound определяет псевдоним системного 
события в реестре Windows или в файле WIN.INI. Нель- 
зя использовать совместно с SND_ FILENAME и 
SND_RESOURCE 


SND_ALIAS ID Параметр szSound является предопределенным иденти- 
фикатором звука 
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SND_APPLICATION Звук воспроизводится с использованием установок при- 
ложения 


SND_ASYNC Звук воспроизводится асинхронно и функция PlaySo- 
und возвращается немедленно после начала воспроизве- 
дения. Чтобы прекратить асинхронное воспроизведение 
волнового файла, надо вызвать PlaySound с парамет- 
pom pszSound, равным 0 


SND_FILENAME Параметр pszSound является именем файла 


SND_LOOP Воспроизведение звука постоянно повторяется, пока не 
вызовется PlaySound с параметром pszSound, равным 
0. Одновременно надо указать флаг SND ASYNC асин- 
хронного воспроизведения звука : 


SND_MEMORY Файл звука события загружен в память. В этом случае 
параметр pszSound должен указывать на образ звука в 
памяти 


SND_NODEFAULT Звук события, кроме звука по умолчанию. Если yKa- 
занный звук не найден, PlaySound вернется, He воспро- 
изводя звук по умолчанию 


SND_NOSTOP Если заданный звук не может быть воспроизведен, по- 
скольку ресурсы, необходимые для воспроизведения, 
заняты воспроизведением другого звука, функция Play- 
Sound немедленно вернет false, He воспроизводя задан- 
ного звука. Если данный флаг не указан, функция Pla- 
ySound пытается остановить воспроизведение другого 
звука, чтобы устройство могло быть использовано для 
воспроизведения нового звука 


SND_NOWAIT Если драйвер занят, функция сразу вернется без вос- 
произведения заданного звука 


SND_PURGE Останавливается воспроизведение любых звуков, вы- 
званных в данной задаче. Если pszSound не 0, останав- 
ливаются все экземпляры указанного звука. Если 
pszSound равен 0, то останавливаются все звуки, свя- 
занные с данной задачей. Отдельно надо указать деск- 
риптор для остановки событий SND RESOURCE 


SND_RESOURCE Параметр pszSound является идентификатором pecyp- 
са. Параметр hmod должен указывать на источник ре- 


сурса - : 


SND_SYNC Синхронное воспроизведение звука события. Функция 
PlaySound возврацкается только после окончания вос- 
произведения 


Функция PlaySound при успешном выполнении возвращает true, в противном 
случае — false. 

Примеры использования функции PlaySound приведены в главе 5 в разде- 
ле 5.2.1. 
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15.7.4 Некоторые вспомогательные функции С++ и C++Builder 


| Функция ____ Сиитаксис / Оиание 


ARRAYSIZE | ARRAYSIZE(const void *a) sysdefs.h 
| Макрос возвращает число элементов массива а 


| bsearch void *bsearch(const void *key, 

| const void *base, size_t nelem, size_t width, 
| int ( USERENTRY *fcmp) 

| (const void *, const void *)) 

| Выполняет двоичный поиск по ключу key в мас- 

| сиве (таблице) base из nelem элементов по width 
Роя байт каждый с помощью функции femp; возвра- 

| щает адрес элемента или O 


| EXISTING- EXISTINGARRAY(const void *a) 


ARRAY Макрос возвращает индекс последнего элемента 


| массива a 


sysdefs.h 


getenv char *getenv(const char *name) stdlib.h 


3 
| Возвращает или удаляет переменную окружения 
пате 


extern PACKAGE System::AnsiString 
GetLongHint(const System::AnsiString Hint) 


Возвращает вторую часть строки формата, 
используемого в свойствах компонентов Hint 


| 
| 


| GetLongHint 


/GetShortHint | extern PACKAGE System::AnsiString 

| GetShortHint(const System::AnsiString Hint) 
| Возвращает первую часть строки формата, 

| используемого в свойствах компонентов Hint 


| void *Ifind(const void *key, const void *base, 

| size_t *num, size_t width, 

: int ( USERENTRY *femp) 

| (const void *, const void *)) 

| Выполняет линейный поиск по ключу key в мас- 

| сиве (таблице) Базе из num записей по width байт 
| в каждый с помощью функции femp; возвращает 
| адрес элемента или O — 


| lsearch void *Isearch(const void *key, void *base, 
| size_t *num, size_t width, 
| int(_USERENTRY * стр) 
| (const void *, const void *)) 


Controls.hpp 


Controls.hpp 


Выполняет линейный поиск по ключу key в мас- 
| элемент не найден, он добавляется в таблицу; 
sysdefs.h 
Макрос обеспечивает передачу в функцию откры- 


сиве (таблице) base из num записей по width 
| возвращает адрес элемента 
| OPENARRAY 
| того массива, содержащего до 19 элементов 


| 
| 
| 
| 
| 


| 
| 
| 


байт в каждый с помощью функции femp; если 
OPENARRAY(type агё1, ..., type arg19) 


< 
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[Функция [Синтаксис /Onmeamme [я 


`РагатСоип& |ежеги PACKAGE int __fastcall 
| | ParamCount(void); 
| Возвращает число параметров командной строки 
|ParamStr extern PACKAGE AnsiString __fastcall System.hpp 
| ParamStr(int Index); 
| Возвращает параметр с индексом Index команд- 
ной строки | 
| puteny int putenv(const char *name) 
Устанавливает переменную окружения пате 
void qsort(void *base, size_t nelem, size_t width, | stdlib.h 
int ( USERENTRY *fcemp) 
(const void *, const void *)) | 
Выполняет быструю сортировку в массиве (табли- 
це) base из nelem элементов по width байт каж- 
| дый с помощью функции femp 
| ShortCut extern PACKAGE TShortCut ShortCut( Menus.hpp 
Word Key, Classes::TShiftState Shift) 
| Создает структуру, используемую для задания 
| комбинации «горячих» клавиш Key и Shift раз- 
| делу меню : 
'ShortCutTo- | extern PACKAGE System::AnsiString See 


Text ShortCutToText(TShortCut ShortCut) 
stdlib.h 


Преобразует структуру ShortCut, содержащую 
Menus.hpp 


комбинацию «горячих» клавиш раздела меню, в 

строку текста 
stdarg.h 

stdarg.h 


void swab(char *from, char *to, int nbytes) 
Копирует nbytes байтов строки from в строку to, 
меняя местами каждую пару смежных байтов 


extern PACKAGE TShortCut TextToShortCut( 
System::AnsiString Text) 


Создает из строки текста Text структуру, исполь- 
зуемую для задания комбинации «горячих» кла- 
виш разделу меню 


type va_arg(va_list ар, type) 


Макрос возвращает текущий аргумент списка пе- 
ременной длины типа фуре и переводит указатель 
ар на следующий аргумент; предварительно ука- 
затель должен быть установлен с помощью 

va_start или va_arg 


void va_end(va_list ap) 


Макрос обеспечивает завершение передачи в фун- 
кцию списка аргументов произвольной длины, 
обработанного макросами va_start и va_arg 


void va_start(va_list ар, lastfix) 
Макрос устанавливает ар на первую переменную, 


передаваемую в функции, использующие списки ар- 
| гументов произвольной длины; lastfix — последний 
переданный в функцию обязательный аргумент 


a2 ик 972 
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Комментарии 

Макросы уа_зфаг&, va_arg и va_end позволяют создавать функции, в которые 
передаются списки аргументов неопределенной длины. Иногда в функции требует- 
ся передавать некоторое число фиксированных параметров плюс неопределенное 
число дополнительных параметров. В этом случае заголовок функции имеет вид: 


тип имя функции (список аргументов, ...) 


В данном случае список аргументов включает в себя. конечное число обяза- 
тельных аргументов (этот список не может быть пустым), после которого ставится 
многоточие на месте неопределенного числа параметров. Для работы с этими пара- 
метрами в файле stdarg. m определены три макроса: va_start, va_arg, va_end и тип 
списка va_list. 

Макрос va_start начинает работу со списком, устанавливая его указатель ap 
на первый передаваемый в функцию аргумент из списка с неопределенным числом 
аргументов. Параметр 1а$ 1х — это имя последнего из обязательных аргументов 
функции. 

Макрос va_arg возвращает значение очередного аргумента из списка. Пара- 
метр type указывает тип аргумента. Перед вызовом уа_агй значение ар должно 
быть установлено вызовом va_Start или va_arg. Каждый вызов Va_arg переводит 
указатель ар на следующий аргумент. 

Макрос va_end завершает работу со списком, освобождая память. Он должен 
вызываться после того, как с помощью прочитан уа_аг весь список аргументов. В 
противном случае могут быть непредсказуемые последствия. 

Примеры использования всех этих макросов см в главе 12 в разделе 12.5.5. 

Макросы EXISTINGARRAY, ARRAYSIZE, OPENARRAY используются при 
передаче в функции массивов. Описание способов работы с этими макросами см. в 
главе 13 в разделе 13.10.3. Примеры использования макросов приведены также в 
разделе 15.3.1.2. 

Функции bsearch, 14119, lsearch, qsort предназначены для поиска и сортиров- 
ки в массивах (таблицах). Во всех этих функциях параметр base указывает на на- 
чало массива, параметр nelem или num определяет число элементов, параметр 
width определяет число байтов, занимаемых элементом, а параметр femp указыва- 
ет на функцию сравнения, которую вы должны определить и которая сигнализи- 
рует о результатах сравнения двух элементов, заданных своими указателями. 

Функция bsearch осуществляет двоичный поиск (дихотомию) элемента, COOT- 
ветствующего ключу Кеу. Подобный поиск самый быстрый, но он требует, чтобы 
элементы массива были расположены в порядке возрастания критерия поиска. 
Функция сравнения femp в данном случае получает как параметры два указателя: 
*eleml и *е]ет2. Функция должна провести сравнение значений, на которые они 
указывают, и вернуть результат сравнения: 


я 


о а а а ОВ о я 


< 0 при *elem1 < *elem2 
== 0 при *elem1 == *elem2 
>0 при *eleml > *elem2 


Здесь знак < означает, что элемент *elem1 расположен в массиве раньше эле- 
мента *elem2, знак > означает, что элемент *е]ет1 расположен в массиве после 
элемента *elem2, а знак равенства означает, что элементы равны. Эта оговорка су- 
щественна, поскольку элементами могут быть не только числа, но и объекты любо- 
го типа, например, записи со множеством полей. 

Функция Qgsort выполняет быструю сортировку массива по критерию, задан- 
ному функцией сравнения. Сама функция сравнения используется такая же, как 
описанная выше. 
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Ниже приведен пример использования функций qsort и bsearch. В примере 
объявлен массив array неупорядоченных целых чисел. Функция femp — это функ- 
ция сравнения, одинаковая для qsort и bsearch. При щелчке на кнопке Buttonl 
массив сначала упорядочивается функцией 450г%$, а затем в нем ищется с помощью 
bsearch элемент, соответствующий указанному пользователем в окне Editl. 


#include <malloc.h> 
#include <stdlib.h> 


int arrayt]'.=. (800,125,512, 627, 933,145}; 


int Естр (const void *pl, const void *p2) 
{: return (*4int*}pl: > (int?) p2)3. + 


void _fastcall TForml::ButtonlClick(TObject *Sender) 
{ 

int key = StrToInt (Editl->Text) ; 

int *elem; 

qsort (array, ARRAYSIZE(array),sizeof(int), fcmp); 


elem = (int *) bsearch (&key, array, ARRAYSIZE(array), 
sizeof(int), femp); 
if(elem == 0) ЗПомМеззасде ("Элемент " + IntToStr(key) + 


" Не найден"); 
else 5ПомМеззасче ("Индекс элемента " + IntToStr(*elem) + 
" равен " + IntToStr(elem- аггау)); 
} 


Функции Ifind и Isearch выполняют в массиве линейный поиск. OH медлен- 
нее, чем дихотомия, но может применяться к неупорядоченным массивам. Функ- 
ции различаются тем, что Isearch, если элемент не обнаружен, добавляет его в ко- 
нец массива. Функции поиска в Ifind и Isearch отличаются от рассмотренных 
выше. Они должны возвращать нуль при совпадении элементов и ненулевое значе- 
ние, если элементы различны. 

Ниже приведен пример использования функции Isearch, похожий на рассмот- 
ренный ранее. В примере объявлен массив аггау неупорядоченных целых чисел. 
Функция #етр1 — это функция сравнения. При щелчке на кнопке Button! в мас- 
сиве ищется элемент, соответствующий указанному пользователем в окне Editl. 
Если элемент не найден, он добавляется в конец массива. 

#include <malloc.h> 

#include <stdlib.h> 

int аггау[10] = {800,123,512,627, 933,145}; 

unsigned Narray = 6; 


int fcmpl (const void *pl, const void *p2) 
{ return (* (int*)pl 1=.* (int*)p2Z) 7. } 


void _fastcall TForml::Button1Click(TObject *Sender) 
{ 
int key = StrTolInt (Editl->Text) ; 
int *elem; 
elem = (int *) lsearch (&key, array, &Narray, 
Ssizeof(int), Естр1); 
ShowMessage ("Индекс элемента " + IntToStr(key) + 
" равен " + IntToStr(elem- array) ); 


} 


Функции GetShortHint и GetLongHint возвращают соответственно первую и 
вторую части строки формата 


<текст первой части>|<текст второй части> 
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Строки такого вида, в частности, задаются в свойстве компонентов Hint (см. в 
главе 16 и в главе 4 раздел 4.1.9). 

Функции getenv и рщепу позволяют работать с переменными окружения. Пере- 
менные окружения представляют собой строки таблицы параметров окружения в виде 
name=string\0. Функция getenv ищет или удаляет указанную переменную окружения 
name. Если в функции getenv задать имя переменной окружения, она вернет указа- 
тель на строку, содержащую значение этой переменной. Например, оператор 


Labell->Caption = getenv ("РАТН"); 


отображает в метке Labell содержание строки переменной PATH. 
Имена переменных DOS и OS/2 должны записываться в верхнем регистре. Ос- 
тальные переменные могут записываться как в верхнем, так и в нижнем регистрах. 
Если переменная окружения с этим именем отсутствует, то возвращается 
NULL. Если в функции getenv задать параметр name в виде Name=', то перемен- 
ная name будет удалена из окружения. Например, оператор 


getenv ("РАТН="); 


очистит переменную РАТН. 
Функция рщепу устанавливает переменную окружения. Параметр паше зада- 
ется в виде “name=string’. Например: 


putenv ("PATH=c:\\temp") ; 


Функции ShortCut, ShortCutToText и TextToShortCut используются для за- 
дания свойства ShortCut раздела меню, определяющего соответствующую этому 
разделу комбинацию «горячих» клавиш. Функция ShortCut упаковывает пара- 
метр Key, определяющий виртуальный код клавиши, и параметр Shift, задающий 
комбинацию вспомогательных клавиш типа Shift, Ctrl и Alt, в значение типа 
TShortCut, эквивалентное типу Word. Функция TextToShortCut создает анало- 
гичное значение из строки текста. Функция ShortCut выполняется быстрее, но 
зато функцию TextToShortCut удобнее использовать в диалоге, когда комбинацию 
«горячих» клавиш задает пользователь с помощью окна редактирования. 

Функция ShortCutToText позволяет получить текстовое описание значения 
ShortCut типа TShortCut. Эту функцию удобно использовать для вывода пользо- 
вателю принятой в разделе меню комбинации «горячих» клавиш, если ему предос- 
тавляется возможность изменять эту комбинацию. 

Рассмотрим примеры использования этих трех функций. Оператор 


MOpen->ShortCut = ShortCut('O', TShiftState() << ssCtrl); 


задает разделу меню с именем МОреп «горячие» клавиши Ctrl-O. Оператор 
MOpen->ShortCut = ShortCut('0O',TShiftState ()<<ssCtrl<<ssAlt) ; 


задает тому же разделу комбинацию Ctrl-Alt-O. 

Еще один пример. Приведенные ниже процедуры обеспечивают задание поль- 
зователем комбинации «горячих» клавиш для раздела меню, названного в про- 
грамме Open. Первая процедура с помощью ShortCutToText задает начальное зна- 
чение текста в окне редактирования, равное исходной комбинации клавиш. А BTO- 
рая — с помощью функции TextToShortCut изменяет комбинацию на заданную 
пользователем. Пользователь может задать, например, комбинацию Ctrl-O или как 
«^О», или как «Ctrl+O>. 


void _fastcall TForml::ButtonlClick(TObject *Sender) 
ore aes: = ShortCutToText (MOpen->ShortCut); 
Rant renee 

void _fastcall TForml::Button2Click(TObject *Sender) 
‘Mopen->shor Cut = TextToShortCut (Editl->Text) ; 
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Функции ParamStr и ParamCount позволяют работать с командной строкой. 
Функции ParamStr возвращает параметр командной строки с указанным индек- 
com Index. Нулевым параметром командной строки является имя выполняемого 
файла приложения вместе с полным путем к нему. Таким образом, выражение 
ParamStr(0) вернет, например, строку «О:\\ТЕЗТ\\РКОЗЕСТ1Т.ЕХЕ», т.е. имя 
файла, приведенное к верхнему регистру. Из этого имени можно извлечь путь к 
выполняемому файлу. Это очень часто требуется, если программа использует ка- 
кие-то другие файлы, расположенные в том же каталоге, в котором располагается 
выполняемый файл. 

Если при запуске приложения в него через командную строку переданы ка- 
кие-то параметры, то эти параметры могут быть прочитаны соответственно выра- 
жениями ParamStr(1), ParamStr(2) ит.п. При этом регистр параметров будет тем, 
который использован при запуске программы. Так что при чтении параметров же- 
лательно программно приводить их к верхнему или нижнему регистрам. 

Функция ParamCount возвращает число параметров, переданных через ко- 
мандную строку. Она позволяет организовывать циклы по параметрам командной 
строки. Например, код 

for (int i=1;i<=ParamCount () ;i++) 

if (LowerCase(ParamStr(i)) == "-е") 


обеспечивает выполнение некоторых действий (обозначены многоточием), если 
среди параметров командной строки встретится «-е» или «-Е». 

Следует отметить, что в файле объявлена переменная CmdLine типа (char *). 
Эта переменная содержит полный текст командной строки, в котором параметры 
отделены друг от друга пробелами. Регистр всех параметров в строке CmdLine, 
включая нулевой, соответствует тому, который использовался при запуске прило- 
жения на выполнение. Еще один альтернативный способ работы с командной стро- 
кой рассмотрен в главе 1 в разделе 1.5.3. 


15.7.5 Некоторые вспомогательные функции API Windows 


Синтаксис / описание 

BOOL Close Window(HWND hWnd) 

| Window Сворачивает, не уничтожая, окно, указанное дескриптором hWnd 
BOOL Оезгоу\ тдом(Н\М/ МО hWnd) 


Уничтожает окно, указанное дескриптором hWnd, и всех его потом- 
ков, освобождает отведенную память 


| Епа]е- |BOOL EnableWindow(HWND hWnd, BOOL bEnable) ) 
Window | Делает доступным (при ЪЕпаЫе = true) или недоступным (при bE- 


па е = false) окно, указанное дескриптором hWnd 


| Find- HWND FindWindow(LPCTSTR IpClassName, 
| Window LPCTSTR IpWindowName) 
Возвращает дескриптор окна класса IpClassName с заголовком 
| lp WindowName 


HWND GetNext Window(HWND hWnd, UINT wCmd) 
Возвращает дескриптор следующего за hWnd или предыдущего 
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Функция Синтаксис / описание 


Get- HWND GetWindow(HWND hWnd, UINT wCmd) 


Window |Возвращает дескриптор окна, находящегося с указанным окном 


hWnd в указанном соотношении “Сша 


|Get Win- . | шё GetWindowText(HWND hWnd, LPTSTR IpString, 
dowText int nMaxCount) 


Копирует текст, связанный с окном или оконным элементом hWnd, 
в буфер IpString размера nMaxCount 


Комментарии 

Все приведенные в таблице функции API Windows используют для идентифи- 
кации окна, к которому применяется функция, дескриптор hWnd. Для получение 
этого дескриптора можно использовать функцию FindWindow. Функция возвра- 
щает дескриптор окна верхнего уровня, класс и имя которого указаны; функция 
не ищет дочерние окна. 

Параметр IpClassName указывает на строку с нулевым конечным символом, 
содержащую имя класса, или является атомом, указывающим на строку с именем 
класса. Если этот параметр атом, то это должен быть глобальный атом, созданный 
предварительно вызовом функции GlobalAddAtom. Атом является 16-битной ве- 
личиной, которая должна помещаться в младшие разряды слова уставе ат, а 
старшие разряды должны быть нулевыми. 

Параметр IpWindowName указывает на строку с нулевым конечным симво- 
лом, содержащую имя окна (это свойство Caption формы, отображаемое в строке 
заголовка окна). Если этот параметр равен NULL, то считается, что под критерий 
поиска подходит любое окно указанного класса. 

Если поиск прошел успешно, то функция Find Window возвращает дескриптор 
окна, имеющего указанное имя класса и имя окна. В противном случае возвраща- 
ется NULL. 

Другой способ найти дескриптор окна — воспользоваться функцией GetNext- 
Window. Она определяет дескриптор следующего или предыдущего окна в 7-после- 
довательности. Параметр hWnd — дескриптор окна, от которого начинается отсчет. 
Параметр wCmd определяет направление поиска. Если wOmd = GW_HWNDNEXT, 
то ищется следующее окно, находящееся ниже. Если wOmd = GW_HWNDPREYV, то 
ищется предыдущее окно, находящееся выше. | 

Следующее окно в Й-последовательности — это то, которое вызывалось из ука- 
занного или к которому пользователь обращался после создания указанного окна. 
Если указано дочернее окно, то поиск ведется среди дочерних окон. 

Если искомое окно найдено, то возвращается его дескриптор. Если следующе- 
го или предыдущего окна нет (в зависимости от значения WCmd), то возвращается 
0. Развернутую информацию 06 ошибке можно получить вызовом функции Get- 
LastError. 

Примеры использования функций FindWindow и GetNext Window см. в гла- 
ве 6 в разделе 6.2.1. 

Использование функции GetNextWindow дает тот же самый результат, что и 
вызов функции GetWindow со значениями параметра GW_HWNDNEXT или 
GW_HWNDPREV. Функция Get Window обладает более широкими возможностя- 
ми, позволяя определять дескриптор окна, находящегося с указанным окном 
hWnd в указанном соотношении (по 7й-последовательности или по последователь- 
ности владельцев). Параметр этой фуцкции uCmd определяет соотношения родст- 
ва и может принимать значения: 
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GW_CHILD Определяется дескриптор дочернего окна Ha вершине 7-по- 
следовательности, если указано родительское окно. В против- 
ном случае возвращается дескриптор NULL. Проверяются 
только дочерние окна указанного окна, но не его потомков 


GW_HWNDFIRST Определяется дескриптор окна того же типа, находящегося 
вверху /-последовательности 


GW_HWNDLAST Определяется дескриптор окна того же типа, находящегося 
внизу 7-последовательности 


GW_HWNDNEXT Определяется дескриптор следующего окна в 7-последова- 
тельности 


GW_HWNDPREV Определяется дескриптор предыдущего окна в 7-последова- 
тельности 


GW_OWNER Определяется дескриптор окна, являющегося владельцем 
указанного 


Если окно найдено, то возвращается его дескриптор. Если требуемого окна не 
существует, то возвращается 0. Развернутую информацию об ошибке можно полу- 
чить вызовом функции GetLastError. 

Функция GetWindowText копирует текст, связанный с указанным окном 
(отображаемый в его полосе заголовка) или оконным элементом с дескриптором 
hWnd, в буфер IpString размера nMaxCount. Если число символов в тексте превы- 
шает эту величину, текст усекается. 

Функция посылает указанному окну или элементу, указанному в ее вызове, 
сообщение Windows WM_GETTEXT. Она не может воспринять текст окна редак- 
тирования из другого приложения. 

Если функция выполнилась успешно, она возвращает число скопированных 
символов, исключая завершающий нулевой символ. Если окно не имеет полосы за- 
головка или текст заголовка отсутствует, или при неверном дескрипторе возвра- 
щается нуль. Развернутую информацию 0б ошибке можно получить вызовом 
функции GetLastError. 

Пример использования функци GetWindowText см. в главе 6 в разделе 6.2.1. 

Мы рассмотрели возможности определения дескриптора окна. Но если окно, к 
которому обращается та или иная функция — это то окно, в модуле которого со- 
держится ее вызов, то в качестве дескриптора можно подставлять Handle. Напри- 
мер, оператор 


CloseWindow (Handle) ; 


сворачивает данное окно. 

При успешном выполнении большинство описанных функций возвращают не- 
нулевое значение. При аварийном завершении возвращается нуль. Тогда более раз- 
вернутую информацию об ошибке можно получить вызовом функции GetLastError. 

Функция GetLastError возвращает значение кода последней ошибки данного по- 
тока. Эти коды индивидуальны для каждого потока и другие потоки их не изменяют. 

Функция GetLastError должна вызываться сразу после возврата функции, 
ошибку которой вы хотите проверить. Это связано с тем, что некоторые функции 
вызывают при своем успешном завершении SetLastError(0), что уничтожает код 
ошибки. 

Большинство функций API Win32 устанавливают код последней ошибки при 
аварийном завершении, хотя некоторые устанавливают этот код в случае успешно- 
го выполнения. Обычно функции задают такие коды, как FALSE, NULL, 
OxFFFFFFFF или -1. 
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Код ошибки — 32-битовое значение. Наиболее значимый бит 31. Бит 29 зарезер- 
вирован для кода, определяемого приложением. В системных кодах этот бит не ис- 
пользуется. Таким образом, этот бит показывает, что код был определен приложени- 
ем. Это гарантирует отсутствие пересечения между вашими и системными кодами. 

Чтобы получить строку сообщения об ошибке по коду, используйте функцию 
FormatMessage. Полный список кодов ошибок имеется в заголовочном файле 
WINNT.H в Win32 SDK. 

Функция EnableWindow делает указанное окно доступным или недоступным 
для любых действий пользователя с помощью мыши или клавиатуры. Если окно 
недоступно, то предусмотренные в нем процессы продолжаются, но пользователь 
не может воздействовать на это окно. Функция возвращает нуль, если окно было 
до этого доступным, и ненулевое значение, если оно не было доступным. 


15.8 Сообщения Windows 


15.8.1 Некоторые функции, константы и типы АР! Windows, 
используемые при работе с сообщениями 


Работа с сообщениями Windows рассмотрена в главе 6 в разделе 6.3. Ниже 
приводятся справочные сведения по функциям, которые использовались в главе 6. 


15.8.1.1 Функция PostMessage 


Функция помещает указанное в ней сообщение окну или множеству окон в 
очередь сообщений потока, создавшего эти окна, и возвращается, не дожидаясь 
окончания обработки этого сообщения 


Объявление 
BOOL PostMessage ( 
HWND hWnd, // дескриптор окна, 
// которому передается сообщение 
UINT Msg, // сообщение 


WBARAM. wParam, // первый параметр сообщения 
LPARAM ]1Рагам // второй параметр сообщения 
); 
Параметры 
Параметр hWnd — дескриптор окна, которому передается сообщение. Если 
этот параметр равен HWND BROADCAST, то сообщение передается всем окнам 
верхнего уровня в системе, включая недоступные, невидимые, перекрытые други- 
ми и всплывающие, за исключением дочерних окон. Если этот параметр NULL, то 
сообщение ставится в очередь сообщений (если она есть) текущего процесса. 
Параметр Msg определяет передаваемое сообщение. Параметры wParam и 1Ра- 
гат могут содержать дополнительную информацию. 


Возвращаемое значение 

Функция возвращает ненулевое значение при успешном завершении и нуль 
при аварийном завершении. В этом случае причину ошибки можно установить вы- 
зовом функции GetLastError. 


Описание 

Функция PostMessage ставит указанное в ней сообщение окну или множеству 
окон в очередь сообщений потока, создавшего эти окна, и возвращается, не дожи- 
даясь окончания обработки этого сообщения. Этим функция PostMessage отлича- 
ется от функции SendMessage, которая ждет окончания обработки сообщения и на 
это время блокирует приложение, пославшее сообщение. Сообщения в дальней- 
шем изымаются из очереди функциями GetMessage и PeekMessage. 
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Если вы посылаете сообщение в диапазоне ниже WM_USER асинхронными 
функциями PostMessage, SendNotifyMessage или SendMessageCallback, надо 
быть уверенным, что параметры сообщения не включают указателей. В противном 
случае из-за немедленного возврата функции может оказаться, что к моменту, ко- 
гда поток начнет обрабатывать сообщение, приложение, которое его послало, ока- 
жется уже удаленным из памяти. 


15.8.1.2 Функция SendMessage 


Функция посылает указанное в ней сообщение окну или множеству окон и не 
возвращается, пока это сообщение обрабатывается 


Объявление 
LRESULT SendMessage ( 
HWND hWnd, // дескриптор окна, 
// которому передается сообщение 
UINT Msg, // сообщение ы 


ИРАВАМ wParam, // первый параметр сообщения 
LPARAM 1Рагам // второй параметр сообщения 
); 
Параметры 
Параметр hWnd — дескриптор окна, которому передается сообщение. Если 
этот параметр равен HWND_ BROADCAST, то сообщение передается всем окнам 
верхнего уровня в системе, включая недоступные, невидимые, перекрытые други- 
ми и всплывающие, за исключением дочерних окон. 
Параметр Msg определяет передаваемое сообщение. Параметры wParam vu 1Ра- 
ram могут содержать дополнительную информацию. 


Возвращаемое значение 
Значение, возвращаемое функцией, зависит OT вида сообщения. 


Описание 

Функция SendMessage посылает указанное в ней сообщение окну или всем ок- 
нам верхнего уровня в системе, включая недоступные и невидимые, кроме дочер- 
них. Функция не возвращается, пока это сообщение обрабатывается. Таким обра- 
зом, приложение, пославшее сообщение, блокируется на время его обработки. 
Этим функция SendMessage отличается от функции PostMessage, которая возвра- 
щается сразу после передачи сообщения. 

Приложения, использующие hWnd = HWND_BROADCAST для связи между 
окнами разных приложений должны предварительно зарегистрировать уникаль- 
ность своих сообщений функцией RegisterWindowMessage. 

Примеры применения функции SendMessage рассмотрены в главе 6 в разде- 
ле 6.3.2. 


15.8.1.3 Функция RegisterWindowMessage 


Функция определяет новое окно сообщения с гарантированной уникальностью 
его в системе, которое может использоваться в функциях SendMessage и PostMes- 
sage. 


Объявление „> 


ОТМТ RegisterWindowMessage ( 
LPCTSTR lpString // адрес строки сообщения 
); 
Параметры 
IpString — указатель на строку с нулевым символом, содержащую регистри- 
руемое сообщение. 
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Возвращаемое значение 

Если регистрация прошла успешно, то возвращается идентификатор сообще- 
ния в диапазоне от 0хС000 до OxFFFF. Если регистрация завершилась аварийно, 
то возвращается нулевое значение. 


Описание 

Функция используется для регистрации сообщений, предназначенных для связи 
между различными совместно работающими приложениями. Если два приложения 
регистрируют одну и ту же строку сообщения, то им возвращается одинаковый номер 
этого сообщения. Регистрация действительна до конца сеанса работы Windows. 

Функцию RegisterWindowMessage следует использовать только в случаях, 
когда несколько приложений должны обрабатывать одно и то же сообщение. Для 
посылки собственных сообщений внутри данного класса оконных компонентов 
следует использовать любое целое в диапазоне от WM_USER до Ox7FFF. 


15.8.1.4 Функция Perform 


Метод класса TControl, посылающий оконному компоненту указанное сооб- 
щение Windows 


Объявление 
int _fastcall Perform(Cardinal Msg, int WParam, int LParam) ; 


Параметры 
Msg — идентификатор сообщения, WParam и LParam — параметры сообщения. 


Описание 

Метод Perform отличается от функций API Windows, описанных в предыду- 
щих разделах, прежде всего тем, что это метод компонентов C++Builder. Метод no- 
сылает сообщение тому оконному компоненту, к которому он применен. При этом 
Perform заполняет поля структуры типа TMessage значениями параметров Msg, 
\Рагаш, LParam и задает нулевое значение полю результата. Затем эта структура 
передается на обработку функции, указанной в компоненте свойством Window- 
Ргос. Таким образом сообщение пересылается непосредственно окну, метод Рег- 
Гогт которого используется. Например, оператор 


Form2->Perform(WM СЪО$Е, 0,0); 
передает сообщение \М_СТОЗЕ форме Еогт2, закрывая окно формы. 


15.8.1.5 Константа WM_USER 


Константа используется приложениями для определения своих частных сооб- 
щений 


Описание 

Константа WM_USER используется для разграничения номеров сообщений, 
резервированных для Windows, и частных сообщений оконных компонентов. Все 
возможные номера сообщений разделены на пять диапазонов: 


Я 


пользуемые Windows 


Я SEL LEE NE 


от WM_USER до Ox7FFF Номера частных сообщений внутри данного класса 
оконных компонентов 


от 0х8000 до OxBFFF Номера, зарезервированные для будущего использо- 
вания в Windows 


от 0хС000 до OxFFFF Номера, соответствующие строкам сообщений, испо- 
льзуемым для обмена между приложениями и заре- 
гистрированным функцией RegisterWindowMessage 


свыше OxFFFF Номера, зарезервированные для будущего использо- 
вания в Windows 
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Номера второго диапазона от Or-WM_USER до Ox7FFF могут использоваться 
для определения и посылки сообщений внутри данного класса оконных компонен- 
тов. Их нельзя использовать для определения сообщений, предназначенных для 
обмена между приложениями, поскольку некоторые предопределенные классы 
оконных компонентов (например, TButton, TEdit, TListBox и TComboBox) уже ис- 
пользуют этот диапазон. Сообщения другим приложениям в этом диапазоне могут 
посылаться только в случае, если приложения спроектированы с учетом обмена 
данными сообщениями и одинаково понимают номера этих сообщений. 

Методика объявления и использования своих собственных сообщений и при- 
менения константы WM_USER вы можете найти в главе 6 в разделе 6.3.4. 


15.8.1.6 Тип TMessage 


Является типом параметра, характеризующего сообщения Windows и переда- 
ваемого в метод WndProc 


Модуль Messages 


Объявление 


Messages 


struct TMessage 


{ 
Cardinal Msg; 
union 


{ 


struct 

{ 

Word WParamLo; 
Word WParamHi; 
Word LParamLo; 
Word LParamHi; 
Word ResultLo; 
Word ResultHi; 
}; 


struct 


{ 

int WParam; 
int LParam; 
int Result; 


Описание 
Тип TMessage представляет в WndProc и других процедурах параметры сооб- . 
щений Windows. 


15.8.2 Некоторые сообщения Windows 
15.8.2.1 WM_ACTIVATE 


| Сообщение посылается, когда окно переводится в активное или неактивное со- 
стояние. Сначала посылается окну, переходящему в неактивное состояние, а по- 
том — активируемому. 


Определение 


ИМ АСТТУАТЕ 
_fActive = LOWORD (wParam) ; 
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fMinimized = (BOOL) HIWORD(wParam) ; 
hwndPrevious = (HWND) lParam; 
Параметры / 


fActive — показывает, как активируется или деактивируется окно. Возмож- 
ные значения: ie 


а а о ELIE LIE GLEE LOL IES LY LTE LISELI IIE ILLES EEE LEED а BELE SS LIOR аа ан 


WA_ACTIVE активируется не щелчком мыши (например, функцией 
SetActiveWindow или клавиатурой) 


WA_CLICKACTIVE активируется щелчком мыши 
WA_INACTIVE деактивируется 


fMinimized — ненулевое значение показывает, что окно минимизировано. 

hwndPrevious — дескриптор, который указывает на окно, из которого фокус 
переключился на данное окно, если оно активируется, или на окно, в которое пере- 
дается управление, если данное`окно деактивируется. 


Возвращаемое значение 
Если приложение обрабатывает это сообщение, оно должно возвращать нуль. 


Действие по умолчанию 
Если активируемое окно не свернуто, то оно получает фокус. 


Примечания 
Если окно активируется щелчком мыши, оно получает также сообщение 
WM_MOUSEACTIVATE. 


15.8.2.2 WM_ACTIVATEAPP 


Сообщение посылается при переходе активности от окна одного приложения к 
окну другого приложения. Сообщения посылаются обоим окнам. 


Определение 
ИМ АСТ ТУАТЕАРР 
fActive = (BOOL) wParam; 
dwThreadID = (DWORD) 1Param; 
Параметры 


fActive — значение true означает, что окно становится активным, a false — 
что окно теряет активность. ' 

dwThreadID — указывает сторонний процесс, который теряет или приобрета- 
ет активность. 


Возвращаемое значение 
Если приложение обрабатывает это сообщение, оно должно возвращать нуль. 


15.8.2.3 WM_CANCELMODE 


Сообщение посылается окну, имеющему фокус при отображении модальных 
форм — диалогов и сообщений об ошибках. Дает возможность окну закрыться и 
освобождает мышь. | 


Возвращаемое значение 
Если приложение обрабатывает это сообщение, оно должно возвращать нуль. 


Действие по умолчанию 
Внутренний процесс завершается и мышь освобождается. 
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15.8.2.4 WM_CLOSE 


Сигнализирует, что окно или приложение закрывается. 


Определение 
WM CLOSE 


Возвращаемое значение 
Если приложение обрабатывает это сообщение, оно должно возвращать нуль. 


Действие по умолчанию 
Вызывается функция DestroyWindow, уничтожающая окно. 


Примечания 

Приложение при обработке этого сообщения может запросить пользователя о 
необходимости закрывать окно и вызвать функцию Destroy Window только при по- 
ложительном ответе. 


15.8.2.5 WM_GETMINMAXINFO . 


Посылается перед изменением размеров или положения окна. Обработчик со- 
общения может использоваться для ограничения допустимых размеров и коорди- 
нат положения на экране. | 


Определение 


WM GETMINMAXINFO 
lpmmi = (LPMINMAXINFO) 1Param; 


Параметры 

Параметр 1ршпи указывает на структуру типа MINMAXINFO, содержащую 
принятые по умолчанию пределы изменения размеров и координат положения 
окна. Описание этой структуры: 


typedef struct tagMINMAXINFO { 
POINT ptReserved; 
POINT ptMaxSize; 
POINT ptMaxPosition; 
POINT ptMinTrackSize; 
POINT ptMaxTrackSize; 

} MINMAXINFO; 


Поля структуры означают следующее: 


tReserved Зарезервировано и пока не используется 


ptMaxSize Поле типа Point определяет ширину (Point.x) и высоту (Po- 
int.y) развернутого окна 


ptMaxPosition Поле типа Point определяет положения левого (Point.x) и 
верхнего (Point.y) краев развернутого окна 


ptMinTrackSize Поле типа Point определяет минимальную ширину (Point.x) 
и минимальную высоту (Point.y) окна при изменении пользо- 
вателем размеров его рамки 


ptMaxTrackSize Поле типа Point определяет максимальную ширину (Point.x) 
и максимальную высоту (Point.y) окна при изменении поль- 
зователем размеров его рамки 


4 


Возвращаемое значение 
Если приложение обрабатывает это сообщение, оно должно вернуть 0. 
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15.8.2.6 WM_GETTEXT 


Посылается, чтобы скопировать текст, связанный с окном, в указанный буфер. 


Определение 
ИМ СЕТТЕХТ 

wParam = (WPARAM) cchTextMax; 
lParam = (LPARAM) lpszText; 
Параметры 


cchTextMax указывает минимальное число символов, которые должны быть 
скопированы, включая нулевой конечный символ. 
IpszText указывает на буфер, принимающий текст. 


Возвращаемое значение 
Возвращает число скопированных символов. 


Действие по умолчанию 
Копируется текст, связанный с окном, в указанный буфер. и возвращается чис- 
ло скопированных символов. 


Примечания 

Для всех окон редактирования текст — это содержимое окна. Для выпадаю- 
щих списков текст — это выделенный текст. Для кнопок текст — это имя кнопки. 
Для остальных оконных компонентов текст — это заголовок окна. 

Для копирования обогащенного текста, превышающего 64K, надо использо- 
вать сообщения EM_STREAMOUT или EM_GETSELTEXT. 


15.8.2.7 WM_SETTEXT 
Посылается, чтобы задать текст указанного окна. 


Определение 


ММ ЗЕТТЕХТ 
мРагам = 0; // не используется, должен равняться 0 
1Param (LPARAM) (LPCTSTR) lpsz; 


Параметры 
Ipsz — указатель на строку текста окна с нулевым конечным символом. 


Возвращаемое значение 

Возвращает true, если текст установлен. В противном случае возвращает false 
(для окна редактирования), LB_ ERRSPACE (для списка) или CB_ERRSPACE (для 
выпадающего списка) если не хватает места для размещения текста. Возвращает 
CB_ERR, если сообщение посылается выпадающему списку без окна редактирова- 
ния. 


Действие по умолчанию 
Устанавливает и отображает текст окна. 


Примечания 

Для всех окон редактирования текст — это содержимое окна. Для выпадаю- 
щих списков текст — это выделенный текст. Для кнопок текст — это имя кнопки. 
Для остальных оконных компонентов текст — это заголовок окна. 

Сообщение не изменяет текущее выделение в списках. Чтобы выделялся эле- 
мент списка, соответствующий тексту, надо использовать сообщение CB_SELECT- 
STRING. 


Свойства, методы, события, 
типы, классы 


В этой главе слова и термины, выделенные подобным образом, означают, что 
вы можете найти в главе раздел, содержащий развернутые пояснения выделенных 
терминов. 

Определения свойств, методов, типов и, особенно, структур в приведенном в 
данной главе тексте несколько изменены и упрощены по сравнению с документа- 
цией C++Builder, чтобы читателю проще было в них ориентироваться. Например, 
опущены ссылки на методы записи и чтения свойств, которые не представляют ин- 
тереса для пользователя, кардинально сокращены объявления многих структур — 
в них оставлены только имена и типы полей, устранены многие промежуточные 
ссылки на типы. 

Конечно, приведенные в главе сведения — это малая часть всех свойств, мето- 
дов, событий, классов, имеющихся в C++Builder. В частности, из-за ограничения 
на размер книги в главе отсутствуют сведения по классам, свойствам, методам, ис- 
пользуемым при работе с базами данных. Эти сведения (сверх того, что рассказано 
в главах 9 и 10) вам придется почерпнуть из встроенной в C++Builder справки, или 
можете посмотреть в книгах [7] и [8], где они приводятся более подробно, чем в 
данной книге, или воспользоваться русской справкой, которая, как я надеюсь, 
выйдет в серии «Все о С++Ви!аег». 


16.1 Свойства 


Action 


Определяет действие, связанное с данным управляющим элементом — разде- 
лом меню, кнопкой и др. 


Классе TControl 
Определение 
_ property Classes::TBasicAction* Action 


Описание 

Значение свойства Action выбирается во время проектирования из выпадаю- 
щего списка предусмотренных действий в Инспекторе Объектов. Этот список фор- 
мируется в процессе проектирования размещением на форме компонента Action- 
List и заданием его свойств. 

Подробнее о диспетчеризации действий см. в разделе 3.9.1 главы 3. 


Align 
Определяет способ выравнивания компонента внутри контейнера (родитель- 
ского компонента) 
Классе TControl 


Определение 
enum TAlign {alNone,alTop,alBottom, alLeft,alRight,alClient}; 
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__ property TAlign Align 


Описание 

Свойство Align определяет, остается ли компонент неизменным при измене- 
нии размеров содержащей его формы, панели, другого компонента, или он изменя- 
ется, занимая всю доступную площадь, ее верхнюю, нижнюю, левую или правую 
часть. 

Возможные значения свойства: 


Значение РИ 


| `а1Мопе Компонент остается там, где он размещен во время проектирования. 


Размеры его не изменяются. Это значение Align по умолчанию. 
| alTop 


|alBottom |Компонент занимает всю нижнюю часть контейнера и во время вы- 
| полнения приложения его ширина изменяется при изменении ши- 


| alLeft 

| 

| alRight 
| 


| alClient 


Значение Align no умолчанию — alNone. В приложениях, в которых пользо- 
ватель может изменять размер формы, а сама форма разбита панелями или други- 
ми компонентами на ряд областей, необходимо изменять это значение Align. 

Если компонент имеет значение Align, равное alClient, то в процессе проекти- 
рования невозможно добраться до содержащего его контейнера и щелкнуть на 
нем, чтобы получить в Инспекторе Объектов его свойства и события. В этом случае 
возможны два решения: щелкнуть на компоненте и нажать клавишу Esc или осу- 
ществить выбор компонента-контейнера с помощью выпадающего списка в верх- 
ней части Инспектора Объектов. 

Значения Align а! Тор и alBottom имеют приоритет перед alLeft и alRight. По- 
этому, если вы, например, ввели на форму две панели, одной задали значение 
alLeft, а второй задаете значение alTop, то вторая панель вытеснит верхнюю часть 
первой панели, которая первоначально заняла всю левую часть клиентской облас- 
ти. Если это нежелательно, приходится вводить дополнительные панели, являю- 
щиеся контейнерами для других панелей. 

Подробнее об использовании свойства Align и множество примеров его ис- 
пользования вы найдете в главе 4 в разделе 4.2.1. 


| 


Компонент занимает всю верхнюю часть контейнера и во время вы- 
полнения приложения его ширина изменяется при изменении ши- 
рины контейнера. Высота компонента остается неизменной. 


рины контейнера. Высота компонента остается неизменной. 


Компонент занимает всю левую часть контейнера и во время выпол- 
нения приложения его высота изменяется при изменении высоты 
контейнера. Ширина компонента остается неизменной. 


Компонент занимает всю правую часть контейнера и во время вы- 
полнения приложения его высота изменяется при изменении высо- 
ты контейнера. Ширина компонента остается неизменной. 


Компонент занимает всю клиентскую область контейнера и во вре- 
мя выполнения приложения его размеры изменяются при измене- 
нии размеров контейнера. Если в контейнере часть клиентской об- 
_| ласти уже занята, компонент занимает всю ее оставшуюся часть. 


Anchors 


Определяет привязку данного компонента к родительскому при изменении 
размеров последнего 


Свойства, методы, события, типы, классы 1009 


Класе TControl 


Определение 
enum TAnchorKind { akLeft, akTop, akRight, akBottom }; 


typedef Set<TAnchorKind, akLeft, akBottom> TAnchors; 


__ property TAnchors Anchors 


Описание 

Свойство Anchors введено только начиная C++Builder 4. Оно определяет при- 
вязку данного компонента к родительскому при изменении размеров последнего. 
Свойство представляет собой множество типа Set, которое может содержать сле- 
дующие элементы: , 


SPREE LEE OEE IIE IIE IIL LOE ИИА НИРС 


-akTop ook Компонент привязан к верхнему краю родительского 
akLeft Компонент привязан к левому краю родительского 
akRight Компонент привязан к правому краю родительского 
акВо вот Компонент привязан к нижнему краю родительского 


Если в множестве Anchors присутствуют привязки к противоположным сторо- 
нам родительского компонента, то при изменении родительского компонента про- 
исходит растяжение или сжатие данного компонента, поскольку расстояния от 
сторон родительского компонента выдерживаются. Сжатие может происходить 
вплоть до полного уничтожения изображения данного компонента. Для компонен- 
та TPaintBox, привязанного к противоположным сторонам родительского компо- 
нента, при изменении размеров родительского компонента изображение стирается 
и наступает событие OnPaint. 


Примеры 
1. Buttonl->Anchors.Clear(); 
Buttonl->Anchors << akLeft << akBottom; 


Первый из этих операторов очищает множество Anchors кнопки Button, уда- 
ляя из него первоначальные установки. Второй оператор привязывает кнопку 
Buttonl к левому и нижнему краям окна. При изменении размеров окна кноп- 
ка будет перемещаться, сохраняя установленное расстояние от левого и ниж- 
него краев формы. _ 


2. Задание компоненту списку TListBox свойства Anchors, равного [akLeft,ak- 
Top,akBottom], приведет к тому, что при изменении высоты окна будут под- 
держиваться постоянными расстояния верхнего и нижнего краев компонента 
соответственно от верхнего и нижнего краев окна. Таким образом, увеличивая 
высоту окна пользователь может увеличивать число строк, видимых в списке 
без прокрутки. При этом необходимые с точки зрения эстетики расстояния до 
краев окна будут поддерживаться автоматически. 


3. Buttonl->Anchors.Clear(); 
Buttonl->Anchors << akLeft << akBottom << akRight; 


В этом случае кнопка привязана к левому, нижнему и правому краям формы. 

При изменении высоты окна кнопка будет перемещаться синхронно с нижним 

краем окна. А при изменении горизонтального размера окна кнопка будет рас- 

тягиваться или сжиматься по горизонтали, что, конечно, будет создавать 

ужасный зрительный эффект. При сжатии кнопка может сжаться до нуля, 
_ после чего ее изображение исчезнет. 
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AutoMerge | 


Определяет, должно ли главное меню вторичной формы объединяться с меню 
главной формы 


Классе TMainMenu 


Определение 
_ property bool AutoMerge 


Описание 

Если требуется, чтобы меню вторичных форм объединялись с меню главной 
формы, то в каждой такой вторичной форме надо установить AutoMerge в true. 
При этом свойство главной формы должно оставаться в false. Способ объединения 
меню определяется свойствами GroupIndex элементов меню Items типа TMenu- 
Item. 

В MDI приложениях объединение меню осуществляется автоматически неза- 
висимо от значения свойства AutoMerge. 


AutoSelect 
Указывает, будет ли выделяться весь текст, когда элемент получает фокус 
Класс TCustomEdit 


Определение 
_ property bool AutoSelect 


Описание 

Свойство AutoSelect, установленное в true, показывает, что при получении 
элементом фокуса весь текст окажется выделенным. Это свойство относится толь- 
ко к элементам редактирования одной строки текста. 

Свойство AutoSelect имеет смысл устанавливать в true, если по условиям pa- 
боты пользователь будет скорее заменять текст, имеющийся в окне, чем дополнять 
его. 


AutoSize 


Определяет, должны ли размеры компонента автоматически адаптироваться к 
размерам его текста или изображения 


Классы TCustomEdit, TCustomLabel, TImage и др. 


Определение 
_ property bool AutoSize 


Описание 

При свойстве AutoSize, установленном в false, размеры компонента фиксиро- 
ваны. При AutoSize, установленном в true, в классах-наследниках TCustomLabel 
(метках), в Tlmage и ряде других компонентов др. ширина и высота компонента 
автоматически адаптируется к размерам текста или изображения. В классах-на- 
следниках TCustomEdit (окнах редактирования) ширина компонента остается 
фиксированной, а высота изменяется так, чтобы высота клиентской области соот- 
ветствовала высоте текста. Например, высота элемента меняется при изменении 
шрифта или стиля бордюра. 


Bitmap 
Определяет внешний нестандартный шаблон размером 8 Ha 8 пикселей, KOTO- 
рый использует для заполнения кисть Brush 
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Класс TBrush 


Определение 
_ property TBitmap* Bitmap 


Описание 

Свойство кисти Bitmap указывает на объект типа TBitmap, в который загру- 
жен шаблон размером 8 на 8 пикселей, используемый для заполнения кистью 
Brush. 

Если для кисти задан шаблон BitMap, то заполнение производится именно 
этим шаблоном, независимо от значения свойства кисти Style. Шаблон BitMap мо- 
жет создаваться в процессе выполнения приложения или, например, загружаться 
из файла. 

Если размер изображения превышает 8 на 8 пикселей, то в качестве шаблона 
будет использоваться его левая верхняя часть размером 8 на 8. 

Изменение изображения в объекте TBitmap не влияет на шаблон, пока He про- 
изведено повторное присваивание свойству Bitmap. 

После окончания работы с шаблоном объект TBitmap следует удалить из па- 
мяти, так как автоматически это не делается. 


Пример 
Graphics::TBitmap *MyBitmap = new Graphics::TBitmap; 


try 

{ 

MyBitmap->LoadFromFile("MyBitmap.bmp") ; 
Imagel->Canvas->Brush->Bitmap = MyBitmap; 


} 

__ finally 

{ 
Imagel->Canvas->Brush->Bitmap = NULL; 
delete MyBitmap; 

} 


В этом примере создается объект MyBitmap типа TBitmap и в него загружает- 
ся битовая матрица из файла с именем «MyBitmap.bmp». Затем свойству 
Imagel->Canvas->Brush->Bitmap присваивается указатель на этот объект. После 
этого загруженный шаблон можно использовать для заполнения фигур на канве 
Imagel. В конце кода свойству BitMap присваивается значение NULL, после чего 
заполнение опять начинает определяться свойством Style. Затем объект MyBitmap 
уничтожается, чтобы освободить занимаемую им память. 


BoundsRect 


Определяет прямоугольник, описывающий компонент, в координатах содер- 
жащего его контейнера 


Классе TControl 


Определение 


struct TRect 
{ 
int Left; 
int Top; 
int Right; 
int Bottom; 
be 


_ property Windows::TRect BoundsRect 
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Описание 

Свойство BoundsRect использует тип TRect и позволяет получить одновремен- 
но координаты пикселей всех четырех углов компонента. Иной способ получить те 
же координаты — использовать свойства компонента Left (левый край), Top (Bepx- 
ний край), Width (ширина), Height (высота) и соответствующие вычисления. 
Иначе говоря, при чтении данных эквивалентны следующие выражения: 


ЗИ ИА ИЯ И GEL IEE GLEE RESELL SLE ALE LEONE IGEES EES ELMEGERLEN SESE SE SELLER GLELEVEEDS BOSE BEE SEE EL LEE LEAL LNAI SLEEP RESALE LAE SEE 


Control->BoundsRect.Left Control->Left 
Control->BoundsRect.Top Control->Top | 
Control->BoundsRect.Right Control->Left + Control->Width 
Control->BoundsRect.Bottom Control->Top + Control->Height 


Началом координат считается левый верхний угол родительского окна. 

Отмеченная выше эквивалентность выражений для различных свойств спра- 
ведлива только при чтении данных. Но присвоить целое значение, например, свой- 
ству BoundsRect.Left нельзя. Точнее, можно, но это не повлияет на размер компо- 
нента. Присвоить значение можно только всей структуре BoundsRect. 

При задании значений BoundsRect удобно пользоваться функцией Rect (см. 
раздел 15.3.3 главы 15), принимающей координаты сторон прямоугольника и воз- 
вращающей структуру типа TRect. 

Помимо перечисленных свойств, определяющих размеры компонента, имеют- 
ся еще свойства ClientWidth и ClientHeight, определяющие размеры ero клиент- 
ской области. Эти размеры равны или меньше размеров Width и Height. 

Свойства, определяющие координаты компонента, полезны в задачах, требую- 
щих изменения размеров или перемещения компонентов. 


Примеры 

1. Пусть панель Panell может менять свою длину при изменении пользователем 
размеров окна (например, имеет значение Align = alTop). И пусть в середине 
этой панели имеется метка StaticTextl типа StaticText, которая при всех из- 
менениях должна оставаться посередине, не изменяя своих размеров. Это 


можно осуществить, вставив в обработчик событий формы OnResize и OnShow 
оператор: 


StaticTextl->Left = 
(Panell->BoundsRect.Left + Panell->BoundsRect.Right - 
StaticTextl->Width) / 2; 


Впрочем, Toro же эффекта можно добиться и не прибегая к свойству Bounds- 
Rect, заменив приведенный оператор на следующий: 


StaticTextl->Left := Panell->Left + (Panell->Width - 
StaticTextl->Width) / 2; 


2. Пусть мы хотим, чтобы при нажатии некоторой кнопки окно текстового pe- 
дактора Memol перемещалось в новую заранее определенную позицию с новы- 
ми определенными размерами. Мы можем в нужной позиции разместить па- 
нель Рапе!1 с нужными размерами, сделать ее невидимой, а в нужный момент 
выполнить всего один оператор: 


Memol->BoundsRect = Panell->BoundsRect; 


3. Пусть мы хотим взаимно поменять места расположения двух одинаковых по 
размерам панелей Panell и Panel2. Это можно сделать следующими операто- 
рами: 
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= 


ii 


TRect rec; 


rec = Panell->BoundsRect; // Запоминание позиции Panell 
Panell->BoundsRect = Panel2->BoundsRect; // Перемещение Panell 
Panel2->BoundsRect = rec; // Перемещение Panel2 


Пример задания BoundsRect с помощью функции Rect. Пусть окно текстового 
редактора Memol расположено на родительской панели Рапе! 1, размеры кото- 
рой во время выполнения могут изменяться при изменении размеров формы. 
Надо, чтобы размер Мето1 также изменялся, но по отношению к клиентской 
области Panell оставлял слева, внизу и справа зазор в 10 пикселей (для более 
приятного вида), а сверху — зазор 40 пикселей (для размещения заголовка 
окна). Это можно сделать, поместив в обработчик события OnResize панели 
Рапе!1 оператор: 


Memol->BoundsRect = Вес (10,40, Panell->ClientWidth-10, 
Panell->ClientHeight-10) ; 


Примеры использования свойства BoundsRect приведены также в разделах 


BringToFront и Visible. 


Break 


Определяет, должен ли начинаться с данного раздела новый столбец разделов 


меню 


Класс ТМепи ет 


Определение 
enum TMenuBreak { mbNone, mbBreak, mbBarBreak }; 


__ property TMenuBreak Break 


Описание 
Свойство Break используется в длинных меню, чтобы разбить список разделов 


на несколько столбцов. Возможные значение Break: 


он х ‘ shone tenant ; ORES LURES MEMES RE: SRE BR et ot 


joe 


mbNone Отсутствие разбиения меню. Это значение принято по умолчанию. 

mbBar- В меню вводится новый столбец разделов и данный раздел являет- 

Break ся верхним в новом столбце. Столбец отделяется от предыдущего 
полосой. 

mbBreak В меню вводится новый столбец разделов и данный раздел являет- 


ся верхним в новом столбце. Столбец отделяется от предыдущего 
пробелами. 


Пример использования свойства ВгеаК приведен в разделе 3.6.1 главы 3. 


Brush 


Определяет цвет и стиль заполнения фона окна 
Классе TWinControl 

Доступ только для чтения 

Определение 

_ property Graphics::TBrush* Brush 


— 
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Описание 

Свойство Brush (кисть) присуще многим оконным объектам, включая Canvas. 
Его можно читать, чтобы определить цвет и стиль заполнения фона окна. Это свой- 
ство только для чтения. Однако, атрибуты объекта Brush можно изменять, исполь- 
зуя свойства Color и Style. Кроме того все свойства объекта могут быть изменены 
методом Assign. 

Тип TBrush определяет свойства и методы объекта Brush. См. информацию о 
свойствах и методах, а также примеры в разделе TBrush. 


Canvas 
Поверхность (холст, канва) для рисования во многих компонентах 
Классы ТРогт, TImage, TBitMap, TPaintBox 
Доступ только для чтения 


Определение 


_ property Graphics::TCanvas* Canvas 


Описание 

Свойство Canvas типа TCanvas используется для рисования пером Реп и ки- 
стью Brush, для модификации изображения, наложения друг на друга нескольких 
изображений. 

В компоненте типа TIlmage канва может использоваться только в случае, если 
в свойство Picture загружена битовая матрица или ничего не загружено. Если в 
Picture находится объект типа, отличного от TBitMap, то при обращении к Canvas 
генерируется исключение EInvalidOperation. Если же в Picture находится бито- 
вая матрица, то CanvaS можно использовать для редактирования изображения, 
например, для добавления в изображение надписей методом TextOut. 


Capacity 
Количество элементов массива указателей, которые могут храниться в объекте 
класса TList 


Классы T'List, TStringList 


Определение 
_ property int Capacity 


Описание 

Свойство Capacity можно задавать, чтобы определить число указателей, KOTO- 
рые могут храниться в объекте класса TList. Если при увеличении Capacity оказы- 
вается, что ресурсы памяти исчерпаны, генерируется исключение EOutOfMemory. 

Свойство Capacity отличается от близкого ему свойства Count. Capacity пока- 
зывает, сколько указателей может храниться в массиве, т.е. емкость списка, а 
Count показывает, сколько указателей в действительности хранится в массиве. 
Поэтому значение Capacity всегда не меньше значения Count. 

При добавлении в массив нового элемента Count автоматически увеличивает- 
ся на 1. Если при этом значение Count превышает значение Capacity, то Capacity 
тоже автоматически увеличивается, причем с запасом (обычно запас равен 3). Так 
что свойство Capacity вообще можно нигде в приложении не задавать. Смысл зада- 
ния Capacity заключается только в TOM, чтобы предотвратить слишком частое пе- 
рераспределение памяти при добавлении новых элементов списка. 

При удалении элементов списка Count автоматически уменьшается, а значе- 
ние Capacity остается неизменным. Таким образом, при сокращении длины спи- 
ска получаются излишние затраты памяти. В эти случаях целесообразно умень- 
шить Capacity до значения Count (если не планируется в ближайшее время нового 
увеличения числа элементов). 
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Если задать значение Capacity меньшее, чем Count, генерируется исключение 
EListError с сообщением: «List capacity out of bounds [...]» («Емкость списка вне 
допустимых пределов»). В квадратных скобках указывается значение Count. 

Очистка списка методом Clear сбрасывает Capacity на нуль. 

Значение Capacity может быть увеличено методом Expand. 


Пример 
TList *List = new TList(); 


List->Clear(); 
List->Capacity = 5; 


// Тут List->Count = ди List->Capacity = 5 
for(int I = 1; I <= 5; I++) 

List->Add(...); 
// Тут List->Count = 5 и List->Capacity = 5 
for Aint тот Meare +e) 
List->Delete (I); 
// Tyr List->Count = 2 u List->Capacity = 5 
List->Capacity = List->Capacity “Ч 

= 2 


// Тут List->Count = 2 и List->Capacity 


Этот пример будет выполнять те же самые функции и без операторов 
List->Capacity = 5; 


List->Capacity = List->Capacity - 3; 


Но первый из этих операторов экономит время при увеличении длины списка, 
а второй — сокращает затраты памяти. 


Caption 
Определяет строку текста, идентифицирующую компонент для пользователя 
Классе TControl 


Определение 
_ property System::AnsiString Caption 


Описание 

Свойство Caption связывает с компонентом некоторую строку текста, пояс- 
няющую его назначение. Чаще всего это надписи на кнопках, метках, панелях, 
тексты разделов меню и т.д. 

По умолчанию Caption совпадает с именем компонента — свойством Name и 
изменяется при его изменении. 

Для разделов меню и кнопок можно в свойстве Caption указать символы быст- 
рого доступа. Для этого перед соответствующим символом надо поставить символ 
амперсанта — &. Следующий за амперсантом символ будет отображаться подчерк- 
нутым и будет являться символом быстрого доступа: при выполнении приложения 
нажатие клавиши Alt + клавиши данного символа будет эквивалентно выбору со- 
ответствующего раздела меню или нажатию соответствующей кнопки. 

Если в текст строки Caption надо ввести символ амперсанта, его надо повто- 
рить дважды: &&. 

Для разделов меню задание значения Caption, равного символу «-», означает 
разделительную черту. 
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Поскольку Caption имеет тип AnsiString, то этому свойству можно непосред- 
ственно присваивать не только строковые значения, но и символы, целые и дейст- 
вительные числа. 


Примеры 
1. Примеры задания свойства Caption в процессе проектирования меню: 


> 
СИНИЕ STRAT NN RGR 
РИНАТА 


< 
a 
— . 


2. Пример использования метки для отображения результата ответа пользователя: 


if (Editl->Text = "1") 
Labell->Caption = "Ответ правильный"; 
else Labell->Caption = "Ответ ошибочный"; 


3. Примеры присваивания свойству Caption значений, отличных от строк: 


Labell->Caption = 5; 
Label2->Caption эй} 
Label3->Caption = '‘'A'; 


Charset 
Свойство, определяющее набор символов шрифта 
Класс ТЕРопЕ 


Определение 
typedef Byte TFontCharset; 


__ property TFontCharset Charset 


Описание 

Свойство Charset определяет a символов шрифта — объекта типа TFont. 
Каждый вид шрифта, определяемый его именем, поддерживает один или более на- 
боров символов. Какие именно значения Charset поддерживает тот или иной 
шрифт можно установить из документации на него или экспериментальным пу- 
тем. Для шрифтов, поддерживающих несколько наборов символов, важно пра- 
вильно задать Charset. 

В C++Builder предопределено много констант, соответствующих стандартным 
наборам символов. Большинство из них, относящихся к японскому, корейскому, 
китайскому и другим языкам, вряд ли представляют интерес для наших читате- 
лей. Поэтому ниже приводится сокращенная таблица этих констант. 


|Конставта [Значение |Опиае | 
|ANSICHARSET _ |0 |Символы ANSI. 


| РЕЕАОГТ- 
'СНАВЗЕТ 


Задается по умолчанию. Шрифт выбирается 
только по его имени Маше и размеру Size. 
Если описанный шрифт недоступен в системе, 
то Windows заменит его другим шрифтом. 


[SYMBOL_CHARSET |2 |Стандартный набор символ. 


Свойства, методы, события, типы, классы 1017 


Константа Значение |Onucamwe 
| МАС_СНАВЗЕТ Символы Macintosh. Недоступны для МТ 3.51. 
GREEK_CHARSET Греческие символы. Недоступны для NT 3.51. 


|RUSSIAN_CHARSET | 204 Символы кириллицы. Недоступны для 

| МТ 3.51. 

| EASTEUROPE _ 238 Включает диакритические знаки (знаки, до- 
бавляемые к буквам и характеризующие их 
произношение) для восточно-европейских 
языков. Недоступны для МТ 3.51. 


| СНАВЗЕТ 
| OEM_CHARSET 255 Зависит от кодовой таблицы операционной 
arr | _ | системы. OT Пай 


По умолчанию в объекте типа TFont задается значение Charset, равное 
DEFAULT_CHARSET. Для имен шрифтов, принятых в C++Builder по умолча- 
нию, это обычно нормальный вариант. Но в ряде случаев полезно для отображения 
русских текстов с другими шрифтами заменить это значение на 
RUSSIAN_CHARSE. Это позволит отобразить символы кириллицы для тех шриф- 
тов, для которых при DEFAULT СНАВЪФЕТ символы кириллицы не отображают- 
ся нормально. 


Пример 
См. пример 4 в разделе Font. 


ClientHeight 


Высота клиентской области в пикселях 


Класс TControl 


Определение 
_ property int ClientHeight 


Описание 

Свойство ClientHeight может использоваться для чтения или изменения высо- 
ты клиентской области. Чтение ClientHeight необходимо, чтобы изменять место- 
положение или размеры компонентов, расположенных в клиентской области, при 
изменении размеров компонента-контейнера (см. примеры в разделе BoundsRect). 

Эквивалентно по значению свойству ClientRect.Bottom (cm. ClientRect). 

В классе TControl значение ClientHeight равно значению Height. Но в произ- 
водных классах оно обычно меньше Height. Например, для формы значение 
ClientHeight может уменьшаться из-за бордюра, полосы заголовка, полосы меню, 
полосы прокрутки. 

Пример 

Пусть вы проектируете форму, содержащую панель Panell, на которой разме- 
щается список ListBoxl1, причем во время выполнения высота этой формы может 
изменяться. Тогда обеспечить синхронное изменение размера окна списка можно, 
вставив в событие OnResize формы или этой панели оператор: 


ListBoxl->Height = Panell->ClientHeight - ListBoxl->Top - 20; 


Более подробное рассмотрение этого примера имеется в разделе 4.2 главы 4. 


ClientOrigin 


Координаты положения на экране левого верхнего угла клиентской области 
компонента 
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Классе TControl 
Доступ только для чтения 
Определение 


struct TPoint 


{ 

Or See 
es) aa Bs 
3 


.. property Windows::TPoint ClientOrigin 


Описание 

Свойство ClientOrigin возвращает экранные координаты X иу левого верхнего 
угла клиентской области компонента. Горизонтальная координата х и вертикаль- 
ная координата у хранятся в структуре типа TPoint. Началом координат считается 
левый верхний угол экрана. 

Экранные координаты ClientOrigin для компонентов, не являющихся потом- 
ками класса TWinControl (т.е. не являющихся окнами), определяются как экран- 
ные координаты родительского компонента (компонента-контейнера), сложенные 
со значениями свойств Left и Тор. Если компонент не имеет родителя, то при по- 
пытке чтения ClientOrigin генерируется исключение ElInvalidOperation. 


ClientRect 


Определяет координаты углов клиентской области компонента 
Класс TControl 
Доступ только для чтения 


Определение 


struct TRect 
в: 

int Lett: 
int Top; 
int Right; 
int Bottom; 


}; 


_ property Windows::TRect ClientRect 


Описание 

Свойство ClientRect возвращает структуру типа TRect, характеризующую 
прямоугольную клиентскую область компонента. При этом поля структуры Тор и 
Left устанавливаются в нуль, а поля Right и Bottom определяются соответственно 
значениями свойств СПеп Width и ClientHeight. Так что ClientRect эквивалентна 
функции Rect (см. раздел 15.3.3 главы 15) вида Rect(O, 0, Client Width, 
ClientHeight). 

Координаты клиентской области могут задаваться как четырьмя целыми зна- 
чениями координат, так и двумя точками, характеризующими левый верхний и 
правый нижний углы прямоугольника. 


Client Width 


Горизонтальный размер клиентской области в пикселях 
Классе TControl 


Определение 
_ property int ClientWidth 
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Описание 

Свойство СНеп Width может использоваться для чтения или изменения гори- 
зонтального размера клиентской области. Чтение ClientWidth необходимо, чтобы 
изменять местоположение или размеры компонентов, расположенных в клиент- 
ской области, при изменении размеров компонента-контейнера (см. подобные при- 
меры в разделе BoundsRect). | | 

Эквивалентно по значению свойству ClientRect. Right (cm. ClientRect). 

В классе TControl значение ClientWidth равно значению Width. Но в произ- 
водных классах оно обычно меньше Width за счет бордюра, полосы прокрутки и 
иных элементов оформления. 


ClipRect 


Определяет доступную область рисования на канве и область, подлежащую пе- 
рерисовке при обработке события OnPaint. 


Класс ТСапоаз 
Доступ только для чтения 


Определение 


struct TRect 
{ 
int Left; 
int Top; 
int Right; 
int Bottom; 


}; 
_ ргорегеу Windows::TRect ClipRect 


Описание res 

Свойство канвы ClipRect определяет доступную область рисования на канве и 
область, нуждающуюся в перерисовке. Вне области ClipRect рисовать невозможно. 

При обработке события формы OnPaint это свойство определяет ту часть кан- 
вы, вне которой перерисовка не требуется. Использование этого свойства позволя- 
ет сократить затраты времени на перерисовку. 


Со]ог 
Цвет фона компонента, цвет текста объекта TFont и др. 
Класс TControl 
Определение 
_ property Graphics::TColor Color 


Описание 

Свойство Color определяет цвет фона компонента или цвет текста объекта 
TFont. Значение цвета может задаваться как значение, определяющее интенсив- 
ности красного, зеленого и синего цветов в формате КСВ (см. раздел TColor), или 
равным одной из перечисленных ниже предопределенных в C++Builder констант. 


Un Аа сие сео 
Гоа Оливково-зеленый 


1020 | Глава 16 


| Константа Значение цвета 
| 


| ‹ПМауу Темно-синий 


Пурпурный 


| 
—} 


Морской воды 


Серый 


| 
jelSilver | Серебряный 
lRed [Красный 


Лимонно-зеленый 


ве [Синий 


| clYellow Желтый 


jelFuchsia [Сиреневый 

| Голубой 

jelWhite [Белый 

‘elBackground | Текущий цвет фона стола Windows 

Текущий цвет полос прокрутки 

Текущий цвет фона полосы заголовка в активном окне 
Текущий цвет фона полосы заголовка в неактивном окне 


|4Мепи (Текущий цвет фона меню 


| 
| 


| 
| 


Текущий цвет фона окон 
_clWindowFrame Текущий цвет рамок окон 
|clMenuText Текущий цвет текста меню 


clWindowText Текущий цвет текста окон 


—— 
| 
= 
= 
i 


clCaptionText Текущий цвет текста заголовка в активном окне 


clActiveBorder Текущий цвет бордюра активного окна 


Текущий цвет бордюра неактивного окна 
Текущий цвет рабочей области приложений 
Текущий цвет фона выделенного текста 
Текущий цвет выделенного текста 

Текущий цвет поверхности кнопок 

Текущий цвет теней, отбрасываемых кнопками 
Текущий цвет текста недоступных элементов 
Текущий цвет текста кнопок 


clInactiveCaption- Текущий цвет текста заголовка в неактивном окне 
Text . 


clBtnHighlight Текущий цвет выделенной кнопки 


| cl3DDkShadow Цвет темных теней трехмерных элементов; только для 
| ’ | Windows 95/98 или МТ 4.0 
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Константа Значение цвета | 
cel3DLight Светлый цвет на краях освещенных трехмерных элемен- 


тов; только для Windows 95/98 или МТ 4.0 


| 

| clInfoText Цвет текста советов; только для Windows 95/98 или 
| МТ 4.0 

| clInfoBk Цвет фона советов; только для Windows 95/98 или 


Первая часть этих констант соответствует определенным цветам. А вторая 
часть определяется той схемой цветов, которую установил пользователь в 
Windows. Пользователь может менять эту схему с помощью «Панели Управления» 
Windows. Таким образом, эти цвета могут изменяться от системы к системе. Ha- 
‘пример, clBtnFace может соответствовать серому цвету в одной схеме и желтова- 
то-коричневому в другой. | 

Как правило, лучше использовать в приложении эти системнозависимые цве- 
та. Тогда ваше приложение не будет выбиваться из общей гаммы цветов, на кото- 
рую настроился пользователь. 

Если свойство ParentColor компонента установлено в true (это делается по 
умолчанию), то цвет данного компонента определяется свойством Со]ог контейне- 
ра, содержащего данный компонент. Это позволяет автоматически согласовывать 
цвета компонентов, содержащихся в одной области окна. Как только вы задаете в 
Инспекторе Объектов или программно значение Color, свойство ParentColor пере- 
ключается в false. 


ComponentCount é 


Число компонентов, которыми владеет данный компонент 
Класс TComponent 
См. раздел Components. 


ComponentIndex ) 


Индекс компонента в списке компонентов владельца данного компонента 
Класс TComponent 
См. раздел Components. 


Components 


Массив компонентов, которыми владеет данный компонент 
Класе TComponent 
Определение 


__property TComponent* Components[int Index] 


Описание 

Свойство Components содержит массив компонентов, которыми владеет дан- 
ный компонент. Параметр Index позволяет сослаться на любой компонент с помо- 
щью его свойства Сотропеп пех, определенного в классе TComponent. Индексы 
отсчитываются от 0, т.е. индекс первого компонента равен 0. Общее число компо- 
нентов, содержащихся в массиве Components, определяется свойством 
ComponentCount, определенным в классе TComponent. Значение ComponentCount 
на 1 меньше последнего индекса массива Components. 
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Свойство Components может использоваться вместе с ComponentCount в цик- 
лах, когда надо изменить какие-то свойства всех компонентов. 


Примеры 


1. В приведенном ниже примере все компоненты на данной форме, кроме компо- 
нента с именем ВиЙоп1, смещаются вправо на 10 единиц. 


for(int i = 0; i < ComponentCount; 1++) 
if (Components[i]->Name != "Buttonl") 
((TControl *)Components[i])->Left += 10; 


ыы 


Ниже приведен аналогичный пример, но используется свойство Tag и сдвига- 
ются только компоненты, у которых Тай =1. 


for(int i = 0; i < ComponentCount; 1++) 
if (Components[i]->Tag == 1) 
((TControl *)Components[i])->Left += 10; 


Constraints 


Позволяет задавать ограничения на допустимые изменения размеров компо- 
нента при изменениях размеров окна приложения 


Класс TControl 
Определение 


_ property TSizeConstraints* Constraints 


Описание 

Свойство Constraints является объетом типа TSizeConstraints. Этот объект 
имеет четыре основных свойства: MaxHeight, MaxWidth, MinHeight и 
Min Width — соответственно максимальная высота и ширина и минимальная вы- 
сота и ширина компонента. Тип каждого из этих свойств — TConstraintSize целое 
без знака. 

По умолчанию значения свойств MaxHeight, MaxWidth, MinHeight и 
MinWidth равны 0, что означает отсутствие ограничений. Но задание любому из 
этих свойств положительного значения приводит к соответствующему ограниче- 
нию размера заданным числом пикселей. 

Чтобы какие-то компоненты не исчезали из поля зрения при изменениях 
пользователем или программой размеров окна приложения, можно задать компо- 
нентам ограничения минимальной высоты и длины. Таким образом можно поддер- 
живать нормальные пропорции отдельных частей окна. Можно задать ограниче- 
ния на минимальные и максимальные размеры формы, т.е. всего окна. Например, 
если вы зададите для формы значения MaxHeight = 500 и MaxWidth = 500, то 
пользователь не сможет сделать окно большим, чем квадрат 500 x 500. Причем это 
ограничение будет действовать даже если пользователь нажмет системную кноп- 
ку, разворачивающую окно на весь экран. Окно развернется, но его размеры не 
превысят заданных. Это иногда полезно делать, чтобы развернутое окно не засло- 
нило какие-то другие нужные пользователю окна. 


ControlCount 
- Число дочерних компонентов оконного элемента 
Класс TWinControl 
Доступ только для чтения 


Определение 
_ property int ControlCount 
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Описание 

Свойство ControlCount используется совместно со свойством Controls в итера- 
циях по всем дочерним компонентам данного оконного элемента. Свойство 
Controls, с которым используется ControlCount, дает доступ к дочерним компо- 
нентам. Значение ControlCount всегда на 1 больше последнего индекса дочернего 
компонента, поскольку индексы считаются с 0. ` 

См. примеры в разделе Controls. 


Controls 
Список дочерних компонентов оконного элемента 
Класе TWinControl 
Доступ только для чтения 


Определение 
_ property TControl* Controls[{int Index] 


Описание 

Свойство Controls является массивом всех дочерних компонентов данного 
оконного элемента. Дочерними являются те компоненты, которые расположены в 
клиентской области данного оконного элемента и в свойстве Parent которых ука- 
зан как родитель данный элемент. Параметр Index определяет индекс соответст- 
вующего компонента. Индекс, начинающийся с 0, соответствует положению ком- 
понента в /-последовательности данного родительского элемента. 

Свойство Controls обычно используется в итеративных процедурах групповой 
обработки дочерних компонентов, когда на них неудобно ссылаться по имени. В 
подобных итеративных процедурах обычно используется также свойство 
ControlCount, определяющее число дочерних компонентов. 

Надо четко представлять себе отличие свойства Controls от свойства 
Components. Свойство Components относится не к дочерним компонентам, а к тем, 
которыми владеет данный объект. В частности, всеми компонентами на форме вла- 
деет форма и они. содержатся в ее списке Components. 

Свойство Controls предназначено только для чтения. Оно изменяется (точнее 
меняются индексы компонентов) при изменении 7-последовательности. 

Изменить 7-последовательность в процессе проектирования можно, выполне- 
нием команд Bring To Front или Send То Back. Первая из них пересылает выделенный 
компонент наверх, присваивая ему максимальный индекс, а вторая пересылает 
вниз, присваивая ему минимальный индекс (0 для неоконных компонентов и ми- 
нимально возможный для оконных, поскольку всегда неоконные компоненты име- 
ют индекс меньше оконных). Выполнить эти команды можно или из раздела меню 
Edit, или щелкнув правой кнопкой мыши и выбрав их из всплывающего меню. 

Программно место компонента в Й-последовательности можно изменить мето- 
дами BringToFront и SendToBack. На 7-последовательность влияют также методы 
InsertControl и RemoveControl, добавляющие и удаляющие дочерние компонен- 
ты, и изменение свойства компонентов Parent, меняющее родителя компонента. 


Примеры 
Пусть в приложении в классе формы определена некоторая функция 
void _fastcall Func(TObject *Sender) ; 
которая обрабатывает объект, передаваемый в нее через аргумент Sender. Это мо- 


жет быть какая-то процедура изменения размеров и места расположения, окраши- 
вания, перестановок и т.д. Например, она может содержать оператор 


((TControl *)Sender)->Left += 10; 
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сдвигающий объект на 10 пикселей вправо. Тогда обработать этой процедурой все 
дочерние компоненты, например, панели Panell можно с помощью оператора: 


for(int i = 0; i < Panell->ControlCount; 1++) 
Func (Panell->Controls[i]); 


Если надо обработать только какую-то группу компонентов с идущими по по- 
рядку индексами и известны их начальный и конечный индексы Indl и 1192, то 
соответствующий оператор может иметь вид 

for(int 1 = Indl; i <= Ind2; 1++) 

Func (Panell->Controls[i]); 

Задать нужную последовательность индексов можно описанными выше спосо- 
бами в процессе проектирования или во время выполнения приложения. 

Выяснить истинную последовательность индексов для той же панели Рапе]1 
можно, например, оператором: 

for(int i = 0; i < Panell->ControlCount; 1++) 


ShowMessage ("Ind = "+IntToStr(i) + ' ' + 
Panell->Controls[i]->Name) ; 


ControlState 


Множество значений, характеризующих состояние компонента во время вы- 
полнения приложения 


Классе TControl 


Определение 


enum Controls 7 { csLButtonDown, csClicked, csPalette, 
csReadingState, csAlignmentNeeded, 
csFocusing, csCreating, csPaintCopy, 
csCustomPaint, csDestroyingHandle, 
csDocking }; 


typedef Set<Controls 7, csLButtonDown, csDocking> 
TControlState; 


__ property TControlState ControlState 


Описание 

Свойство ControlState определяет различные условия, действующие на дан- 
ный экземпляр компонента, например, щелчок мыши или необходимость вырав- 
нивания компонента. Свойство используется в основном при создании новых клас- 
сов, производных от TControl. Свойство является множеством типа Set и может 
содержать следующие флаги: 


Состояние Пе mere 
| 
| 


csLButtonDown Левая кнопка мыши нажата, HO еще не освобождена 
| csClicked To же самое, что csLButtonDown, но только в том слу- 
| чае, если свойство компонента ControlStyle содержит 


флаг csClickEvents, означающее, что событие, связанное 
с нажатием кнопки, интерпретируется как щелчок 


| сзРаейе Компонентом или одним из его родителей получено со- 
| общение \УМ_РАГЕТТСНАМСЕО 


| 
| csReadingState Компонент читает свое состояние из потока 
_csAlignmentNeeded Компонент должен осуществить выравнивание 


i 
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м ы ET 


Состояние Пояснение | 


csFocusing Приложение получило сообщение о переключении фоку- | 
са Ha данный компонент. Это не гарантирует, что ком- | 

понент получит фокус, но позволяет предотвратить ре- | 

курсивные вызовы | 

| 

csCreating Создается данный компонент, или ero владелец, или | 
управляемый им компонент. Этот флаг очищается, ког- | 

да создание компонента завершено | 


csPaintCopy Компонент должен быть перерисован. Это состояние воз- | 
можно, если свойство ControlStyle содержит флаг | 

csReplicatable | 

| 

| 


csCustomPaint Компонент обрабатывает сообщения перерисовки | 
csDestroyingHandle |Окно компонента разрушается | 

: | 
csDocking Компонент находится в процессе встраивания | 


Свойство ControlState характеризует He класс в целом, а конкретный объект 
класса. 


ControlStyle 


Множество значений, характеризующих стиль компонента 
Классе TControl 


Определение 


enum Controls _8 { csAcceptsControls, csCaptureMouse, 
csDesigniInteractive, csClickEvents, 
csFramed, csSetCaption, csOpaque, 
csDoubleClicks, csFixedWidth, csFixedHeight, 
csNoDesignVisible, csReplicatable, 
csNoStdEvents, csDisplayDragImage, 
csReflector, csActionClient, csMenuEvents }; 


typedef Set<Controls 8, csAcceptsControls, csMenuEvents> 
TControlStyle; 


' 


__ property TControlStyle ControlStyle” 


Описание 

Свойство ControlStyle определяет различные атрибуты компонента, напри- 
мер, может ли он быть захвачен мышью или имеет ли он фиксированные размеры. 
Свойство используется в основном при создании новых классов, производных от 
TControl. Свойство является множеством типа Set и может содержать следующие 
флаги: 


Флаг Пояснение 
csAcceptsControls |Компонент становится родителем любого компонента, пе- 
ренесенного на него в процессе проектирования 


csDesignInteractive | Компонент устанавливает соответствие во время проекти- 
рования щелчка правой кнопки мыши щелчку левой 
кнопки для манипуляций с компонентом 


csCaptureMouse Компонент перехватывает события мыши после щелчка 
на нем 
| 


33 Зак. 611 
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esClickEvents Компонент получает сообщение о щелчке мыши и реаги- 
рует на него 


csFramed Компонент имеет объемную рамку 


| csSetCaption Компонент должен изменять надпись на нем в соответст- 
вии со свойством Name, если только надпись не задана 
явным образом 


csOpaque Компонент полностью заполняет свою клиентскую 00- 
ласть 


| csDoubleClicks Компонент получает сообщение о двойном щелчке мыши 
и реагирует на него. Если флаг не установлен, то двойной 
щелчок интерпретируется как просто щелчок 


csFixed Width Ширина компонента не меняется и не масштабируется 
csFixedHeight Высота компонента не меняется и HE масштабируется 


csNoDesignVisible | Компонент невидим во время проектирования 


csReplicatable Компонент может копироваться методом PaintTo для про- 
рисовки произвольной канве 


csNoStdEvents Игнорируются стандартные события, такие, как нажатие 

| кнопок мыши, клавиш, щелчки. Этот флаг надо устанав- 
ливать, если ваш код не должен реагировать на эти собы- 
тия; в результате ваше приложение будет выполняться 
быстрее 


| csDisplayDrag- Компонент может отображать изображение из списка 

Image изображений, когда мышь перемещается на него. Этот 
флаг устанавливается, если компонент реализует список 
изображений для отображения при перемещении на него 
мыши 


csReflector Компонент реагирует Ha сообщения Windows, поступаю- 

| щие из диалогов, сообщения о фокусировке, сообщения об 
изменении размеров. Этот флаг устанавливается, если 
компонент может использоваться как элемент ActiveX и 
должен реагировать на эти события 


csActionClient Компонент связан с объектом действия. Этот флаг уста- 
навливается при установке свойства Action и сбрасывает- 
ся при очистке Action 


csMenuEvents Компонент отвечает на команды главного меню во 


Свойство ControlStyle описывает не свойства отдельных экземпляров класса, 
а класс в целом. Флаги не могут изменяться для различных экземпляров компо- 
нентов и не могут изменяться в процессе выполнения приложения. Изменяемые 
характеристики отображаются свойством ControlState. | 

Конструктор класса TControl инициализирует свойство ControlStyle значе- 
ниями [csCaptureMouse, csClickEvents, csSetCaption, csDoubleClicks]. 


CopyMode | 


Определяет режим копирования графического изображения на канву 
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Класс ТСапоаз 


Определение 
_ _ргорегеу int СоруМоае 


Описание 

Свойство канвы CopyMode определяет режим копирования графического изо- 
бражения на канву методом CopyRect или при рисовании объекта TBitmap. Ис- 
пользуя свойство можно достичь различных эффектов объединения изображений 
и их комбинирования. 

Возможны следующие значения свойства CopyMode (используемые константы 
определены в Windows.hpp ): 


cmBlackness Заполняет область канвы, в которую производится копирова- 
ние, черным цветом. Собственное изображение на канве и ко- 
пируемое изображение игнорируются 


cmDstInvert Инвертирует изображение на канве. Копируемое изображение 
игнорируется 


cmMergeCopy Комбинирует изображение канвы и копируемое изображение, 
используя булеву операцию and. То же, что cmSrcAnd 


cmMergePaint —’Комбинирует изображение канвы и инверсию копируемого 
изображения, используя булеву операцию ог 


cmNotSrcCopy Копирует на канву инверсное изображение. Собственное изоб- 
ражение на канве игнорируется 


cmNotSrcErase Комбинирует изображения канвы и копируемого изображе- 
ния, используя булеву операцию ог, а затем инвертирует резу- 
льтат 


cmPatCopy Копирует шаблон источника на канву. Собственное изображе- 
ние на канве игнорируется 


cmPatInvert Комбинирует изображение канвы и шаблон источника, испо- 
льзуя булеву операцию хог 


cmPatPaint Комбинирует инверсное изображение источника и его шаблон, 
используя булеву операцию ог. Затем этот результат комбини- 
рует с изображением канвы, используя булеву операцию ог 


cmSrcAnd Комбинирует изображения канвы и источника, используя бу- 
леву операцию and. To же, что cmMergeCopy 

сш5гсСору Копирует изображение источника на канву. Собственное изоб- 
ражение на канве игнорируется. Этот режим принят по умол- 
чанию 

cmSrcErase Инвертирует изображение на канве и комбинирует результат 


с изображением источника, используя булеву операцию and 


emSrclInvert Комбинирует изображения канвы и иеточника, используя бу- 
леву операцию хог. Повторное копирование восстанавливает 
прежнее изображение на канве 


cmSrcPaint Комбинирует изображения канвы и источника, используя бу- 
леву операцию ог 


cm Whiteness Заполняет область канвы, в которую производится копирова- 
ние, белым цветом. Собственное изображение на канве и ко- 
пируемое изображение игнорируются 
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Примеры 
Операторы 


Imagel->Canvas->CopyMode = cmSrcCopy; 
Imagel->Canvas->CopyRect (Rect (0,0,100,100) , Image2->Canvas, 
Rect (0,0,100,100) ); 


обеспечивают копирование области изображения канвы компонента Image2 на 
канву компонента Imagel. Изображение, которое ранее было на канве компонента 
Imagel, в операциях не участвует. 

Операторы 

Imagel->Canvas->CopyMode = cmSrcInvert; 


Imagel->Canvas->CopyRect (Rect (0,0,100,100) , Image2->Canvas, 
Rect (0,0,100,100)); 


Imagel->Canvas~->CopyRect (Rect (0,0,100,100) ,Image2->Canvas, 
Rect (0,0,100,100)); 


обеспечивают копирование части изображения канвы компонента Image2 Ha KaH- 
ву компонента Imagel в режиме cmSrclInvert. После выполнения функции Сору- 
Rect в первый раз изображения в компонентах Imagel и Image2 налагаются друг 
на друга, а в результате выполнения функции CopyRect во второй раз исходное 
изображение на канве компонента Imagel восстанавливается. 

Операторы 

Imagel->Canvas->CopyMode = cmWhiteness; 


Imagel->Canvas->CopyRect (Rect (0,0,100,100),Image2->Canvas, 
Rect (0,0,100,100)); 


просто очищают указанную область канвы компонента Imagel, закрашивая ee бе- 
лым цветом. При этом изображение в компоненте Image2 никак не участвует в 
операциях копирования. 


Count 


Количество элементов массива указателей, хранящихся в объекте класса 
TList или TStringList 


Классы T List, TStringList, TStrings 
Определение 


_ property int Count 


Описание 

Свойство Count показывает число элементов массива указателей, хранящихся 
в объекте класса TList или TStringList. При добавлении или удалении элементов 
методами Add и Delete значение Count увеличивается или уменьшается автомати- 
чески. Если намеренно увеличить значение Count, то в список добавится соответ- 
ствующее число нулевых указателей NULL. Если намеренно уменьшить значение 
Count, то соответствующее число последних элементов списка будет удалено. 

Значение Count не всегда равно действительному числу указателей на объек- 
ты, хранящихся в списке, поскольку ряд хранящихся в нем указателей могут 
иметь значение NULL, Удалить эти элементы NULL можно методом Pack. 

Свойство Count отличается от близкого ему свойства Capacity. Capacity пока- 
зывает, сколько указателей может храниться в массиве, т.е. емкость списка, а 
Count показывает, сколько указателей в действительности хранится в массиве. 
Поэтому значение Count всегда He больше значения Capacity. 

В классе TStrings Count — это абстрактное свойство, но в его наследниках 
указывает число строк. 
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Пример 
См. пример в разделе Capacity. 


СИЗО 


Определяет, будет ли компонент выглядеть объемным или плоским 
Класс TWinControl 


Определение 
_ property bool Ct13D 


Описание 

Свойство СИЗО определяет внешний вид элемента. Если СИЗО установлено в 
true, элемент выглядит объемным. Если же СИЗО установлено в false, то элемент 
выглядит плоским. По умолчанию Ctl3D равно true. 

Если свойство дочерних компонентов Рагеп СИЗО установлено в true, то из- 
менение свойства СЗО родительского компонента автоматически приводит к из- 
менению свойств СЗО дочерних компонентов. Когда явным образом идет уста- 
новка свойства Ctl3D компонента, его свойство Рагеп СИЗО автоматически уста- 
навливается в false. 

Чтобы свойство СИЗО работало для радиокнопок, индикаторов и любых обыч- 
ных диалогов в системе Windows МТ 3.51, в каталоге System32 должна быть уста- 
новлена библиотека CTL3D32.DLL. Для Windows 95/98 и МТ 4.0 эта библиотека не 
требуется. 


Сиг5ог 


Определяет изображение курсора мыши, когда он расположен в области ком- 
понента 


Класс TControl 


Определение 
enum TCursor {crMin=Ox7fff-1, crMax=Ox7fff}; - 


__ property TCursor Cursor 


Описание 

Изменение изображения курсора мыши при перемещении его в области ком- 
понента указывает пользователю на действия, которые он при этом может совер- 
шить. Имеется еще одно свойство, аналогичное Cursor — свойство DragCursor. 
Оно отвечает за изображение курсора при перемещении его в области компонента в 
процессе перетаскивания. 

Значения свойств Cursor и DragCursor являются индексом списка возможных 
курсоров, управляемого глобальной переменной Screen. Кроме встроенных типов 
курсоров, обеспечиваемых в TScreen, приложение может добавить в список свои 
заказные изображения (см. раздел 4.5.6 главы 4). 

Ниже приводится перечень встроенных в TScreen типов курсоров: 


[Изображение _ Значение Изображение | 
я 


Курсор по умолча- | crHourGlass 
нию. Обычно это 
crArrow. 
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Значение Изображение Значение 
erCross ее 


ст Веат 


| сгб12еМЕЗУ 
| erSizeNWSE 


crHandPoint | 


DesktopFont 


Определяет, использует ли компонент для отображения текста изображение 
шрифта ‘Windows 


Классе TControl 


Определение 
_ property bool DesktopFont 


Описание 

Установка свойства DesktopFont в true определяет, что компонент должен ис- 
пользовать для свойства Еоп изображение шрифта Windows. Этот шрифт задается 
свойством IconFont глобальной переменной Screen. 

Если DesktopFont установлено в true, то свойство Font будет изменяться вся- 
кий раз при изменении шрифта Windows. Это изменение может осуществляться 
заданием свойства IconFont глобальной переменной Screen или изменяться други- 
ми программами. Установка свойства Font напрямую равным Screen->IconFont 
не разрешается. 


DockOrientation 


Определяет, как в рамках технологии Drag&Doc данный компонент будет 
встраиваться в контейнер по отношению к другим встроенным компонентам 


Классе TControl 
Определение 


enum TDockOrientation { doNoOrient, doHorizontal, doVertical }; 
__ property TDockOrientation DockOrientation 


Описание 

Свойство DockOrientation определяет позицию, в которой будет встраиваться 
компонент по отношению к другим встроенным компонентам: doNoOrient — без 
какой-то заданной ориентации, doHorizontal — зоны размещения упорядочивают- 
ся сверху вниз, doVertical — зоны размещения упорядочиваются слева направо. 
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DragCursor 
Cm. Cursor. 


DragKind | 
Определяет, будет ли объект перетаскиваться по технологии Drag&Drop, или 
Drag&Doc 
Класс TControl 


Определение 


enum TDragKind { dkDrag, dkDock }; 
_ property TDragKind DragKind 


Описание 

Свойство DragKind определяет, будет ли компонент перетаскиваться обыч- 
ным образом (по технологии Drag&Drop) — значение dkDrag, или он будет пере- 
таскиваться для встраивания (по технологии Drag& Doc) — значение dkDock. 


DragMode 


Определяет поведение компонента в процессе его перетаскивания 
Классе TControl 


Определение 
enum TDragMode { dmManual, dmAutomatic }; 
__ property TDragMode DragMode 


Описание 
Свойство DragMode определяет поведение компонента в процессе его перетас- 
кивания. Свойство может принимать значения: 


dmAutomatic От программиста не требуется обработка каких-либо событий. 
Компонент готов к перетаскиванию. Пользователю достаточно 
щелкнуть на его изображении и начать перетаскивать 


dmManual Компонент He может быть перетащен, пока приложение не вы- 
зовет метод BeginDrag 


Примеры использования свойства DragMode см. в разделе OnDragDrop. 


DrawingStyle 


Определяет стиль, используемый при рисовании изображения 
Класс TCustomI mageList 


Определение 
enum TDrawingStyle {dsFocus, dsSelected, dsNormal, dsTransparent}; 
__ property TDrawingStyle DrawingStyle 


Описание 
Свойство DrawingStyle определяет стиль изображения. Возможные значения: 


dsFocused Изображение рисуется Ha 25% смешанное с цветом, указанным 
свойством BlendColor. Влияет только на список изображений, 
содержащий маски 

dsSelected Изображение рисуется Ha 50% смешанное с цветом, указанным 


свойством BlendColor. Влияет только на список изображений, 
содержащий маски 
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dsNormal Значение по умолчанию. Изображение рисуется с использова- 
нием цвета, указанного свойством BkColor. Если BkColor зада- 
но равным clNone, изображение рисуется прозрачным с испо- 
льзованием маски 


dsTransparent Изображение рисуется с использованием маски, независимо от 
установки BkColor 


Enabled 


Определяет, реагирует ли компонент Ha события, связанные с мышью, кла- 
виатурой и таймером 


Класе TControl 


Определение 
_ property bool Enabled 


Описание 

Свойство Enabled определяет доступность компонента для пользователя. Что- 
бы сделать компонент недоступным, надо установить Enabled в false. Недоступ- 
ный компонент отображается серым цветом. Он игнорирует события, связанные с. 
мышью, клавиатурой и события таймера OnTimer. 

Чтобы восстановить доступность компонента, надо установить Enabled в true. 
Компонент начинает нормально отображаться на экране и реагировать на действия 
пользователя. 


Font 
Определяет атрибуты шрифта 
Класе TControl 


Определение 
__ property Graphics::TFont* Font 


Описание 

Свойство Font является объектом типа TFont. Изменение шрифта можно осу- 
ществить или созданием нового объекта типа TFont, или изменением свойств 
Color, Height, Name, Pitch, Size, Style существующего объекта. См. подробнее ме- 
тоды свойства и события объекта Font и его установки по умолчанию в разделе 
TFont. 


Примеры 
1. Пусть на форме имеется компонент Memol, в котором расположен некоторый 
текст, и компонент FontDialogl — диалог выбора шрифта. Для того, чтобы 


пользователь мог выбрать имя и атрибуты шрифта текста, отображаемого в 
Мето1, надо вставить в текст оператор: 


if (FontDialogl->Execute() ) 
Memol->Font->Assign (FontDialogl->Font) ; 


Если пользователь сменил атрибуты в диалоговом окне выбора шрифта, TO Me- 
тод Еоп 1а10о#1->Ехесифе() возвращает true и атрибуты шрифта компонента 
Мето1 устанавливаются равными выбранным пользователем. 


2. Аналогичный выбор пользователем шрифта, но уже не для всего текста, а то- 
лько для выделенного фрагмента или для текущего абзаца при использовании 
компонента RichEdit обеспечивается оператором: 


| 


Ре 
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if (FontDialogl->Execute() ) 
RichEdit1l->SelAttributes->Assign (FontDialogl->Font) ; 


3. Для того, чтобы продемонстрировать доступные в системе шрифты, можно по- 
строить форму, содержащую выпадающий список СотфоВох1 и компонент Ме- 
mol с некоторым текстом. Приведенная ниже программа загружает в список 
доступные имена шрифтов и отображает первую строку списка (этот код встав- 
лен в обработчик события формы OnCreate). В обработчик события OnClick 
компонента ComboBox1 вставлен оператор, меняющий подсвойство Name в 
свойстве Font компонента Memol. 


void _fastcall TForml::FormCreate(TObject *Sender) 
{ 

ComboBoxl->Items = Screen->Fonts; 
ComboBox1->ItemIndex = 0; 


} 


void _fastcall TForml::ComboBox1Click(TObject *Sender) 


{ 
Memol->Font->Name = ComboBox1->Items->Strings [ComboBox1->ItemIndex] ; 


} 


4. Для того, чтобы посмотреть влияние Ha отображаемый текст свойства Charset, 
определяющего набор символов шрифта, можно добавить на форму компонент 
редактирования (например, CSpinEdit) и кнопку, в обработчик события OnClick 
которой ввести оператор: 


Memol->Font->Charset = CSpinEdit1l->Value; 


5. Чтобы посмотреть влияние на отображаемый текст свойства Pitch, можно до- 
бавить на форму еще один компонент ComboBox, задать в его свойстве Items 
строки «fpDefault», «fpFixed» и «fpVariable», а в событие OnClick вставить 
код: 


Switch (ComboBox2->ItemIndex) 
{ 


case 0: Memol->Font->Pitch = fpDefault; 
break; 

case 1: Memol->Font->Pitch = fpFixed; 
break; 

case 2: Memol->Font->Pitch = fpVariable; 


GroupIndex — CBOHCTBO разделов меню 


Определяет логическую группу, к которой относится раздел главного меню и 
которая используется при объединении меню нескольких форм 


Класс ТМепи[ ет 


Определение | 
_ property Byte GroupIndex 


Описание 

Свойство GroupIndex определяет способ объединения меню. В MDI приложе- 
ниях меню дочерних форм всегда объединяются с меню родительской формы. В 
приложениях с несколькими формами наличие или отсутствие объединение опре- 
деляется свойством AutoMerge компонента типа TMainMenu. 

По умолчанию все разделы меню имеют одинаковое значение GroupIndex. 
Если требуется объединение меню, то разделам надо задать не убывающие номера 
свойств GroupIndex. Тогда, если разделы встраиваемого меню имеют те же значе- 
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ния, что и какие-то разделы меню основной формы, то эти разделы заменяют соот- 
ветствующие разделы основного меню. В противном случае разделы вспомогатель- 
ного меню встраиваются между элементами основного меню в соответствии с номе- 
рами GroupIndex. Если встраиваемый раздел имеет GroupIndex меньший, чем лю- 
бой из разделов основного меню, то разделы встраиваются в начало. 

Когда активизирован объект, созданный сервером OLE 2.0, сервер может по- 
пытаться объединить свое меню с меню контейнера приложения. Тогда свойство 
GroupIndex используется для замены до трех разделов главного меню. Для заме- 
щения приложение сервера использует следующие предопределенные значения 
GroupIndex: 


Индекс Описание | 


Разделы меню сервера, связанные с редактированием 
активного объекта OLE 


Е. 
ck 


Разделы меню сервера, связанные с отображением ак- 
тивного объекта OLE 


Разделы меню сервера, связанные. с доступом ко встро- 
енной справке 


Свойство GroupIndex может использоваться и еще для одной цели: создания 
группы разделов, работающих по принципам радиокнопок. Для этого во всех раз- 
делах группы надо установить в true свойство Radioltem и задать всем разделам 
одинаковое значение GroupIndex. Выбор пользователем одного из таких разделов 


будет снимать выделение с остальных разделов. 
Примеры использования свойства GroupIndex см. в разделе 3.6.1 главы 3. 


Handle 
Дескриптор окна 
Класс TWinControl 
Определение 
_ property HWND Handle 
Доступ только для чтения 


Описание 

Свойство Handle используется при обращении к функциям API Windows, тре- 
бующим указания дескриптора окна. 

Обращение к свойству Handle приводит к созданию дескриптора, если его не 
было до этого. Поэтому нельзя обращаться к этому свойству при создании компо- 
нента или чтении его из потока. 


Height — свойство компонента 


Определяет высоту компонента или формы в пикселях 
Классе TControl 

Определение 

_ property int Height 


Описание 

Свойство Height определяет вертикальный размер компонента или формы в 
пикселях. Используется для изменения высоты компонента при изменениях раз- 
меров окна приложения. См. разделы ClientHeight, ClientRect. 


Свойства, методы, события, типы, классы 1035 


Height — свойство шрифта | | 


Определяет высоту шрифта в пикселях 
Класс ТРопЁ 


Определение 
_ property int Height 


Описание 

Свойство Height определяет высоту шрифта в пикселях. Если значение Height 
задано отрицательным, то в размер не входит верхний пиксель каждой строки. 

Обычно для задания размера используется не Height, а другое свойство: 
Size — размер шрифта в кеглях или в пунктах, принятых в Windows. 

Значение Height связано со свойствами Size и PixelsPerInch (число пикселей 
на дюйм — см. TFont) соотношением: 


Font->Height = -Font->Size * Font->PixelsPerInch / 72 


Из этого соотношения, в частности, видно, что задание положительного значе- 
ния Size ведет к отрицательному значению Height. Можно задавать Size отрица- 
тельным; тогда Height будет положительным. 


HelpContext 


Определяет индекс, используемый в контекстно-зависимой справке 
Классе TWinControl 


Определение 
_ property Classes::THelpContext HelpContext 


Описание 

Значение HelpContext задается для определения уникального индекса темы 
контекстно-зависимой справки. Экран с этой темой будет показан пользователю, 
если он нажмет клавишу Fl, когда данный компонент в фокусе. 

Если значение НерСощехё равно 0, то компонент наследует значение 
HelpContext своего родительского элемента (элемента-контейнера, в котором OH 
расположен). Например, если задано значение HelpContext для формы, то для 
всех компонентов, у которых не задано отличного от нуля значения HelpContext, 
будет показана тема справки, указанная для формы. Тип THelpContext определен 
в модуле Classes.cpp следующим образом 


typedef int THelpContext; 


Hint 


Содержит текст, отображаемый в окне подсказки или в строке состояния 


Классы TControl, TApplication 


Определение 
_ property AnsiString Hint 


Описание 

Свойство, Hint компонента обеспечивает текст подсказки, появляющийся в яр- 
лычке (всплывающем окне подсказки) или в заданном месте окна, например, в 
строке состояния. | | 

В общем случае Hint состоит из двух частей, разделенных символом верти- 
кальной черты '|'. Первая часть отображается в ярлычке, если пользователь задер- 
жит курсор мыши над данным компонентом (это может быть любой компонент, 
включая разделы меню). Обычно первая часть содержит краткое пояснение компо- 
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нента. В частности; такой подсказкой как правило снабжаются быстрые кнопки 
типа TSpeedButton. Вторая часть содержит текст, отображаемый в какой-то выде- 
ленной для этого части окна, например, в строке состояния. Это обычно разверну- 
Toe пояснение. Например, свойство Hint для быстрой кнопки доступа к разделу 
меню сохранения файла может иметь вид: «Сохранить Сохранение текущего доку- 
мента в файле». Как частный случай, в свойстве Hint может быть задана только 
первая часть подсказки без символа ‘|’. 

Для того, чтобы первая часть подсказки появлялась в ярлычке, когда пользо- 
ватель задержит курсор мыши над данным компонентом, надо сделать следующее: 


1. Указать тексты свойства Hint для всех компонентов, для которых вы хотите 
обеспечить окно подсказки. 


2. Установить свойства ShowHint (показать подсказку) этих компонентов в true 
или установить в true свойство ParentShowHint (ShowHint родителя) и уста- 
новить в true свойство ShowHint контейнера, содержащего данные компонен- 
ты, или формы. 


Конечно, вы можете устанавливать свойства в true или false программно, 
включая и отключая подсказки в различных режимах работы приложения. 

При ShowHint, равном true, ярлычок будет всплывать даже если компонент в 
данный момент недоступен (Enabled = false). 

Если вы не задали значение свойства компонента Hint, но установили в true 
свойство ShowHint или установили в true свойство ParentShowHint, а в родитель- 
ском компоненте ShowHint = true, то в ярлычке будет отображаться текст Hint из 
родительского компонента. J 

Правда, все описанное выше справедливо при значении свойства ShowHint 
приложения (объекта Application), равном true (это значение задано по умолча- 
нию). Если установить Application->ShowHint в false, то ярлычки не будут появ- 
ляться, независимо от значений ShowHint в любых компонентах. 

Для того, чтобы вторая часть сообщения, записанного в Hint, отображалась в 
строке состояния в моменты, когда курсор мыши проходит над компонентом, надо 
использовать обработку события OnHint. Это событие именно приложения Appli- 
cation, а He того компонента, над которым проходит курсор мыши. В C++Builder 5 
его можно перехватить с помощью компонента ApplicationEvents. Если обработ- 
чик этого события определен, то в момент прохождения курсора над компонентом, 
в котором задано свойство Hint, вторая часть сообщения компонента заносится в 
свойство Hint объекта Application. Если свойство Hint компонента содержит толь- 
ко одну часть, то в свойство Hint объекта Application заносится эта первая часть. 
Причем все это делается независимо от состояния свойства компонента ShowHint. 

Третий способ использования свойства Hint компонента заключается в непо- 
средственном отображении текста заключенного в нем сообщения в какой-то метке 
или панели с помощью функций GetShortHint и GetLongHint, первая из которых 
возвращает первую часть сообщения, а вторая — вторую (если второй части нет, то 
возвращается первая часть). 

Примеры использования свойства Hint приведены в главе 4 в разделе 4.1.9. 


HostDockSite 


Определяет контейнер, в который встроен данный компонент 
Класе TControl 


Определение 
_ property TWinControl* HostDockSite 


Свойства, методы, события, типы, классы 1037 


Описание 

Свойство HostDockSite определяет контейнер, в который встроен данный KOM- 
понент. Если компонент находится в состоянии «плавающего» окна, то HostDock- 
Site — временный объект типа FloatingDockSiteClass или NULL. 

Обычно для программного встраивания компонента лучше использовать метод 
ManualDock, а не завдание HostDockSite. Установка HostDockSite приводит к не- 
медленному встраиванию компонента в указанный контейнер, но не устанавлива- 
ет позицию компонента, его выравнивание и не воспроизводит событий встраива- 
ния. 

Для встроенных компонентов значение HostDockSite совпадает со значением 
Parent. Но если компонент никуда не встроен, то HostDockSite = NULL, а Parent 
указывает на контейнер, содержащий данный компонент. 


ImageIndex 


Индекс изображения раздела в списке изображений 

Классы ТМепи ет, TToolButton, Та Пет, TTreeNode, TTabSheet и др. 
Определение | 

_ ргорег®у int ImageIndex 


Описание 

Свойство ImageIndex. указывает индекс изображения, появляющегося левее 
надписи данного раздела меню, на кнопке инструментальной панели, в строке спи- 
ска, узле дерева ит.п. Индекс относится к списку изображений — свойству Images 
компонента-контейнера (родительского меню типа TMenu или TPopupMenu, спи- 
ска, панели ит.п.) и начинается с 0. По умолчанию ImagelIndex = -1, что означает 
отсутствие изображения. 

В компонентах-меню, если не задан список изображений (свойство Images 
равно NULL), то для отображения изображения надо использовать свойство Bit- 
тар компонента типа TMenultem. Ho Bitmap действует только при Images равном 
NULL и отрицательном значении ImageIndex. В противном случае значение Bit- 
тар не принимается во внимание. 


Items — свойство класса TList 


Список ссылок на элементы массива в объекте класса TList 
Класс ТГ131 | 
Определение 


_ property void * Items[int Index] 


Описание 

Свойство Items дает доступ к указателям, хранящимся в объекте класса TList. 
Параметр Index является индексом массива указателей. Индексы изменяются, на- 
чиная с 0 (0 — индекс первого указателя). 

Свойство Items позволяет получить доступ и к объектам, на которые указыва- 
ют элементы массива. Но при этом надо учитывать, что свойство Items имеет тип 
pointer, т.е. является нетипизированным указателем. Такой указатель нельзя ра- 
зыменовать непосредственно. Надо использовать явное или неявное приведение 
типов. Примеры этого даны ниже, а также в разделе TList. 

При организации циклов с просмотром указателей, содержащихся в Items, 
надо иметь в виду, что часть из них может быть равна NULL. Если это может нару- 
шить работу алгоритма, то предварительно надо применить к объекту TList метод 
Pack, который сократит размер массива, удалив из него нулевые указатели. 
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Пример 
// Создание экземпляра списка 
TList *List = new TList;> 


// Создание объектов - строк и занесение их в список: 
List->Add((char *)malloc(10)); 
List->Add((char *)malloc(10)); 


// Задание значений строк через свойство Items 


List->Items[{0] = "aaa"; 
List->Items[1l] = "bbb"; 
// Отображение значений элементов (результат - "ааа" и "bbb") 


for (int i = 0; i < List->Count; i++) 
ShowMessage((char *)List->Items[i]); 


// Удаление из памяти первого элемента 
free (List->Items[0]); 


// Удаление указателя Ha первый элемент списка 
// (второй элемент становится первым) 
List->Delete (0); 


// Отображение значений элементов (результат - "bbb") 
for (int i'= 0; i < List->Count; itt) 
ShowMessage((char *)List->Items[i]); 


Left 


Координата левого края компонента в пикселях 
Класе TControl 


Определение 
_ property int Left 


Описание 

Свойство Left определяет координату левого края компонента в пикселях. 
Для компонентов за начало отсчета берется левая граница клиентской области ро- 
дителя (например, панели, если данный компонент расположен на панели, или 
формы, если компонент расположен непосредственно на форме). Для формы коор- 
дината Left представляет собой горизонтальную координату экрана, отсчитывае- 
мую от его левого края. 

Свойство Left используется при перемещениях и изменениях размеров компо- 
нентов (см. примеры в разделах BoundsRect и Components). 


List 
Указатель на массив указателей в объекте класса TList 


Определение 


typedef void *TPointerList [134217727]; 
typedef TPointerList *PPointerList; 
_ property PPointerList List 


Доступ только для чтения 


Описание 

Свойство List дает непосредственный доступ к массиву Items — массиву ука- 
зателей объекта типа TList. Например, MyList->Items[0] и MyList->List[O] указы- 
вают на один и тот же элемент массива. 


Свойства, методы, события, типы, классы 1039 


Mode — свойство ТРеп 
Определяет режим рисования пером на канве 
Класс ТРеп 


Определение 


enum ТРепМоае {pmBlack, pmWhite, pmNop, pmNot, pmCopy, 
pmNotCopy, pmMergePenNot, pmMaskPenNot, 
pmMergeNotPen, pmMaskNotPen, pmMerge, 
pmNotMerge, pmMask, pmNotMask, pmxXor, pmNotXor}; 


_ property TPenMode Mode 


Описание 

Свойство пера Mode определяет, каким образом взаимодействуют цвета пера и 
канвы. Выбор значения Mode позволяет получать различные эффекты. 

Возможные значения Моде: 


Цвет пикселя 


pmBlack Всегда черный 


Всегда белый 


| ри УВЦе 
| риМор 


Неизменный 


| pmNot - | Инверсный по отношению к цвету фона канвы 


ртСору Цвет, указанный в свойстве Со]ог пера Реп: это значение | 
принято по умолчанию 


| 
| 
| 


pmNotCopy Инверсия цвета пера. 


pmMergePenNot |Комбинация цвета пера и инверсного цвета фона канвы 


| pmMaskPenNot Комбинация цветов, общих для цвета пера и инверсного | 
| цвета фона канвы 


pmMergeNotPen |Комбинация цвета фона канвы и инверсного цвета пера 


pmMaskNotPen Комбинация цветов, общих для цвета фона канвы и инвер- | 
сного цвета пера | 


pmMerge Комбинация цвета пера и цвета фона канвы 


|pmNotMerge 


| 


Инверсия режима pmMerge: комбинации цвета пера и цве- 
та фона канвы 


| pmMask Комбинация цветов, общих для цвета фона канвы и цвета | 

| пера 

pmNotMask Инверсия режима pmMask: комбинации цветов, общих для | 
цвета фона канвы и цвета пера 


ршХог Операция хог: комбинация цветов или пера, или фона кан- | 
вы, но не обоих 


pmNotXor Инверсия режима ршХог: комбинации цветов или пера, 


или фона канвы, но не обоих 


| 

| 

| 

} 

| 
| 

| 

| 


Мате 


Имя компонента, по которому на него ссылаются другие компоненты 
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Класс TComponent 
Определение 


_ property AnsiString Name 


Описание 

Свойство Мате определяет имя компонента, которое используется в дальней- 
шем в программе. Задается только в процессе проектирования и не должно изме- 
няться во время выполнения. Иначе операторы программы могут оказаться непра- 
вильными. 

По умолчанию C++Builder сама присваивает имена компонентам, размещае- 
мым на форме. Эти имена по умолчанию надо изменять в процессе проектирования 
на осмысленные. Иначе при сколько-нибудь сложной форме вы сами через некото- 
poe время не сможете понять, что такое Panel7 или ВиЙоп13. 

Пример использования свойства Name см. в разделе Components. 


Parent 


Определяет родительский компонент, в площади которого располагается дан- 
ный компонент 


Классе TControl 


Определение 
__ property TWinControl* Parent 


Описание 

Свойство Рагепф определяет родительский компонент, т.е. компонет-контей- 
нер, содержащий данный компонент. Контейнерами являются оконные компонен- 
ты, такие, как формы, панели и некоторые другие. Расположенные на них дочер- 
ние компоненты могут наследовать часть свойств содержащего их контейнера, на- 
пример, шрифт, цвет, отображение ярлычков подсказки, трехмерность. Для этого 
должны быть установлены в true свойства дочерних компонентов ParentFont, 
ParentColor, ParentShowHint, Рагеп СИЗО. 

Надо различать два похожих свойства: Parent — родительский компонент, и 
Owner — владелец компонента. Родительский компонент — это TOT, на котором 
располагается данный компонент. А владелец — это компонент, который переда- 
ется в качестве параметра в конструктор данного компонента и который владеет 
им. Форма является владельцем всех расположенных на ней компонентов. В свою 
очередь объект приложения Application является владельцем всех форм. 

Изменение во время выполнения свойства Parent заставляет компонент пере- 
мещаться на экране в клиентскую область нового родителя. 

Если в приложении программно создается новый визуальный компонент, он 
не будет виден, пока в нем не задано значение Parent. 

Пример использования свойства Parent приведен в разделе Visible. 


ParentColor 
См. раздел TControl. 


Рагеп СИЗО 


Определяет наследование свойства объемного изображения от родительского 
компонента | 


Классе TWinControl 


Определение 
_ property bool ParentCt13D 


Свойства, методы, события, типы, классы 1041 


Описание 

Если свойство Рагеп СИЗО имеет значение true, то компонент наследует свой- 
ство СЗО, управляющее объемным или плоским изображением, от своего роди- 
тельского элемента. Это способствует единообразию изображений. Если все компо- 
ненты на форме имеют значение Рагеп СИЗО, равное true, то их вид определяется 
значением СИЗО формы. 

Непосредственное задание свойства СИЗО какому-либо компоненту автомати- 
чески приводит к сбросу Ha false его свойства Рагеп СИЗО. 


ParentFont 
Включает и выключает использование шрифта родительского компонента 
Классе TControl 
Определение 
_ property bool ParentFont 


Описание 

Свойство ParentFont определяет, будет ли для данного компонента использо- 
ваться шрифт (свойство Font) родительского компонента-контейнера. Если устано- 
вить во всех компонентах, размещенных на панели, ParentFont в true, то во всех 
компонентах будет использоваться одинаковый шрифт с одинаковым размером, 
цветом, стилем. Если все компоненты на форме имеют ParentFont, равным true, 
то во всех них атрибуты шрифта определяются свойством Font формы. Тогда, на- 
пример, увеличение размера шрифта у формы приведет к согласованному измене- 
нию размеров шрифта всех размещенных на ней компонентов. 

Если у формы свойство ParentFont тоже установлено в true, то шрифт опреде- 
ляется свойством Font объекта приложения Application. 

При изменении свойства Font в каком-то компоненте, его свойство ParentFont 
автоматически сбрасывается в false. 


ParentShowHint 


Включает и выключает использование родительского свойства ShowHint 
Класе TControl 


Определение 
__ property bool ParentShowHint 


Описание 

Свойство ParentShowHint используется, чтобы иметь возможность одновре- 
менно всем компонентам некоторого контейнера или формы разрешать или запре- 
щать отображение ярлычков (всплывающих окон подсказки) при задержке на них 
курсора мыши. Отображаемый в окнах текст определяется свойствами Hint ком- 
понентов. 

Если свойство ParentShowHint установлено в true, то разрешение или запрет 
отображения ярлычков определяется свойством ShowHint родительского компо- 
нента. Если же свойство ParentShowHint установлено в false, то отображение 
окон подсказки определяется свойством ShowHint самого компонента. 

При задании в компоненте значения ShowHint, равного true, его свойство Ра- 
rentShowHint автоматически сбрасывается в false. 

Управлять отображением окон подсказок всего приложения в целом можно 
также свойством ShowHint объекта Application. 

Подробные пояснения см. в разделе Hint. 
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Реп 


Определяет атрибуты пера, используемого для рисования линий и фигур 
Классе TCanvas 


Определение 
„зрхорегсу Ред“ Fen 


Описание 

Свойство канвы Реп определяет атрибуты пера, используемого для рисования 
линий и фигур. Это свойство является объектом типа ТРеп (см. описание этого 
типа для получения дополнительной информации). Атрибуты объекта типа ТРеп 
определяют цвет, ширину, стиль линий и режим рисования пера. 

Присваивание свойства Реп может производиться методом Assign. 


PenPos 
Определяет положение пера на канве 
Классе TCanvas 


Определение 


_ property Windows::TPoint PenPos 


Описание 

Свойство канвы РепРо$ определяет переменной типа ТРош положение пера 
на канве. Координаты пера, определенные этим свойством, задают начальную точ- 
ку рисования линии методом LineTo. 

Свойство PenPos изменяется методом МоуеТо и некоторыми методами рисова- 
ния (например, методом LineTo). Непосредственная установка PenPos эквивалент- 
на применению метода MoveTo. 


Pitch 
Определяет способ установки ширины символов шрифта 
Классе T'Font 


Определение 


enum TFontPitch { fpDefault, fpVariable, fpFixed }; 
_ property TFontPitch Pitch 


Описание 

Каждый вид шрифта имеет соответствующий способ определения ширины 
символов. Есть шрифты с одинаковой шириной всех символов. Есть шрифты, в ко- 
торых разные символы имеют разную ширину. Шрифты с постоянной шириной 
используются для отображения исходных кодов программ, поскольку в них удоб- 
но делать фиксированные отступы. Но шрифты с различной шириной символов 
выглядят естественнее и более компактны. 

Возможные значения свойства Pitch: 


Ах, 


ее ИИ 


к роивиаояоско ии, они 


fpDefault Ширина устанавливается равной по умолчанию, т.е. описан- 
ной в шрифте заданного вида Мате 

fpFixed Установка одинаковой ширины всех символов 

fp Variable Установка различной ширины символов 


Установка значений fpVariable или fpFixed заставляет Windows искать наи- 
лучший способ удовлетворить всем заданным характеристикам шрифта. Иногда 
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это может привести к замене шрифта на шрифт другого, близкого вида. Но иногда 
может вообще не повлиять на шрифт. Все зависит от конкретного вида шрифта и 
даже от версии этого шрифта. 

См. пример 5 в разделе Font. 


Pixels 


Определяет цвета пикселей канвы в пределах текущей области ClipRect 
Классе ТСапоаз 


Определение 


enum TColor {с1М1п=-Ох7ЕЕЕЕЕЕЕ-1, с1Мах=Ох7ЕЕЕЕЕЕЕ}; 
_ property TColor Pixels[int X][int Y] 


Описание 

Свойство канвы Pixels определяет цвет пикселя канвы с координатами Х и Ув 
пределах текущей области ClipRect. Если заданы координаты пикселя вне области 
ClipRect, то при чтении свойства Pixels возвращается значение -1. 

Задание значений пикселей позволяет рисовать по пикселям графики и ли- 
нии. Определение цвета пикселя используется обычно в методе FillRect. Подроб- 
нее об использовании пикселей см. в главе 5 в разделе 5.1.3. 

Не все устройства поддерживают свойство Pixels. Чтение Pixels для таких уст- 
ройств возвращает -1. Установка Pixels для подобных устройств не дает никаких 
результатов. 


РорирМепи 


Определяет всплывающее меню, связанное с данным компонентом 
Классе TControl 


Определение 
__property Menus::TPopupMenu* PopupMenu 


Описание 

Задание свойства РорирМепи обеспечивает появление всплывающего меню, 
если в то время, когда выбран данный компонент, пользователь щелкнул правой 
кнопкой мыши. Обычно в этом всплывающем меню задаются основные команды, 
относящиеся к данному компоненту. Объект меню имеет тип TPopupMenu. Если в 
этом объекте свойство AutoPopup установлено в true, то меню будет появляться 
автоматически. В противном случае надо отображать меню с помощью метода Рор- 
up класса TPopupMenu. 


ShortCut 


Определяет комбинацию «горячих» клавиш, обеспечивающих быстрый дос- 
туп к разделу меню 


Класс ТМепи ет 


Определение 


typedef Word TShortCut; 
__ property TShortCut ShortCut 


Описание 

Задание свойства ShortCut позволяет пользователю не выбирать данный раз- 
дел из меню, а просто нажать заданную комбинацию «горячих» клавиш. Эта ком- 
бинация при установке ShortCut автоматически появляется в надписи раздела. 

При задании свойства ShortCut во время проектирования Инспектор Объек- 
тов предлагает длинный список возможных комбинаций клавиш. При задании 


1044 | - «Глава 16 


значения ShortCut во время выполнения можно использовать функции ShortCut, 
TextToShortCut, ShortCutToText (см. раздел. 15.7.4 главы 15) 


ShowHint 


Включает или отключает показ ярлычка (всплывающего окна подсказки) при 
задержке курсора мыши над компонентом 


Классы TControl, Application 


Определение 
_ property bool ShowHint 


Описание 

Ярлычок (всплывающее окно подсказки) при задержке курсора мыши над 
компонентом появляется, если свойство компонента ShowHint (показать подсказ- 
ку) установлено в true и задан текст подсказки в свойстве Hint. Правда, и при 
ShowHint = false всплывающее окно подсказки может появляться, если установ- 
лено в true свойство ParentShowHint (взять ShowHint родительского компонен- 
та), а в родительском компоненте ShowHint = true. 

Изменение ShowHint автоматически ставит ParentShowHint в false. 

Свойство ShowHint приложения Application (по умолчанию равно true) опре- 
деляет, могут ли появляться окна подсказки в каких-то компонентах. Если уста- 
новить Application->ShowHint в false, то окна подсказки не будут появляться не- 
зависимо от значений ShowHint в любых компонентах. 

См. подробные пояснения в Hint. 


Showing 
Определяет, виден ли компонент в данный момент 


Классе TWinControl 


Доступ только для чтения 


Определение 
_ property bool Showing 


Описание 

Свойство Showing показывает, может ли пользователь в данный момент ви- 
деть компонент. Правда, при этом не учитывается, что другие компоненты могут 
загородить данный. Поэтому значение Showing, равное true, еще не гарантирует, 
что пользователь действительно видит компонент. Если компонент накрыт другим 
видимым компонентом, то пользователь его все-таки не увидит. 

Если свойство Visible компонента и всех его родителей (компонентов, содер- 
жащих его) равно true, то и Showing равно true. Если же свойство Visible компо- 
нента или какого-то из его родителей равно false, ro Showing равно false. 


Size 
Размер шрифта в кеглях (пунктах) 
Класс TFont 
Определение 
_ property int Size 


Описание 

Свойство Size определяет размер шрифта в кеглях (пунктах, принятых в 
Windows). Если значение Size задано отрицательным, то в размер входит верхний 
пиксель каждой строки. Если значение Size задано положительным, то этот пик- 
сель не учитывается. 
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Для задания размера шрифта может использоваться другое свойство: 
Height — размер шрифта в пикселях. Значение Size связано со свойствами Height 
и PixelsPerInch (число пикселей на дюйм — см. TFont) соотношением: 


Font->Size = -Font->Height * 72 / Font->PixelsPerInch 
Из соотношения, в частности, видно, что задание положительного значения 


Size ведет к отрицательному значению Height. Можно задавать Size отрицатель- 
ным; тогда Height будет положительным. 


Style — свойство TPen | 


Определяет стиль рисования линий пером 
Классе ТРеп 


Определение 


enum TPenStyle {psSolid, psDash, psDot, psDashDot, 
psDashDotDot, psClear, psInsideFrame}; 
__ property TPenStyle Style | 


Описание 
Свойство пера Style определяет вид линии. Это свойство может принимать 
следующие значения: 


psSolid Сплошная линия = 

psDash Штриховая линия 

psDot Пунктирная линия 

psDashDot Штрих-пунктирная линия 

psDashDotDot Линия, чередующая штрих и два пунктира 

psClear Отсутствие линии 

psInsideFrame Сплошная линия, HO при Width > 1 допускающая цвета, 


отличные от палитры Windows 


Примеры линий всех стилей приведены в главе 5 в разделе 5.1.3.3 на рис. 5.8. 

Все стили со штрихами и пунктирами доступны только при Width = 1. В про- 
тивном случае линии этих стилей рисуются как сплошные. 

Стиль psInsideFrame — единственный, который допускает произвольные цве- 
та. Цвет линии при остальных стилях округляется до ближайшего из палитры 
Windows. 


Style — свойство TBrush 


Определяет шаблон заполнения кисти Brush 
Класс T Brush 
Определение 


enum TBrushStyle {bsSolid, bsClear, bsHorizontal, bsVertical, 
bsFDiagonal, bsBDiagonal, bsCross, bsDiagCross}; 
__ property TBrushStyle Style 


Описание 
Свойство кисти Style определяет шаблон, которым рисует кисть Brush, если 
для нее не задано значение свойства Bitmap. 


© 
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Возможные значения Style: 


| Значение Шаблон Значение Шаблон 


ae ae 
т 
| 


pee eT J 


Пример 
Код 


Imagel->Canvas->Brush->Color = clRed; 
Imagel->Canvas->Brush->Style bsDiagCross; 
Imagel->Canvas->Ellipse(0, 0, Imagel->Width, Imagel->Height) ; 


строит на канве компонента Imagel эллипс, заполненный красной штриховкой 
крест на крест. 


Style — свойство TFont 


Стиль шрифта 
Классе T Font 


Определение 


enum TFontStyle { fsBold, fsItalic, fsUnderline, fsStrikeOut }; 
typedef Set<TFontStyle, fsBold, fsStrikeOut> TFontStyles; 


__ property TFontStyles Style 


Описание 

Свойство Style задает стиль: характер начертания символов заданного шриф- 
та. Свойство представляет собой множество типа Set, или пустое, или содержащее 
одно и более следующих значений: 


fsBold 


о iia (ir ся 
| fsUnderline Подчеркнутый 
fsStrikeout = [Перечеркнутый горизонтальной прямой 


TabOrder 
Определяет позицию компонента в последовательности табуляции 
Классе TWinControl 


Определение 


typedef short TTabOrder; 
__ property TTabOrder TabOrder 
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Описание 

' Под последовательностью табуляции понимается последовательность, в кото- 
рой переключается фокус между компонентами окна, когда пользователь последо- 
вательно нажимает клавишу табуляции Tab. Значение Та БОгдег, равное нулю, 03- 
начает, что при первом появлении формы на экране в фокусе будет этот компо- 
нент. 

Последовательность табуляции в каждом приложении надо продумывать, что- 
бы пользователю было легче работать и переходить от одного окна редактирования 
к другому, от одной кнопки к другой. 

Первоначальная последовательность табуляции определяется просто той по- 
следовательностью, в которой размещались управляющие элементы на экране. 
Первому элементу присваивается значение TabOrder, равное 0, второму 1 ит.д. 

Если задать какому то управляющему элементу значение TabOrder, равное -1, 
то этот элемент выпадает из последовательности табуляции и с помощью клавиши 
Tab ему будет невозможно передать фокус. 

Каждый управляющий элемент имеет уникальный номер ТаБОг4ег внутри 
своего родительского компонента. Поэтому изменение значения TabOrder како- 
го-то элемента на уже существующее у другого элемента значение приведет к 
тому, что значения TabOrder всех последующих элементов автоматически изме- 
нятся, чтобы не допустить дублирования. Если задать элементу значение TabOr- 
der, большее, чем число элементов в родительском компоненте, он просто станет 
последним в последовательности табуляции. 

В среде проектирования C++Builder имеется специальная команда Edit | Tab Or- 
der, позволяющая в режиме диалога задать последовательность табуляции всех 
элементов. 

Значение свойства TabOrder играет роль только тогда, когда свойство компо- 
нента TabStop установлено в True и если компонент имеет родителя. Например, 
для формы свойство TabOrder имеет смысл только в случае, если для формы задан 
родитель в виде другой формы. 


TabStop А РАЗЫ ВМ 


Определяет возможность передать фокус на элемент нажатием клавиши табу- 
ляции 


Класс TWinControl 


Определение 
__ property bool TabStop 


Описание 

Свойство TabStop разрешает или запрещает останавливать фокус на данном 
элементе при нажатии пользователем клавиши Tab. Если значение TabStop равно 
true, то клавиша [ab будет передавать фокус на этот элемент в последовательности 
табуляции, определяемой значениями свойства элементов Та БОг4ег. Если значе- 
ние TabStop рвно false, то элемент недостижим в последовательности табуляции 
‚ независимо от значения TabOrder. 

Для формы свойство TabStop имеет смысл только в случае, если форма и имеет 
родителя в виде другой формы. 


ВЕС ESE ФНО SS A De ВВЕСТИ SPCR EL | 
Tag 

Свойство, используемое пользователем по своему усмотрению 

Класс TComponent 


Определение 
_ property int Tag ; 
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Описание 

Свойство Tag системой не используется. Пользователь может определить и ис- 
пользовать его по своему усмотрению, помещая в него необходимую информацию. 
Например, можно в процессе проектирования или программно в процессе выпол- 
нения задать некоторое значение Tag группе компонентов и затем оперировать с 
этой группой. 

Пример использования свойства Tag см. в разделе Components. 


Text 


Текстовая строка, связанная с управляющим элементом 
Kaace TControl 

Определение 

__ property AnsiString Text 


Описание ‹ 

Свойство Text позволяет прочесть или задать строку, связанную с данным 
управляющим элементом. По умолчанию значение Text равно имени компонен- 
та — его свойству Name. Применяется в основном. в компонентах редактирования 
и в списках. 


TextFlags 


Определяет способ вывода текста Ha канву 
Классе TCanvas 

Определение 

_ property int TextFlags 


Описание 

Свойство канвы TextFlags определяет особенности вывода текста на канву Me- 
тодами TextOut и TextRect. Свойство TextFlags может формироваться как целая 
комбинация любых следующих констант: 


| Константа Пояснение 


ЕТО CLIPPED Выводится только текст, помещающийся в указан- 
ной прямоугольной области. В методе TextRect 
этот флаг устанавливается автоматически. На ме- 
Ton TextOut этот флаг не влияет. 


ETO OPAQUE Текст выводится с непрозрачным цветом фона. 


| ETO _RTLREADING Строка текста выводится справа налево. Доступно то- 
| лько с версией Windows Mideast (для стран востока). 


| ETO_GLYPH_INDEX Текст является массивом кодов символов, который 
непосредственно передается GDI Windows. Приме- 
нимо только для шрифтов TrueType, но этот флаг 


можно применять и для других шрифтов, чтобы 
указать, что GDI должен обрабатывать текст на- 
прямую, без языковой обработки. Подробнее см. в 
документации по GDI Windows. 


[ETO _IGNORELANGUAGE | Недокументированный пока флаг Microsoft. 
 ЕТО_ NUMERICSLOCAL |Недокументированный пока флаг Microsoft. | 
| | ETO_NUMERICSLATIN Sif Недокументированный пока флаг Microsoft. ss | 
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Тор | 
Координата верхнего края компонента в пикселях 


Классе TControl 


Определение 
__property int Top 


Описание 

Свойство Тор определяет координату верхнего края компонента в пикселях. 
Для компонентов за начало отсчета берется верхняя граница клиентской области 
родителя (например, панели, если данный компонент расположен на панели, или 
формы, если компонент расположен непосредственно на форме). Отсчет координа- 
ты ведется сверху вниз. Для формы координата Тор представляет собой вертикаль- 
ную координату экрана, отсчитываемую от его верхнего края. 

Свойство Тор используется при перемещениях и изменениях размеров компо- 
нентов (см. примеры в разделах BoundsRect и Components). 


TransparentColor 


Определяет, какой цвет в битовой матрице будет прозрачным при ее рисовании 
Класс ТВитар 
Определение 


__ property TColor TransparentColor 


Описание 

Значение свойства канвы TransparentColor имеет тип TColor и зависит от ус- 
тановки свойства TransparentMode. Если Тгапзрагеп {Моде установлено в tmAu- 
to, то TransparentColor возвращает цвет пикселя левого нижнего угла изображе- 
ния. Если вы задаете значение свойства TransparentColor, то Тгапзрагеп Моде ав- 
томатически устанавливается в tmFixed. При этом новый цвет сохраняется вместе 
с объектом битовой матрицы и может быть использован позднее. Если вы хотите 
отменить заданное значение TransparentColor, установите TransparentMode в 
tmAuto, и тогда TransparentColor опять будет указывать на цвет левого нижнего 
пикселя. 


TransparentMode 


Cm. TransparentColor. 


Visible 
Определяет, видим или невидим компонент 
Классе TControl 


Определение 
_ property bool Visible 


Описание 

Свойство Visible определяет видимость компонента во время выполнения. 
Если Visible делается равным true, то компонент становится видимым; если Vi- 
sible делается равным false, то компонент становится невидимым, исчезает для. 
пользователя. Если устанавливается в false свойство Visible компонента-контей- 
нера, то становятся невидимыми и все расположенные на нем дочерние компонен- 
ты, независимо от значения их свойств Visible. Если свойство Visible ранее неви- 
димого компонента-контейнера устанавливается в фгие, то становятся видимыми и 
все его дочерние компоненты, у которых Visible = true. 
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Свойство Visible позволяет проектировать на одном и том же месте формы не- 
сколько панелей, соответствующих различным режимам работы приложения, и в 
нужные моменты делать одну из них видимой, а остальные невидимыми, как в 
приведенном ниже примере. 

Свойство Visible может также активно использоваться для разделов меню. 
Очевидно, что обычно не все разделы меню имеют смысл при любых режимах ра- 
боты приложения. Ненужные разделы можно делать недоступными задавая значе- 
ния false их свойствам Enabled. В этом случае они будут видны серыми (и недос- 
тупными, но размер меню не изменится. А если их делать невидимыми, то они 
видны не будут, оставшиеся разделы меню сомкнутся и все будет выглядеть более 
компактно. 

Прямое задание значений true и false свойству Visible можно заменить вызо- 
вами методов Show и Hide. Первый из них делает компонент видимым и устанав- 
ливает Visible в true. А второй делает компонент невидимым и устанавливает Vi- 
sible в false. 


Пример 

Пусть в приложении в одном и том же месте формы друг на друге расположе- 
ны две панели: Panell и на ней Panel2, содержащие какие-то управляющие KOM- 
поненты для разных режимов работы. Panel2 расположена на Panell, которая яв- 
ляется, таким образом, ее родителем. В обработчик события формы OnCreate мож- 
но вставить операторы: 


Panel2->Visible = false; 
Panell->Visible = true; 
Panel2->Parent = Forml; 
Panel2->BoundsRect = Panell->BoundsRect; 


Первый два из них делают панель Panel2 невидимой, a Panell — видимой. 
Впрочем можно было бы обойтись и без этих операторов, если задать в процессе 
проектирования значения Visible, равными true для Panell и false для Panel2. 
Третий оператор делает родительским компонентом панели Panel2 форму Еогт1. 
А четвертый оператор задает панели Panel2 то же местоположение и размеры, ко- 
торые имеет панель Panell. Последнее необходимо, поскольку при проектирова- 
нии ее координаты соответствовали координатному пространству контейнера — 
клиентской области панели Panell. А теперь ее родитель сменился на форму, и 
надо ее расположить в том же месте формы, в котором расположена Panell. 

Приведенный код можно сократить, если в процессе проектирования разме- 
щать панель Panel2 не на панели Panell, а в каком-то другом месте непосредствен- 
но на форме, и задать значения Visible, равными true для Panell и false для Panel2. 
Тогда в обработчике события формы OnCreate достаточно одного оператора: 


Panel2->BoundsRect = Panell->BoundsRect; 


изменяющего положение Panel2. 
Аналогичный оператор может быть также реализован методом SetBounds: 


Panel2->SetBounds (Panell->Left, Рапе11->Тор, 
Panell->Width, Panell->Height) ; 


В результате работы одного из приведенных операторов в момент создания 
формы Ha ней будет видна панель Рапе 1. В момент, когда ее надо заменить на Ра- 
nel2, можно выполнить операторы: 


Panell->Visible = false; 
Panel2->Visible = true; 
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делающие невидимой первую и видимой вторую панель. Когда надо вернуть Ha эк- 
ран изображение Рапе!1, можно выполнить операторы: 


Panel2->Visible false; 
Panell->Visible = true; 


Другой способ решения той же задачи приведен в разделе BringToFront. 


Свойства, методы, события, типы, классы 


Width 


‚ Определяет горизонтальный размер компонента или формы в пикселях 
Класс TControl 
Определение 
_ property int Width 
Описание 
Свойство Width определяет горизонтальный размер компонента или формы в 
пикселях. Используется для изменения ширины компонента при изменениях раз- 


меров окна приложения. На компоненты — таблицы во время выполнения измене- 
ние Width не действует. См. разделы ClientWidth, ClientRect. 


WindowText 


Содержит строку текста, связанного с компонентом 
Класс TControl 


Определение 


_ property char* WindowText 


Описание 

Свойство WindowText используется, чтобы связать с компонентом некоторую 
строку текста, которая может заменяться во время выполнения. По умолчанию 
WindowText — та же самая строка, которая записана в свойстве Text. Однако, в 
классах, производных от TControl, это может быть изменено. Для окон редактиро- 
вания эта строка соответствует отображаемому в компоненте тексту. Для выпа- 
дающих списков это текст в окошке редактирования. Для кнопок это имя кнопки. 
Для остальных компонентов это строка заголовка окна. 


16.2 Методы 
аа 


Функция добавляет новый элемент в список 
Классы T List, TStringList, TStrings 
Прототипы 

Для TList: 

int _fastcall Ааа (уо1а * Item); 


для TStrings u_TStringList: 
virtual int fastcall Add(const System::AnsiString 5); / 


> 


Описание 

Функция Add добавляет новый элемент в список. Если список не сортирован- 
ный, то элемент добавляется в конец списка. Если же список сортированный, то 
новый элемент добавляется в позицию, которая определяется сортировкой. Функ- 
ция возвращает индекс добавленного элемента (индекс первого элемента — 0). 
Увеличивает значение свойства Count на 1. Если значение Count равно значению 
Capacity (емкости массива), то увеличивается значение Capacity (с запасом) и пе- 
рераспределяется память под новые элементы. 

Для сортированного списка TStringList при выполнении Add генерируется 
исключение EListError, если строка $ уже имеется в списке и свойство Duplicates 
установлено в dupError. 
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Примеры 
‘1. TList *List = new TList; 


// Создание объекта - строки и занесение ее в список: 
List->Add( (char *)malloc(10)); 


2. TStringList *TL = new TStringList; // Создание списка 


TL->Sorted = true; // Список сортированный 
TL->Duplicates = dupError; // Запрет дубликатов 

ТЬ->Ааа ("Петров"); 

int i = ТЬ->Ааа ("Иванов"); // Т.к. список сортированный, i=0 
TL->Add ("Иванов"); // Генерация исключение из-за дубликата 


В приведенном коде оператор 
int i = ТГЬ->ААа ("Иванов"); 


присваивает переменной 1 значение 0, поскольку список сортированный и фа- 
милия «Иванов» должна размещаться первой, раньше фамилии «Петров». До- 
бавление в сортированный список дубликата вызывает генерацию исключе- 
ния и сообщение: «String list does not allow dubliucates». 


Assign — метод графических объектов 


Копирует изображение одного графического объекта в другой 
Классы ТВИМар, TIcon, TMetaFile, TPicture 
Прототип | 


virtual void _fastcall Assign(Classes::TPersistent * Source); 


Описание 

Метод Assign копирует изображение, содержащееся в объекте Source, в дан- 
ный объект. Типы объектов источника и приемника должны быть одинаковыми. 
Исключение составляет свойство Graphic объекта TPicture. Graphic может участ- 
вовать в обменах изображениями с объектами типов TBitMap, ТШсоп, TMetaFile. 

Объектом копирования для классов TBitMap, ТШсоп, TMetaFile может быть 
также буфер обмена — объект Clipboard. При этом надо не забыть включить в при- 
ложение директиву 


#include <vcl\Clipbrd.hpp>. 

Свойство Graphic объекта TPicture может участвовать только в копировании в 
буфер обмена, но не в копировании из буфера. 

Примеры 


1. Два приведенных ниже оператора делают одно и то же: копируют изображе- 
ние из компонента Image2 в компонент Imagel. Но второй выполняется 
успешно только в том случае, если тип графического объекта в Image2 — 
TBitMap. 


Imagel->Picture->Bitmap->Assign (Image2->Picture->Bitmap) ; 
Imagel->Picture->Bitmap->Assign (Image2->Picture->Graphic) ; 


2. Каждый из приведенных ниже операторов копирует изображение из компо- 
нента Image2 в буфер обмена Clipboard. 


С11рроака () ->А$519дп (Image2->Picture->Bitmap) ; 
Clipboard () ->Assign (Image2->Picture->Graphic) ; 
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3. Приведенный ниже оператор читает изображение из буфера обмена Clipboard 
в компонент Imagel. Если в Clipboard хранится не битовая матрица, будет ге- 
нерироваться исключение. 


Imagel->Picture->Bitmap->Assign(Clipboard()) ; 


\ 


Assign — метод копирования объектов 


Копирует один объект в другой, создавая копию всех данных объекта 


Классы TBlobField, TBrush, TCheckConstraint, TClipboard, TCollection, TColumn, 
TColumnTitle, TControlScrollBar, TCoolBand, TCustomImageList, TDateTimeColors, 
TDimensionItems, TField, TFieldDefs, TFont, THeaderSection, TIndexDefs, TJPEG- 
Image, TListColumn, TListItems, TOleGraphic, TParaAttributes, TParam, TParams, 
TPen, TPersistent, TSmallIntArray, TStatusPanel, TstringGridStrings, TStrings, 
TTextAttributes, TTreeNode, TTreeNodes 


Определение 
<объект-назначение>->Азз4ап (<объект-источник>); 


Описание 

Метод Assign копирует данные одного объекта в другой. Объявлен в классе 
TPersistent и перегружен в классах, производных от него. Некоторое число клас- 
сов C++Builder поддерживает присваивание объектов разных типов. Для большин- 
ства же классов, производных OT TPersistent, применение Assign к несовпадаю- 
щим типам объектов источника и назначения ведет к генерации исключения 
EConvertError. 

Метод Assign отличается по результатам OT операции присваивания 


<объект-назначение> = <объект-источник>; 


При присваивании указатель на <объект-назначение> начинает указывать на 
<объект-источник>. А метод Assign создает новую копию объекта. После применения 
Assign имеется два объекта с одинаковыми данными. 

Если объекты разного типа, то при вызове D->Assign(S) тип О должен 
«знать», как скопировать в него тип $ (тип S может ничего не знать о преобразова- 
нии типов). Если метод Assign не может осуществить преобразование типов, то он 
вызывает защищенный метод AssignTo, объявленный в классе TPersistent и пере- 
груженный в классах, производных OT него. Вызов имеет вид S->AssignTo(D). 
Если и метод AssignTo не может осуществить преобразование или если OH не пере- 
гружен, то вызывается AssignTo класса TPersistent и генерируется исключение. 


Примеры 
1. На форме имеется компонент FontDiaolg1, позволяющий пользователю вы- 


брать вид шрифта для изображения надписей на форме. Тогда обработчик со- 
ответствующего события в разделе меню может иметь вид: 


if (FontDialogl->Execute ()) 
Font->Assign(FontDialogl->Font) ; 


2. В программе объявлено и заполнено два списка $11 и SL2 типа TStringList. 
На форме имеется компонент СопфоВох1, в котором надо отображать один из 
списков 511 или SL2 в зависимости от того, какая кнопка с флажком нажата 
в группе радиокнопок Ка41юоСгоир1. Тогда в событие OnClick этой группы pa- 
диокнопок надо вставить обработчик, показанный ниже. Последний оператор 
ComboBox1->ItemIndex = 0 необходим, чтобы изменение списка сразу отобра- 
зилось на экране. 
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TStringList *SL1 
TStringList *SL2 


new TStringList; 
new TStringList; 


void _ Еаз®са11 TForml::RadioGroup1Click(TObject *Sender) 
{ 
if (RadioGroup1l->ItemIndex == 0) 
ComboBox1->Items->Assign(SLl); 
else ComboBox1l->Items->Assign ($12); 
ComboBox1->ItemiIndex = 0; 
} 


3. Метод Assign позволяет проводить обмен данными между совершенно разно- 
родными компонентами, например, компонентом буфера обмена TClipboard и _ 
графическим объектом TBitmap. Записать изображение в буфер можно опера: | 
тором 


Clipboard()->Assign (Bitmap) ; 


а прочитать из него изображение можно оператором 
Bitmap->Assign (Clipboard()); 


BeginDrag 
Начало процесса перетаскивания компонента 
Классе TControl 


Прототип | 
void _fastcall BeginDrag(bool Immediate, int Threshold) ; 


Описание 

Метод BeginDrag вызывается, когда начинается процесс перетаскивания KOM- 
понента. Его необходимо вызывать только если значение свойства DragMode ком- 
понента равно dmManual. В противном aye процесс перетаскивания произво- 
дится автоматически. ‘ 

Вызов метода BeginDrag целесообразно вставлять в обработчик события On- 
MouseDown. Параметр Immediate (немедленно) определяет, сразу ли после нажа- 
тия кнопки мыши ее указатель изменит вид на тот, который задан свойством 
DragCursor, и сразу ли начнется процесс перетаскивания. Если параметр Immedi- 
ate задан равным false, то указатель мыши не изменяет свой вид и процесс пере- 
таскивания не начинается, пока пользователь не сместит указатель на число пик- 
селей, заданное параметром Threshold. Это позволяет компоненту воспринимать 
щелчок мыши, не начиная операцию перетаскивания. 

Если значение Threshold задано отрицательным (это принято по умолчанию), 
то функция BeginDrag а значение свойства DragThreshold глобальной 
переменной Mouse. 

Пример применения метода см. в разделе OnDragDrop. 


BringToFront 


Перенос компонента на верх /-последовательности 
Класе TControl 

Прототип 

void _fastcall BringToFront (void) ; 


Описание | 
Метод BringToFront позволяет изменять последовательность перекрытия KOM- 
понентов на форме и тем самым управлять видимостью компонентов. 
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Перекрывающиеся компоненты на форме размещаются поверх друг друга в 
так называемой 7-последовательности, соответствующей порядку размещения 
компонентов в процессе проектирования. Например, если вы поместили в одно и 
то же место формы две кнопки одинаковых размеров, то видна будет только вторая 
из размещенных‘ кнопок, поскольку она расположена в /-последовательности 
выше. Применение во время выполнения приложения метода BringToFront к 
нижней кнопке переместит ее наверх в /-последовательности и она станет видна 
пользователю. 

Это справедливо по отношению к неоконным объектам, таким, как кнопки, 
метки, изображения и т.д., а также и к оконным компонентам, таким, как Memo, 
ComboBox и др. Но все неоконные компоненты всегда расположены в 7-последова- 
тельности ниже оконных и метод BringToFront не может изменить это правило. 
Например, попытка перенести наверх методом BringToFront метку, размещенную 
под оконным компонентом, ни к чему не приведет. 


Примеры 

1. Пусть вы хотите, чтобы в каком-то месте формы размещалась кнопка, которая 
в зависимости от текущего режима работы имела бы два различных набора 
свойств и выполняла бы различные функции. Вы можете разместить в нуж- 
ном месте две кнопки друг на друге (пусть они имеют имена Button! и But- 
ton2), задать каждой нужные свойства и для каждой описать соответствую- 
щие обработчики событий. Тогда для смены этих кнопок вы в соответствую- 
щих местах кода программы пишете операторы 


Buttonl->BringToFront(); 


или 


Button2->BringToFront(); 


и пользователь будет видеть то одну, TO другую из этих кнопок. 


2. Пусть в приложении в одном и том же месте формы друг на друге расположе- 
ны две панели: Panell и на ней Panel2, содержащие какие-то управляющие 
компоненты для разных режимов работы. Panel2 расположена на Рапе 1, ко- 
торая является, таким образом, ее родителем. В обработчик события формы 
OnCreate можно вставить операторы: 


Panel2->Parent = Forml; 
Panel2->BoundsRect = Panell->BoundsRect; 
Panell->BringToFront () ; 


Первый оператор делает родительским компонентом панели Panel2 форму 
Form1. Второй оператор задает панели Panel2 то же местоположение и разме- 
ры, которые имеет панель Panell. Последнее необходимо, поскольку при про- 
ектировании ее координаты соответствовали координатному пространству 
контейнера — клиентской области панели Panell. А теперь ее родитель сме- 
нился на форму, и надо ее расположить в том же месте формы, в котором рас- 
положена Рапе!1. Третий оператор перемещает наверх форму Panell. 


Приведенный код можно сократить, и убрать из него первый оператор, если в 
процессе проектирования размещать панель Panel2 не на панели Panell, ав 
каком-то другом месте непосредственно на форме (это, кстати, много удобнее с 
точки зрения проектирования каждой панели). Тогда в обработчике события 
формы OnCreate достаточно двух операторов: 


Panel2->BoundsRect = Panell->BoundsRect; 
Panell->BringToFront () ; 


изменяющих положение Panel2 и перемещающих наверх форму Panell. 
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В результате работы приведенных операторов в момент создания формы на 
ней будет видна панель Рапе! 1, В момент, когда ее надо заменить на Panel2, 
можно выполнить оператор: 


Panel2->BringToFront (); 


выносящий наверх вторую панель. Когда надо вернуть на экран изображение 
Panell, можно выполнить операторы: 


Panell->BringToFront(); 


‚ Аналогичный пример приведен в разделе Visible, но использование метода 
BringToFront делает его более компактным. 


BrushCopy 


Копирует часть изображения битовой матрицы на данную канву, заменяя yKa- 
занный цвет в изображении на значение, установленное для кисти канвы 


‘Класс TCanvas 


Прототип 

void _fastcall BrushCopy(const Windows::TRect &Dest, 
TBitmap* Bitmap, 
const Windows::TRect &Source, 
TColor Color); 


Описание 

Метод BrushCopy копирует часть изображения битовой матрицы компонента 
Bitmap на данную/’канву, заменяя указанный цвет Color в изображении на значе- 
ние, установленное для кисти канвы Brush. Параметр Source указывает копируе- 
мую прямоугольную область в источнике изображения Bitmap. Параметр Dest 
указывает прямоугольную область на канве, в которую производится копирова- 
ние. 

‚Замена цвета делает изображение как бы частично прозрачным, если в пара- 
метре Color указать цвет фона изображения, а в параметре Color кисти Brush кан- 
вы указать цвет фона канвы. 


Пример 
Оператор 


Forml->Canvas->BrushCopy (Rect (10,10,100,100), 
Bitmapl, Rect(10,10,100,100),cl1Black) ; 


копирует прямоугольную область с координатами углов (10, 10) и (100, 100) из 
компонента Bitmapl в аналогичную область канвы формы Forml и заменяет в 
изображении черный цвет на цвет, установленный в свойстве Еогт1->Сап- 
vas->Brush->Color. 


CanFocus 


Определяет, может ли компонент получать сообщения пользователя 
Класе TWinControl 


Прототип 


bool _ Еаз®са11 CanFocus (void) ; 


Описание 

Метод CanFocus определяет, может ли компонент получать сообщения пользо- 
вателя, т.е. может ли он получать фокус. Функция возвращает true, если у компо- 
нента и всех его родителей свойства Visible и Enabled установлены в true. В про- 
тивном случае возвращается false. 


Свойства, методы, события, типы, классы 1057 


ChangeScale 


Изменяет масштаб компонента и его дочерних компонентов 
Классы TControl, TCustomForm, TScrollingWinControl, TWinControl 


Прототип 
DYNAMIC void _fastcall ChangeScale(int М, int р); 


Описание 

Метод ChangeScale используется для изменения масштаба компонента. Mac- 
штабируются такие свойства компонента, как Тор и Left, определяющие его ме- 
стоположение (этим ChangeScale отличается от метода ScaleBy, который He затра- 
гивает Тор и Left), а также Width и Height, определяющие его размер. В классах, 
производных от TControl, в частности, в TWinControl, масштабируются также все 
компоненты, принадлежащие данному компоненту, и их шрифты. 

Параметры М and О определяют соответственно множитель и делитель мас- 
штаба. Например, чтобы уменьшить размеры до 75% начального значения, можно 
задать М равным 75, а D равным 100 (75/100). То же самое можно сделать, задав 
M=3 и D=4 (3/4). Если вы хотите увеличить размер на 1/3, то можно задать М=133 
и D=100 (133/100) или М=4 и О=3 (4/3). 


Chord 


Рисует заполненную замкнутую фигуру, ограниченную дугой окружности или 
эллипса и хордой 


Класс ТСапоаз$ 


Прототип 


void fastcall Chord(int Х1, int Y1, int X2, int Y2, 
ht. Ка. int: У, int. 44, inh Fey; 


Описание 

Метод Chord рисует замкнутую фигуру: дугу окружности или эллипса, замк- 
нутую хордой, с помощью текущих параметров пера Реп. Фигура заполняется те- 
кущим значением Brush. Точки (ХТ, У1) и (X2, У2) определяют прямоугольник, 
описывающий эллипс. Начальная точка дуги определяется пересечением эллипса 
с прямой, проходящей через его центр и точку (X38, У3). Конечная точка дуги оп- 
ределяется пересечением эллипса с прямой, проходящей через его центр и точку 
(X4, У4). Дуга рисуется против часовой стрелки от начальной до конечной точки. 
Хорда соединяет точки (ХЗ, УЗ) и (X4, У4). 

В Windows 95/98 суммы X1 + X2, УТ + У2 и Х1 + Х2 + Y1 + Y2 не должны 
превышать 32768. 

В Windows МТ направление рисования дуги можно изменить на направление 
по часовой стрелке вызовом функции SetArcDirection. 


Примеры 
Операторы 


Imagel->Canvas->Chord(0,0, 200,200, 200,0, 0,0); 
Image2->Canvas->Chord(0,0, 200,200, 0,0, 200,0); 


дают результат, показанный на рисунке. 


$4 чак 322 
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Chord(0,0, 200,200, 200,0, 0,0) - Chord(0,0, 200,200, 0,0, 200,0] 


ClassName 


Возвращает имя типа объекта 
Класе TObject 


Определение 
static ShortString __fastcall,ClassName(TClass cls); 


Описание 

Метод ClassName возвращает имя действительного типа объекта. Например, 
переменная типа класса-предка может ссылаться на экземпляр любого типа-по- 
томка. В этом случае ClassName возвращает имя реального типа объекта, а не 
того, которое было объявлено для этой ссылки. Например, оператор 


catch (Exceptioné Е) 
{ 


ShowMessage ("Возникло исключение "+E.ClassName()); 


} 


перехватит все исключения и отобразит сообщение с именем действительно CreHe- 
рированного исключения. Впрочем, в данной ситуации лучше применить оператор 


catch (Exceptioné& Е) 
{ 


ShowMessage ("Возникло исключение "+E.Message) ; 


} 
который отобразит пользователю не класс исключения, а сообщение этого класса. 


Clear 


Очистка списков 


Классы TClipboard, TList, TStringList, TStrings, TComboBox, TDBCombobox, 
TDBEdit, TDBListBox, TDBMemo, TDirectoryListBox, TDriveComboBox, TEdit, TFi- 
leListBox, TListBox, TMaskEdit, TMemo, TOutline и ряд других 


Определение 
DYNAMIC void _ fastcall Clear(void); 


Описание 

Для перечисленных выше объектов и компонентов процедура Clear удаляет 
все элементы списков или весь текст. Для некоторых других объектов аналогич- 
ная процедура действует несколько иначе. 

Для объекта Clipboard процедура Clear удаляет все содержимое буфера Clip- 
board. Впрочем, то же самое происходит автоматически при каждом обновлении 
содержимого буфера (при выполнении операций вырезать и копировать — Cut и 


Сору). 
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ClientToScreen 
Преобразует координаты клиентской области в координаты экрана 
Класе TControl 


Определение 


struct TPoint 


{ 
еси; 
int У; 
}; 


Windows::TPoint _fastcall ClientToScreen ( 
const Windows::TPoint &Point); 


Описание 

Метод ClientToScreen преобразует координаты точки в системе координат 
клиентской области компонента (начало координат — левый верхний угол клиент- 
ской области) в систему координат экрана (начало координат — левый верхний 
угол экрана). 

Совместно с обратной функцией ScreenToClient метод может использоваться 
для пересчета координат точки экрана из системы координат клиентской области 
одного компонента в систему координат клиентской области другого компонента. 

Пример 

Р = Comp2->ScreenToClient (Compl->ClientToScreen(P)); 

Оператор пересчитывает координату точки экрана Р из системы коодинат ком- 
понента Compl в систему координат компонента Comp2. 


ContainsControl 


Определяет, является ли указанный компонент прямым или косвенным на- 
следником данного оконного компонента 


Классе TWinControl 
Прототип 
bool _fastcall ContainsControl(TControl* Control); 


Описание 

Метод ContainsControl позволяет определить, является ли компонент, указан- 
ный параметром Control, наследником данного оконного компонента. Метод воз- 
вращает true не только, если в свойстве Controls компонента Control указан в ка- 
честве родителя данный компонент, но иесли он является прямым или косвенным 
потомком какого-то из дочерних компонентов данного оконного компонента. 


ControlAtPos 
Определяет, какой дочерний компонент имеется в указанной позиции 
Классе TWinControl 


Прототип 


struct TPoint 
{ 


а. Ses 
ADE tive 
}; 


fControl*  fastcall ControlAtPos(const Windows::TPoint &Pos, 
bool AllowDisabled) ; 
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= 


Описание 

Метод ControlAtPos позволяет определить, какой дочерний компонент данно- 
го оконного элемента имеется в позиции с координатами, указанными параметром 
Pos. Возвращается только непосредственно дочерний компонент, т.е. такой, в чьем 
свойстве Parent указан данный оконный элемент и который поэтому входит в спи- 
сок дочерних компонентов, содержащийся в свойстве Controls оконного элемента. 

Позиция Pos может находиться в любом месте внутри дочернего компонента. 
Если заданная позиция не соответствует никакому дочернему компоненту, то 
функция ControlAtPos возвращает NULL. 

Параметр AllowDisabled определяет, учитываются ли при поиске компонен- 
ты, которые находятся в недоступном состоянии. 


CopyRect 


Копирует часть изображения с другой канвы Ha данную 
Класс TCanvas 


Прототип 


void _fastcall СоруВесе (соп5Е Windows::TRect &Dest, 
TCanvas* Canvas, const Windows::TRect &Source) ; 


Описание 

Метод CopyRect переносит указанную параметром Source область изображе- 
ния в канве источника изображения Canvas в указанную параметром Dest область 
данного объекта ТСапуа$. Копирование производится в режиме, установленном 
свойством Моде. 


Пример 
Оператор 
Imagel->Canvas->CopyRect (MyRect2, Bitmap->Canvas,MyRectl) ; 


копирует на канву компонента Imagel в область MyRect2 изображение из области 
MyRectl канвы компонента Bitmap. \ 


DbIClick а 
См. раздел TControl. 
Delete 


Удаление элемента с указанным индексом из списка 
Классы T'List, TStringList, TStrings, TMenuItem 


Объявление 


void _fastcall Delete(int Тпаех); 


Описание 

Процедура Delete удаляет из списка элемент с указанным индексом. Во всех 
случаях индексы считаются, начиная с 0 (0 — индекс первого элемента). 

Из списка строк строка удаляется вместе со ссылкой на связанный с ней объект. 

Удаление элемента меню ведет к удалению и связанного с ним подменю (если 
таковое имеется). 

После удаления элемента список перестраивается. Это надо учитывать при 
удалении элементов в цикле, как указано в приведенном примере. 


Пример 


for (Т`=.0О;-тТ <= 1; I++) 
List->Delete (0); 
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В этом примере удаляются два первых элемента списка List. Неверно было бы 
написать: 


for (I = 0; I <= 1; I++) 
List->Delete (I); 


Так как после первого удаления список перестроится, то элементом с индек- 
сом 1 станет тот, который ранее имел индекс 2. Таким образом, в результате оказа- 
лись бы удаленными элементы, имевшие в первоначальном списке индексы 0 и 2. 


DisableAlign 


Временно запрещает выравнивание дочерних компонентов 
Классе TWinControl 


Определение 
void _ fastcall DisableAlign (уо1а); 


Описание 

Свойство DisableAlign временно запрещает выравнивание дочерних компо- 
нентов внутри оконного элемента - изменение их свойств Align не приводит к их 
перестроению. Метод применяется совместно с методом EnableAlign, отменяющим 
действие DisableAlign и разрешающим выравнивание. 

Эти методы целесообразно использовать, если проводится перестроение ряда 
дочерних компонентов, например, при чтении их из файла формы, при масштаби- 
ровании, при изменении взаимного расположения. 

Каждому вызову DisableAlign должен соответствовать вызов EnableAlign. 
Очередной вызов DisableAlign увеличивает на единицу число запретов выравнива- 
ния, а вызов EnableAlign уменьшает это число. Как только при очередном вызове 
EnableAlign число запретов станет равным нулю, произойдет выравнивание. Это 
производится вызовом метода Realign. 


Пример 


Forml->DisableAlign () 
<операторы перестроения дочерних компонентов> 
Forml->EnableAlign () 


Dormant 


Создает изображение битовой матрицы в памяти, чтобы освободить дескрип- 
тор матрицы и сэкономить ресурсы 


Класс T Bitmap 


Прототип 


void _fastcall Dormant (void); 


Описание 

Использование метода Dormant сокращает ресурсы GDI, используемые в при- 
ложении. Метод создает изображение матрицы в памяти, используя объект потока 
памяти. В дальнейшем через свойство Handle можно освободить связанный с мат- 
рицей HBITMAP. 

Дополнительную экономию памяти можно получить методом FreeImage, oc- 
вобождающим память, занятую кэшированием изображения. Но этот метод может 
приводить к потере глубины цвета. 


Пример 


void _fastcall TForml::Button1lClick(TObject *Sender) 


{ 
Graphics::TBitmap *BitMapl = new Graphics::TBitmap(); 
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Graphics::TBitmap *BitMap2 = new Graphics::TBitmap(); 


try 

{ 

// загрузка изображения из файла в BitMapl 
BitMapl->LoadFromFile("..."); 

// копирование в BitMap2 us BitMapl 
BitMap2->Assign (BitMapl1) ; 

// освобождение ресурсов GDI 
BitMap2->Dormant () ; 

// освобождение памяти, изображение не теряется 
BitMap2->Freelmage (); 

// изображение из BitMap2 рисуется на канве 
Canvas->Draw(20,20,BitMap2) ; 

// устанавливается монохромный режим BitMap2 
// BitMap2->Monochrome = true; 

// рисуется монохромный вариант 

Сапуаз->Огам (250,20, В1ЕМар2); 

// теперь изображение действительно теряется 
BitMap2->ReleaseHandle() ; 

} 

Gatcn: |...) 

{ 

MessageBeep (0); 

} 

delete BitMapl1; 

delete BitMap2; 

} 


Draw 


Рисует графическое изображение в указанную позицию канвы 


$ 


Класс TCanvas 
Прототип 
void _fastcall Draw(int X, int У, TGraphic* Graphic); 


Описание 

Метод Огам рисует изображение, содержащееся в объекте, указанном парамет- 
pom Graphic, сохраняя исходный размер изображения в его источнике и перенося 
изображение в область канвы объекта. Верхний левый угол этой области определя- 
ется параметрами Х и У. Источник изображения может быть битовой матрицей, 
пиктограммой или метафайлом. Если источник — объект типа ТВ тар, то перенос 
изображения производится в режиме, установленном свойством канвы CopyMode. 

Пример 

Оператор 

Imagel->Canvas->Draw(10,10, Bitmapl); 
рисует на канве компонента Imagel изображение из компонента Bitmap! в об- 
ласть с координатами левого верхнего угла (10, 10). 


DrawFocusRect 


_ Рисует изображение прямоугольника в виде, используемом для отображения 
рамки фокуса, операцией хог 


Класс ТСапоаз 
Прототип 


void _fastcall DrawFocusRect (const Windows::TRect &Rect); 
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Описание 

Метод DrawFocusRect рисует на канве в области Rect изображение прямо- 
угольника в виде, используемом обычно для отображения рамки фокуса, т.е. точ- 
ками. При рисовании используется операция хог, что позволяет удалить изобра- 
жение прямоугольника его повторной прорисовкой. 


Пример 

Следующая совокупность обработчиков событий, связанных с мышью, рисует 
на канве компонента Imagl прямоугольную рамку размером 10 на 10 вокруг кур- 
сора и перетаскивает ее при перемещении мыши с нажатой кнопкой: 


тре. ХО, Te} 
bool drag = false; 


void _fastcall TForml::ImagelMouseDown(TObject *Sender, 
TMouseButton Button, TShiftState Shift, int X, int Y) 

{ 

// рисование рамки 
Imagel->Canvas->DrawFocusRect (Rect (X-5, Y-5, X+5, Y+5) ); 

// запоминание координат курсора 

XO = X; 

¥O = ¥% 

// включение флажка режима перемещения рамки 

drag = true; 

} 

hemes aR SCP ESR EIU TEE ate EE, 0 ee 
void _fastcall TForml::ImagelMouseMove (TObject *Sender, 

TShifttState Shift, int Х, 309 

{ 

if( !drag) return; 
// стирание рамки 
Imagel->Canvas->DrawFocusRect (Rect (X0-5, YO-5, X0+5, Y0+5)); 
// рисование рамки 
Imagel->Canvas->DrawFocusRect (Rect (X-5, Y-5, X+5, Y+5) ); 
// запоминание координат курсора 


XO = X; 
YQ № т. 
} 

ff 


void _fastcall TForml::ImagelMouseUp(TObject *Sender, 
TMouseButton Button, TShiftState Shift, int X, int Y) 

{ 

if( !drag) return; 

// стирание рамки 
Imagel->Canvas->DrawFocusRect (Rect (X0-5, YO-5, X0+5, YO+5) ); 
// выключение флажка режима перемещения рамки 

drag = false; 

} 


При нажатии кнопки мыши рисуется первая рамка, запоминаются координаты 
курсора и включается режим перемещения рамки (переменная drag = true). При пе- 
ремещении мыши в режиме перемещения рамки стирается прежняя рамка, рисует- 
ся рамка в новой позиции и запоминаются новые координаты курсора. При отпуска- 
нии кнопки мыши стирается рамка и выключается режим перемещения рамки. 


Ellipse 
Рисует заполненную окружность или эллипс 
Класс TCanvas 


Прототип 
void . fastcall Ellipse(int:X1, int Yl, int Ха, int. 2); 
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Описание 

Метод Ellipse рисует окружность или эллипс с помощью текущих параметров 
пера Реп. Фигура заполняется текущим значением Brush. Точки (ХТ, Y1) и (X2, 
Y2) определяют прямоугольник, описывающий эллипс. 

В Windows 95/98 суммы X1 + X2, У1 + У2 и Х1 + Ха + Y1 + Y2 не должны 
превышать 32768. 


Пример 
Оператор | 
Imagel->Canvas->Brush->Color = clRed; 


Imagel->Canvas->Brush->Style bsDiagCross; 
Imagel->Canvas->Ellipse(0, 0, Imagel->Width, Imagel->Height) ; 


рисует эллипс, вписанный в компонент Imagel и заполненный красной штрихов- 
кой. 


EnableAlign 
См. DisableAlign 


Exchange 


Меняет позиции двух элементов списка 
Классы T List, TStringList, Tstrings 


Прототипы 
Для TList: 


void  fastcall Exchange(int Indexl, int Тпаех2); 


для TStrings и TStringList: 


virtual void _fastcall Exchange(int Тпаех1, int Тпаех2); 


Описание 

При вызове Exchange два элемента списка с позициями 114ех1 и Index2 обме- 
ниваются местами. Индексы позиций начинаются с 0 (0 — первый элемент). 

Если в списках строк со строками связаны объекты, они остаются связанными 
с теми же строками в их новых позициях. 

Не применяйте метод Exchange к сортированным спискам TStringList, за uc- 
ключением случая взаимного перемещения двух одинаковых строк, связанных с 
разными объектами. Дело в том, что метод Exchange не проверяет условий сорти- 
ровки и может нарушить упорядоченность списка. 

Пример 

Пусть список List типа TList содержит указатели на целые числа. Тогда при- 
веденная ниже программа перемещает на первое место указатель на минимальное 
число (это один шаг пузырьковой сортировки). 

for(int 1 = 1;,.i-<-.List->Count;..i++) 

if(*((int *)List->Items[0]) > *((int *)List->Items[i]}) ) 
List->Exchange(0, i); 


Полностью пузырьковая сортировка списка указателей на целые числа реали- 
зуется вложенными циклами: 
for(int 3 = 0; 3 < List->Count-1; j++) 
for(int т = y% i < List->Count; i++) 
if (*((int *)List->Items[j]) > *((int *)List->Items[i]) ) 
List->Exchange(j, i); 
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Ехрапа , 
Увеличивает емкость списка типа TList 
Классе T List 


Прототип 
TList*  fastcall Ехрапа (уо1а); 


Описание 

Метод Expand увеличивает емкость списка типа TList, выделяя память для 
быстрого размещения новых элементов. Тем самым экономится время при добав- 
лении в дальнейшем новых элементов списка. 

Поскольку функция возвращает расширенный список, то ее можно также ис- 
пользовать для создания дубликата имеющегося списка. 

Если список не заполнен, т.е. количество элементов Count меньше емкости 
списка Capacity, то список не расширяется. Если же Count = Capacity, то функция 
Expand увеличивает емкость Capacity согласно следующему алгоритму. Если зна- 
чение Capacity меньше 4, то Capacity увеличивается на 4. Если значение Capacity 
больше 4, но меньше 9, то Capacity увеличивается на 8. Если значение Capacity 
больше 8, то Capacity увеличивается на 16. 


_ Примеры 
1. List->Expand(); 
Если список List заполнен не до конца, он остается неизменным. Если же он 
заполнен, то его емкость расширяется. 
2. 1131 = List->Expand(); 


Создается объект Listl, являющийся копией списка List. Если исходный спи- 
сок был заполнен, то оба списка List и 11$1оказываются расширенными. 


FillRect 


Заполняет указанный прямоугольник канвы, используя текущее значение 
Brush ; 


Классе TCanvas 
Прототип 
void _fastcall FillRect (const Windows::TRect &Вес®); 


Описание 

Метод ЕШКВес заполняет прямоугольник канвы, указанный параметром 
Rect, используя текущее значение кисти Brush. Заполняемая область включает 
верхнюю и левую стороны прямоугольника, но не включает правую и нижнюю 
стороны. При использовании FillRect параметр Rect часто задается функцией 
Rect (см. раздел 15.3.3 главы 15). 


Пример 
Оператор 


Imagel->Canvas->FillRect (Rect (0,0, Imagel->Width, 
Imagel->Height) ); 


очищает всю канву компонента Imagel, заполняя ее фоном, если он установлен в 
свойстве Brush. 


< 


1066 Глава 16 


FindNextControl 


Возвращает следующий в последовательности табуляции оконный дочерний 
компонент 
Класс TWinControl 


Определение 


TWinControl* _fastcall FindNextControl ( 
TWinControl* CurControl, bool GoForward, 
bool CheckTabStop, bool CheckParent) ; 


Описание 

Метод FindNextControl находит и возвращает следующий за указанным в па- 
раметре CurControl дочерний оконный компонент в соответствии с последователь- 
ностью табуляции. Если CurControl не является дочерним компонентом данного 
оконного элемента, то возвращается компонент, первый в последовательности та- 
буляции. То же самое происходит, если CurControl является последним компонен- 
том в последовательности табуляции. 

Параметр GoForward определяет направление поиска. Если он равен true, то 
поиск проводится вперед и возвращается компонент, следующий за CurControl. 
Если же параметр GoForward равен false, то возвращается предшествующий ком- 
понент. 

Параметры CheckTabStop и CheckParent определяют условия поиска. Если 
CheckTabStop равен true, то просматриваются только компоненты, в которых 
свойство TabStop установлено в true. При CheckTabStop равном false значение 
TabStop не принимается во внимание. Если параметр CheckParent равен true, то 
просматриваются только компоненты, в свойстве Parent которых указан данный 
оконный элемент, т.е. просматриваются только прямые потомки. Если Check- 
Parent равен false, то просматриваются все, даже косвенные потомки данного эле- 
мента. 

Метод FindNextControl вызывает метод GetTabOrderList и из полученного та- 
ким способом списка черпает последовательность компонентов. 


Примеры 

TWinControl *obj; 

for(int i = 0; i < Forml->ControlCount; 1++) 
{ 


obj = Forml->FindNextControl(obj,true, true, true); 


} 


В этом примере переменная Obj поочередно принимает значение всех прямых 
наследников формы Когт1, включенных в последовательность табуляции, т.е. 
имеющих свойство TabStop равным true. Например, в эту последовательность 
войдут окна редактирования, кнопки, панели, расположенные непосредственно на 
форме и имеющие TabStop равным true, но не войдут кнопки и окна редактирова- 
ния, расположенные на панелях. 

Если в приведенном операторе изменить параметр CheckParent на false: 


obj = Forml->FindNextControl(obj,true, true, false); 
то в последовательность войдут и непрямые наследники, имеющие TabStop рав- 
ным true, в частности, компоненты, содержащиеся в панелях, расположенных на 


форме, причем независимо от значения TabStop этих панелей. 
Если в приведенном операторе изменить параметр CheckTabStop на false: 


obj = Forml->FindNextControl(obj,true, false, false); 


то в последовательность войдут компоненты, независимо от значения их свойства 
TabStop. 
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FloodFill 


Закрашивает текущей кистью замкнутую область канвы, определенную yKa- 
занным цветом 


Класс TCanvas 


Прототип 


enum TFillStyle {fsSurface, fsBorder}; 
void  fastcall FloodFill(int X, int У, TColor Color, 
TFillStyle FillStyle); 


Описание 

Метод FloodFill закрашивает текущей кистью Brush замкнутую область кан- 
вы, определенную цветом и начальной точкой закрашивания (Х, У). Точка с коор- 
динатами Х и У является произвольной внутренней точкой заполняемой области, 
которая может иметь произвольную форму. Граница этой области определяется со- 
четанием параметров Color и FillStyle. Параметр Color типа TColor указывает 
цвет, который используется при определении границы закрашиваемой области, а 
параметр FillStyle определяет, как именно по этому цвету определяется граница. 
Если FillStyle = fsSurface, то заполняется область, окрашенная цветом Color, а на 
других цветах метод останавливается. Если FillStyle = fsBorder, то наоборот, за- 
полняется область окрашенная любыми цветами, не равными Color, а на цвете 
Со]ог метод останавливается. 


Примеры 


са 


Imagel->Canvas->Brush->Color = clWhite; 


Imagel->Canvas->FloodFill (X,Y, 
Imagel->Canvas->Pixels[X] [Y],fsSurface) ; 


Приведенные операторы закрашивают белым цветом на канве компонента 
Imagel все пиксели, прилегающие к пикселю с координатами (Х, У) и имею- 
щие тот же цвет, что и этот пиксель. Например, если вы вставите эти операто- 
ры в обработчик щелчка OnClick компонента Imagel, то пикселем, определя- 
ющим закраску, будет пиксель той точки, в которой пользователь щелкнул на 
изображении. 


pe 


Imagel->Canvas->Brush->Color = clWhite; 

Imagel->Canvas->FloodFill(X, У, clBlack, fsBorder); 

Приведенные операторы закрашивают белым цветом на канве компонента 
Imagel все пиксели, прилегающие к пикселю с координатами (Х, У) и имею- 


щие цвет, отличный от черного. При достижении черной границы области за- 
краска останавливается. 


Focused 


Определяет, находится ли оконный элемент в фокусе 
Классе TWinControl 


Определение 
DYNAMIC bool fastcall Focused(void); 


Описание 

Метод Focused определяет, является ли оконный элемент активным, т.е. нахо- 
дится ли он в фокусе. Возвращает true, если элемент находится в фокусе, и false — 
если элемент не в фокусе и пользователь в данный момент не может с ним взаимо- 
действовать. 
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FrameRect 
Рисует Ha канве текущей кистью прямоугольную рамку 
Класс ТСапоаз 


Прототип 
void _fastcall FrameRect (const Windows::TRect &Rect); 


Описание 

Метод FrameRect рисует на канве прямоугольную рамку вокруг области Rect, 
используя установку текущей кисти Brush. Толщина рамки — 1 пиксель. Область 
внутри рамки кистью не заполняется. Отличается от метода Rectangle тем, что 
рамка рисуется цветом кисти (в методе Rectangle — цветом пера Реп) и область не 
закрашивается (в методе Rectangle закрашивается). 


Пример 
Оператор 


Imagel->Canvas->Brush->Color = clBlack; 
Imagel->Canvas->FrameRect (Rect (10,10,100,100)); 


рисует на канве компонента Imagel черную рамку. | 


Егее 
Вызывает деструктор объекта и освобождает память 
Класе TObject 
Прототип 
__ fastcall Free(); 


Описание 

Функцию Егее не следует применять непосредственно для освобождения па- 
MATH, динамически выделенной под объект, который уже не нужен для дальней- 
шей работы программы. Вместо этого следует использовать ключевое слово delete, 
по которому автоматически вызывается функция Free. 

Функцию Егее проверяет, не была ли ранее уже освобождена выделенная под 
объект память и вообще был ли данный объект создан (не равен ли указатель на 
объект NULL). После этого вызывается деструктор данного объекта. 


GetTabOrderList 


Строит список дочерних оконных компонентов в последовательности табуляции 
Класс TWinControl | 
Определение 

DYNAMIC void _fastcall GetTabOrderList(Classes::TList* List); 


Описание 

Метод GetTabOrderList строит список List типа TList дочерних оконных ком- 
понентов в последовательности табуляции. В список входят не только непосредст- 
венные потомки данного элемента, но и косвенные потомки, включенные в дочер- 
ние контейнеры. При этом не обращается внимание на значение свойства TabStop 
включаемых компонентов. 

Метод GetTabOrderList вызывается методом FindNextControl, определяю- 
щим последующий или предшествующий компонент в списке табуляции. 


Пример 
Приведенные ниже операторы опбеспечивают поочередный доступ ко всем до- 
черним оконным компонентам в последовательности табуляции. 
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TWinControl *obj; 
TList *List = new TList; 


GetTabOrderList (List); 


for(int 1 = 0; i < List->Count; itt) 
{ 

// Поочередный доступ к объектам 

obj = (TWinControl *)List->Items[i]; 


} 


HandleAllocated 


Проверяет наличие дескриптора окна компонента 
Класс TWinControl 

Определение 

bool _fastcall HandleAllocated (void) ; 


Описание 

Метод HandleAllocated используется для определения, имеется ли дескриптор 
окна у данного элемента. Если дескриптор имеется, то возвращается true. 

Непосредственная проверка свойства Handle приводит к тому, что даже если 
дескриптора не было, он создается. Применение HandleAllocated позволяет опре- 
делить наличие дескриптора без этого побочного эффекта. 


HandleNeeded 


Создает дескриптор окна, если до этого он не существовал 
Класс TWinControl 

Определение 

void _fastcall Напа1еМеедеа (уо1а); 


Описание 

Метод HandleNeeded создает дескриптор окна, если до этого его не было. При 
создании дескриптора он прежде всего вызывает метод CreateHandle родительско- 
го элемента, а уже затем создает дескриптор данного элемента. 


Hide 
Делает компонент невидимым 
Класс TControl 
Определение 
void _fastcall Н1ае (уо1а); 


Описание 

Метод Hide делает компонент неёидимым, задавая значение False его свойст- 
By Visible. Если компонент является контейнером для других компонентов, то эти. 
дочерние компоненты также делаются невидимыми. 

Хотя компонент становится невидимым, его свойства и методы остаются дос- 
тупными. 


IndexOf 


Определение первого вхождения в список заданного элемента 
Классы Т1[138, TStringList, TStrings 
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Прототипы 
Для TList: 


int  fastcall IndexOf(void * Item); 
для TStrings и TStringList: 


virtual int _fastcall IndexOf (const System::AnsiString S); 


Описание | 

Вызов IndexOf возвращает индекс первого вхождения в массив списка задан- 
ного элемента (указателя Item для TList или строки S для TStringList и TStrings). 
Индексация начинается с 0 (0 — первый элемент массива). Если заданного элемен- 
та в списке нет, возвращается -1. 


Пример 
В приведенном ниже примере определяется, есть ли в списке сотрудник, фа- 
милия которого задана пользователем в окне ЕЧИЛ. 


TStringList *LPerson = new TStringList; 


if (LPerson->IndexOf (Editl->Text) < 0) 
ShowMessage ("Сотрудника " + Editl->Text + 
" в списке HET"); 


Insert 


Процедура вставляет элемент в список в заданную позицию 
Классы TList, TStringList, TStrings 


Прототипы 
Для TList: 


void _ Еаз®са11 Insert(int Index, void * Item); 


для TStrings и TStringList: 


virtual void _fastcall Insert(int Index, 
const System::AnsiString S); 


Описание 

Процедура Insert вставляет элемент (указатель Item или строку S) в список в 
позицию, индекс которой задан параметром Index. Если задан Index = 0, элемент 
вставляется в первую позицию. При вставке элемента все имеющиеся в списке эле- 
менты с индексами, равными и большими Index, сдвигаются, т.е. их индексы уве- 
личиваются на 1. 

Если список сортирован, то вызов Insert приводит к генерации исключения 
EListError. Для сортированных списков следует использовать метод Add. 

Если в списки TStringList и TStrings надо вставить строку, связанную с объ- 
€KTOM, то вместо метода Insert следует использовать метод InsertObject. 


Invalidate 


Сообщает Windows о необходимости полностью перерисовать компонент после 
того, как будут обработаны другие важные сообщения Windows 


Классе TControl 
Определение 
virtual void _ fastcall Invalidate (void) ; 


Описание 
Метод Invalidate надо вызывать, когда требуется полностью перерисовать 
компонент. Если более одной области компонента требует перерисовки, вызов ме- 
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тода Invalidate приводит к его полной перерисовке, что позволяет избежать мерца- 
ния изображения. Многократный вызов Invalidate до действительной перерисов- 
ки компонента не приводит к потере эффективности работы. 


LineTo 


Рисует на канве прямую линию, начинающуюся с текущей позиции пера и 
кончающуюся указанной точкой 


Классе TCanvas 


Прототип 
void _ fastcall LineTo(int Х, int Y); 


Описание 

Метод LineTo рисует на канве прямую линию, начинающуюся с текущей по- 
зиции пера PenPos и кончающуюся точкой (Х, У), исключая саму точку (Х, У). Те- 
кущая позиция пера PenPos перемещается в точку (Х, У). При рисовании исполь- 
зуются текущие установки пера Реп. 


Пример 
Операторы 
Imagel->Canvas->MoveTo (X1, Y1); 


Imagel->Canvas->LineTo (X2, Y2) ; 
Imagel->Canvas->LineTo (X3, Y3) ; 


рисуют кусочно-ломаную прямую, соединяющую точки (X1,Y1), (X2,Y2) и 
(X3,Y3). 


LoadFromClipboardFormat 


Загружает изображение из буфера обмена в формате Clipboard 
Класс TGraphic, TBitmap, TIcon, TMetafile, TPicture 


Прототип 


virtual void _ Газ®са11 LoadFromClipboardFormat ( 
Word AFormat, int AData, HPALETTE APalette); 


Описание 

Метод загружает изображение в графический объект в указанном формате 
Clipboard. Если формат AFormat найден среди зарегистрированных, то AData и 
APalette передаются для загрузки изображения. Стандартно зарегистрированные 
форматы: CF_BITMAP для битовых карт и CF_METAFILEPICT для метафайлов. 
Значение AData может быть указано методом GetAsHandle объекта типа TClip- 
board. При этом надо не забыть включить в приложение директиву 


#include <vcl\Clipbrd.hpp> 


Формат для нового типа графического объекта предварительно должен быть 
зарегистрирован методом RegisterClipboardFormat. 

Если в буфере обмена находится не тот тип данных, который ожидается, то ге- 
нерируется исключение EInvalidGraphic. 


Пример 
#include <vcl\Clipbrd.hpp> 


if (Clipboard()->HasFormat (CF_BITMAP) ) 
{ 
try 
{ 
imager >Picture->Bitmap->LoadFromClipboardFormat (CF BITMAP, 
Clipboard ()->GetAsHandle(CF BITMAP), aha 
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} 
Caton ot. »:) 


{ 
ShowMessage ("Загрузка изображения невозможна"); 
} 
} 
else 
ShowMessage("B буфере не точечное изображение"); 


Приведенный код загружает изображение из буфера обмена в формате битовой 
карты в компонент Imagel. 


LoadFromFile — метод графических объектов 


Загружает изображение, хранящееся в файле 

Классы TGraphic, ТРасфиге 

Прототип | 

virtual void _fastcall LoadFromFile(const AnsiString FileName) ; 


Описание 

Метод LoadFromFile читает файл FileName и загружает его в графический 
объект. 

Если формат графического файла не зарегистрирован, или не соответствует 
типу графического объекта, то генерируется исключение EInvalidGraphic. 


Пример 


if (OpenPictureDialogl->Execute ()) 
Imagel->Picture->LoadFromFile (OpenPictureDialogl->FileName) ; 


Этот оператор открывает диалог OpenPictureDialog1, позволяющий пользова- 
телю выбрать файл, и загружает изображение из файла в компонент Imagel. 


LoadFromResourceID 
Загружает битовую карту из файла ресурсов по указанному идентификатору 
Классе TBitmap 


Прототип 


void _ Еаз®са11 LoadFromResourceID(int Instance, int ResID); 


Описание 
Метод LoadFromResourcelID загружает битовую карту из файла ресурсов вы- 
полняемого модуля. Загружаемая карта указывается идентификатором ResID. 


LoadFromResourceName 
Загружает битовую карту из файла ресурсов по указанному имени 
Класс T Bitmap 


Прототип 


void _fastcall LoadFromResourceName (int Instance, 
const AnsiString ResName) ; 


Описание 

Метод LoadFromResourceName загружает битовую карту из файла ресурсов 
выполняемого модуля. Загружаемая карта указывается именем КезМате. Метод 
поддерживает изображения с 256 цветами. 


Свойства, методы, события, типы, классы 1073 


LoadFromStream 
Sarpy KaeT графическое изображение из указанного потока 
Классе TGraphic 


Прототип 


virtual void __fastcall LoadFromStream(Classes::TStream* Stream) ; 


Описание 

Метод LoadFromStream читает из потока Stream графический объект. Ис- 
пользуется, например, для загрузки изображения из объекта TBlobStream, чтобы 
прочитать графическое поле в наборе данных. 


Lock 


Блокирует канву, не разрешая другим нитям многопоточного приложения ри- 
совать на ней 


Класс TCanvas 


Прототип 


void _fastcall Lock(void); 


Описание 

Метод Lock блокирует данную канву, не разрешая другим нитям многопоточ- 
ного приложения рисовать на ней. Канва остается блокированной до снятия блока- 
ды вызовом метода Unlock. Если имеются вложенные вызовы Lock, то они увели- 
чивают свойство LockCount, фиксирующее количество блокировок. Канва будет 
оставаться блокированной, пока не будет снята последняя блокировка. 

Если нежелательна вложенная многократная блокировка, лучше использо- 
вать метод TryLock. 

Поскольку блокировка не дает другим нитям рисовать на канве, производи- 
тельность работы приложения может за счет этого снизится. Так что не надо зло- 
употреблять блокировками. Их следует применять только тогда, когда есть веро- 
ятность нежелательных наложений операций, выполняемых в разных нитях при- 
ложения с несколькими потоками. 


Моуе 
Меняет текущую позицию элемента в списке на заданную 
Модуль System 
Классы TList, TStringList, Tstrings 
Прототип 


void _ fastcall Move(int СигТпаех, int NewlIndex) ; 


Описание 

Процедура Move меняет текущую позицию элемента в списке, индекс которо- 
го задан параметром CurlIndex, на позицию с индексом, заданным параметром 
NewIndex (индексы начинаются с 0). Если со строкой в TStrings или в TStringLi 
связан объект, он остается связанным с той же строкой в новой позиции. 


Пример 
Приведенный ниже оператор перемещает первую строку списка MyStrings в 
конец списка. 


MyStrings->Move(0, MyStrings->Count - 1); 
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MoveTo 


Изменяет текущую позицию пера на заданную, ничего при этом не рисуя 
Класс TCanvas 


Прототип 
void __fastcall MoveTo(int X, int У); 


Описание 

Метод МоуеТо изменяет текущую позицию пера PenPos на заданную точкой 
(Х, У). Это эквивалентно непосредственной установке свойства PenPos. При пере- 
мещении пера методом МоуеТо ничего не рисуется. 


MouseCapture 
» См. раздел TControl. 


Pie 
Рисует заполненную замкнутую фигуру — сегмент окружности или эллипса 
Класс ТСапоаз 


Прототип 


уоза’‘тавеса т Pre (int: Xi}“"ine ТУТ, int ‘Ха, “int У) 
ПХ ЗЗАЕГУЗ СТАС Mays int 94) 9 


Описание 

Метод Pie рисует замкнутую фигуру — сектор окружности или’эллипса с по- 
мощью текущих параметров пера Реп. Фигура заполняется текущим значением 
Brush. Точки (X1, Y1) и (Х2, Y2) определяют прямоугольник, описывающий эл- 
липс. Начальная точка дуги определяется пересечением эллипса с прямой, прохо- 
дящей через его центр и точку (X3, У3). Конечная точка дуги определяется пере- 
сечением эллипса с прямой, проходящей через его центр и точку (Х4, У4). Дуга ри- 
суется против часовой стрелки от начальной до конечной точки. Рисуются пря- 
мые, ограничивающие сегмент и del iat через центр эллипса и точки (ХЗ, 
УЗ) и (Х4, У4). 

В Windows 95/98 суммы ХЕ + X2, ут + У2 и Х1 + Х2 + УТ + Y2 не должны 
превышать 32768. 

В Windows МТ направление рисования дуги можно изменить на направление 
по часовой стрелке вызовом функции SetArcDirection. 


Примеры 
Операторы 


Imagel->Canvas->Pie(0, 0, 200, 200, 200, 0, 0, 0); 
Image2->Canvas->Pie(0, 0, 200, 200, 0, 0, 200, 0); 


дают результат, показанный на рисунке. 


Pie(0, 0, 200, 200. 200,0,0,0  — \  Ре(0, 0, 200, 200, 0,0. 200, 0) 


Свойства, методы, события, типы, классы 1075 


PolyBezier и PolyBezierTo | | 


Рисуют на канве текущим пером кусочную кривую третьего порядка, сглажи- 
вающую заданное множество точек 


Класс ТСапоаз 


Прототип 


void _ Еаз®са11 PolyBezier(const Windows::TPoint * Points, 
const int Points Size); 

void _ fastcall PolyBezierTo(const Windows::TPoint * Points, 
const int Points Size); 


Описание 

Методы PolyBezier и PolyBezierTo склаживают множество точек Points_Size, 
содержащихся в массиве Points, кусочной кривой третьего порядка. При этом 
функция PolyBezier точно отображает первую и последнюю точку, a PolyBezier- 
То — только последнюю. Число точек Points_Size для каждого метода должно 
быть строго определенным (хотя это, к сожалению, не указано в справке C++Buil- 
der): для PolyBezier оно должно быть кратно 3 (т.е. 1*3), a для PolyBezierTo — на 
единицу меньше числа, кратного 3 (т.е. 1*3-1). Если число точек не равно заданно- 
му, то функции просто ничего не рисуют. ` 

Исходя из этого при произвольном числе точек М имеет смысл автоматически 
приводить число точек к требуемому, Например, такими операторами: 

Ро1уВе21ег (points, (N/3)*3); 

PolyBezierTo(points, (N/3)*3-1); 


В этих операторах число точек М за счет округления при целочисленном деле- 
нии автоматически приводится к требуемому. 

Пример 

Ниже приведен рисунок аппроксимаций функции -sin(x) методами PolyBezi- 
er, PolyBezierTo и Polyline и код их построения. 


Polyline 


PolyBezierlo 


— 
=. \ 
a ee 
р PolyB ezier \, 
/ `, 
/ XN 


const N = 10, Lx = 500, Ly = 100, T 
TPoint points[N]; 


lI 
= 
о 
`. 


// заполнение массива 
for(int i = 0; i <= М; itt) 
points[i] = Point((int) (i * Lx / (N-1)), 

(int) (sin((double)i * T / (N-1))*Ly) + 
Imagel->ClientHeight / 2); 

// рисование 

Imagel->Canvas->Pen->Color = clBlack; 

Imagel->Canvas->Polyline (points, N-1); 
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Imagel->Canvas->Pen->Color = clRed; 
Imagel->Canvas->PolyBezier (points, (N/3)*3); 


Imagel->Canvas->Pen->Color = clGreen; 
Imagel->Canvas->PolyBezierTo(points, (N/3)*3-1); 


Polygon Е 


Рисует на канве текущим пером замкнутую фигуру (многоугольник) по задан- 
ному множеству угловых точек, замыкая первую и последнюю точки и закраши- 
вая внутреннюю область фигуры текущей кистью 


Клаее Тсапоаз 


Прототип 


void _fastcall Polygon(const Windows::TPoint * Points, 
const int Points Size); 


Описание 

Метод Polygon рисует на канве замкнутую фигуру (полигон, многоугольник) 
по множеству угловых точек, заданному массивом Points. Первая из указанных 
точек соединяется прямой с последней. Этим метод Polygon отличается от метода 
Polyline, который не замыкает конечные точки. Рисование проводится текущим 
пером Реп. Внутренняя область фигуры закрашивается текущей кистью Brush. 

Метод позволяет рисовать фигуру по точкам, хранящимся в массиве элемен- 
тов типа TPoint. | 


Пример 
Операторы 
TPoint points[5]; 


points[(0) = Point(30,150); 
points[1] = Point (40,130); 
points[2]) = Point(50,140); 
points[3] = Point(60,130); 
points[4] = Point(70,150); 


Imagel->Canvas->Polygon (points, 4); 


рисуют на канве формы многоугольник по точкам, хранящимся в массиве points. 


Polyline Е: 


Рисует на канве текущим пером кусочно-линейную кривую по заданному мно- 
жеству точек 


Класе ТСапоаз 


Прототип 


void _fastcall Polyline(const Windows::TPoint * Points, 
const int Points Size); 


Описание 

Метод Polyline рисует на канве кусочно-линейную кривую по множеству то- 
чек, заданному массивом Points. Отличие метод Polyline от метода Polygon заклю- 
чается в TOM, что метод Polygon замыкает конечные точки, а метод Polyline — нет. 
Рисование проводится текущим пером Реп. Метод не изменяет текущей позиции 
PenPos пера Pen. 

Метод позволяет рисовать кусочно-линейный график функции, хранящийся в 
массиве элементов типа TPoint. 


Свойства, методы, события, типы, классы 1077 


То, что делает метод Polyline, можно сделать и с помощью методов МоуеТо и 
LineTo, подведя сначала перо к первой точке а затем последовательно выполняя 
LineTo. Различие будет заключаться в том, что метод Polyline не изменит теку- 
щую позицию пера, а методы MoveTo и LineTo изменят. 


Пример 

Операторы 

TPoint points[5]; 
points[0] = Point(30,150); 
points[1] = Point(40,130); 
points[2] = Point(50,140); 
points[3] = Point(60,130); 
points[4] = Point(70,150); 


Imagel->Canvas->Polyline (points, 4); 


рисуют кусочно-линейную кривую по четырем точкам, заданным функциями Po- 
int (см. раздел 15.3.3 главы 15) в массиве points. 


Realign 
См. DisableAlign. 


Rectangle 


Рисует на канве текущим пером прямоугольник и закрашивает его текущей 
кистью 


Классе ТСапоаз 


Прототип 
void _ Еазфса11 Rectangle(int Xl, int Yl, int X2, int Y2); 


Описание 

Метод Rectangle рисует на канве текущим пером Реп прямоугольник, верх- 
ний левый угол которого имеет координаты (X1, Y1), а нижний правый — (Х2, 
Y2). Прямоугольник закрашивается текущей кистью Brush. 

Рисование прямоугольника без рамки можно осуществить методом FillRect. 
Прямоугольник со скругленными углами рисуется методом RoundRect. Прямо- 
угольник без внутренней закраски рисуется методом FrameRect. 


Пример 3 
Imagel->Canvas->Rectangle(10,10,210,110); 


Refresh 


Перерисовывает изображение компонента на экране 
Классе TControl 

Определение 

void _ fastcall Refresh(void) ; 


Описание ' es 
Метод Refresh приводит к немедленной перерисовке изображения на экране. 
Refresh вызывает метод Repaint. Методы Refresh и Верап взаимозаменяемы. 


Remove 
Удаляет элемент с заданным значением из списка TList. 
Класс T'List 
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Прототип 


int __fastcall Remove(void * Item); 


Описание 

Функция Remove удаляет указатель, равный заданному параметру Item, из 
списка TList. Функцию можно использовать вместо метода Delete, когда не извес- 
тен индекс, соответствующий удаляемому ‘указателю. Функция возвращает ин- 
декс, который имел данный указатель до его удаления. Индексы всех последую- 
щих указателей в списке уменьшаются Ha 1. Свойство Count также уменьшается 
на 1. 

Если массив содержит несколько одинаковых указателей, то удаляется только 
первое вхождение этого указателя. 


Repaint , 
Перерисовывает изображение компонента на экране 
Классе TControl 


Определение 


virtual void _fastcall ВКера1п® (уо1а); 


Описание 

Вызов метода Вераш приводит к немедленной перерисовке изображения на 
экране. Если свойство ControlStyle компонента включает cSOpaque, компонент 
перерисовывает себя сам. В противном случае Repaint вызывает метод Invalidate, 
а затем метод Update. 


ReplaceDockedControl 


Встраивает компонент на место другого уже встроенного 
Классе T'Control 


Определение 
enum TAlign {а]1Мопе, а1Тор, alBottom,alLeft,alRight,alClient}; 


bool  fastcall ReplaceDockedControl(TControl* Control, 
TWinControl* NewDockSite, 
TControl* DropControl, 
TAlign ControlSide) ; 


Описание | 

Вызов метода ReplaceDockedControl приводит к встариванию данного компо- 
нента на место другого уже встроенного, указанного параметром Control. При этом 
вытесненный компонент перемещается в другой контейнер NewDockSite. Пара- 
метр DropControl конкретизирует место втраивания вытесненного компонента в 
новом контейнере. Например, если NewDockSite — компонент TPageControl, то 
параметр DropControl должен указывать страницу размещения. DropControl mo- 
жет указываться равным NULL. Параметр ControlSide определяет выравнивание 
вытесненного компонента в DropControl или в NewDockSite (если DropControl = 
NULL). Это значение можно получить вызовом метода GetDockEdge контейнера. 

Метод ReplaceDockedControl производит те же самые операции, что и метод 
ManualDock, примененный к Control с теми же параметрами NewDockSite, Drop- 
Control и ControlSide, плюс метод ManualDock, примененный к данному компо- 
ненту и размещающий его в позиции компонента Control. Но, метод ReplaceDoc- 
kedControl компактнее, более эффективен и предотвращает неприятное мерцание 
при перестроении компонентов. 


Свойства, методы, события, типы, классы 1079 


RoundRect 


Рисует на канве прямоугольную рамку CO скругленными углами 
Класс ТСапоаз$ 


Прототип 


void . fastcall RoundRect(int Х1, int Yl, int X2, int Y2, 
Зе К MF. ee fF 


Описание 

Метод RoundRect рисует на канве прямоугольную рамку со скругленными уг- 
лами, используя текущие установки пера Реп и заполняя площадь фигуры теку- 
щей кистью Brush. Рамка определяется прямоугольником с координатами углов 
(X1,Y1) и (Х2,У2). Углы скругляются с помощью эллипсов с шириной ХЗ и высо- 
той Y3. 

Если задать ширину эллипса ХЗ ; Х2 - X1, то верхняя и нижняя границы рам- 
ки окажутся целиком скругленными (без прямолинейной части). Если УЗ ; Y2 - 
У1, то же самое произойдет с левой и правой границами рамки. Если же оба изме- 
рения эллипса не меньше размеров рамки, то будет рисоваться просто эллипс. Но, 
конечно, для рисования эллипса лучше использовать метод Ellipse. Если один из 
размеров эллипса задать нулевым, то будет рисоваться прямоугольная рамка. Но, 
конечно, для такой рамки лучше использовать метод Rectangle. 


Пример 
Следующие операторы вызывают изображение, показанное на приведенном 
ниже рисунке: 


Imagel->Canvas->RoundRect (10,10,110,210,50,100); 

Imagel->Canvas->RoundRect (160,10,260,210,100,100); 
Imagel->Canvas->RoundRect (310,10,410,210,50,200) ; 
Imagel->Canvas->RoundRect (460,10,560,210,100,200); 


HL 


SaveToClipboardFormat 
Создает копию изображения в формате Clipboard 
Классы TGraphic, TBitmap, TIcon, TMetafile, ТРастиге 


Прототип 


virtual void _fastcall SaveToClipboardFormat (Word &AFormat, 
‘int &AData, HPALETTE &APalette) = 0; 


Описание 

Метод SaveToClipboardFormat создает копию изображения в формате 
Clipboard. Формат, указатель на данные и палитру возвращаются как параметры 
AFormat, AData и APalette. Стандартно зарегистрированные форматы: CF_BIT- 
МАР для битовых карт и CF_METAFILEPICT для метафайлов. Формат для нового 
типа графического объекта предварительно должен быть зарегистрирован методом 
RegisterClipboardFormat. 


1080 | ut ® _ Глава 16 


После применения метода SaveToClipboardFormat надо передать объекту 
Clipboard полученные значения AFormat и AData методом SetAsHandle. При 
этом надо не забыть включить в приложение директиву 


#include <vcl\Clipbrd.hpp>. 

Впрочем, записать изображение в Clipboard можно и проще, воспользовав- 
шись методом Assign объекта Clipboard для объектов типов TGraphic, TBitMap, 
ТТсоп, ТМеа Ме. 

Примеры 

#include <vcl\Clipbrd.hpp> 


_Word MyFormat; 
THandle AData; 
HPALETTE APalette; 


Imagel->Picture->Bitmap->SaveToClipboardFormat (MyFormat, 
AData, APalette); 
Clipboard()->SetAsHandle (MyFormat, AData) ; 


Приведенные операторы записывают в буфер обмена изображение, хранящее- 
ся в свойстве Picture->Bitmap компонента Imagel, вместе с палитрой и регистри- 
руют формат MyFormat. В дальнейшем его можно использовать для чтения изо- 
бражения из буфера: 


if (Clipboard()->HasFormat (MyFormat) ) 
{ 
try 
{ 
Image2->Picture->Bitmap->LoadFromClipboardFormat (CF BITMAP, 
Clipboard ()->GetAsHandle(MyFormat), 0); 


} 
CATON: Г...) 


{ 
ShowMessage ("Загрузка изображения невозможна"); 
} 
} 
е15е 
ShowMessage("B буфере не изображение по формату MyFormat") ; 


Впрочем, записать изображение в буфер обмена можно и не используя метод 
SaveToClipboardFormat, например, оператором: 


Clipboard()->Assign (Imagel->Picture->Bitmap) ; 
или 
Clipboard()->Assign (Imagel->Picture->Graphic) ; 


SaveToFile — метод графических объектов | 
Сохраняет графическое изображение в файле 
Классы TGraphic, ТМеве, T Picture 
Прототип 


virtual void _fastcall SaveToFile(const AnsiString Filename) ; 


Описание 
Метод SaveToFile сохраняет изображение графического объекта в файле File- 
Мате. 


Пример 
Применение метода SaveToFile для типа T'Picture позволяет, в частности, 
преобразовывать один тип графических файлов в другой. В качестве примера ниже 
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приведен код, создающий на основании файла пиктограммы Му.1со файл точечно- 
го изображения My.bmp. 
ТТсоп *ico = new ТТсоп(); 
try 
{ 
ico->LoadFromFile("My.ico"); 
Imagel->AutoSize = false; 
Imagel->Width = ico->Width; 
Imagel->Height = ico->Height; 
Imagel->Canvas->Draw(0,0,ico); 
Imagel->Picture->SaveToFile ("My.bmp") ; 
} 
__ finally 
{ 


delete ico; 


} 


SaveToStream 


Сохраняет графическое изображение в потоке 
Классы TGraphic, ТВитар, TIcon, TMetafile, TPicture 


Прототип 


virtual void _fastcall SaveToStream(Classes::TStream* Stream) = 0; 


Описание 

Метод SaveToStream сохраняет в потоке Stream изображение графического 
объекта. Используется, например, для сохранения в объекте TBlobStream графи- 
ческого поля из набора данных. 


ScaleBy 


Масштабирует оконный элемент и все содержащиеся в нем компоненты 
Класс TWinControl 


Определение 
void’ fastcall ScaleBy(int М, int 0); 


Описание 

Метод ScaleBy масштабирует оконный элемент и все содержащиеся в нем KOM- 
поненты. Масштабируются такие свойства компонента, как Width и Height, onpe- 
деляющие его размер. Свойства Тор и Left остаются неизменными. Масштабирует- 
ся также размер шрифта, если только в компоненте не установлено ParentFont = 
фгие. В последнем случае шрифт наследуется от родительского компонента и по- 
этому не изменяется. | 

Если компонент является контейнером, содержащим другие компоненты, то 
эти дочерние компоненты также масштабируются. Причем у них изменяются не 
только Width и Height, но также пропорционально изменяются Тор и Left, опре- 
деляющие их местоположение. Если во всех дочерних компонентах установлено 
ParentFont = true, а в компоненте-контейнере ParentFont = false, то пропорцио- 
нально изменяются и шрифты всех компонентов (но, конечно, не непрерывно, а 
скачками, доступными тому или иному типу шрифта). 

‚ Параметры М and D определяют соответственно множитель и делитель мас- 
штаба. Например, чтобы уменьшить размеры на 10% начального значения, можно 
задать М равным 9, а О равным 10 (9/10). Если же вы хотите увеличить размер на 
1/3, то можно задать М=133 и D=100 (133/100) или М=4 и D=3 (4/3). 

Подробнее метод рассмотрен в главе 4 в разделе 4.2.5. 
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Примеры 
1. Оператор 
Еа1*1->5са1еВу (11,10); 


масштабирует окно редактирования Editl. В любом случае при выполнении 
этого оператора увеличивается на 10% длина окна (свойство Width), что обес- 
печивает возможность наблюдать и редактировать в нем более длинный текст. 
Высота окна (свойство Height) будет изменяться пропорционально, если свой- 
ство компонента AutoSize равно false. В противном случае высота определяет- 
ся только размером шрифта и при постоянном шрифте будет неизменной. А 
размер шрифта будет меняться, только если свойство компонента ParentFont 
равно false, т.к. иначе шрифт определяется родительским компонентом. 


2. Приведенный ниже обработчик события OnKeyUp окна редактирования Editl 
дает пользователю возможность менять длину окна. При нажатии комбина- 
ций клавиш Alt-U и А|-О пользователь увеличивает или уменьшает длину окна. 


void  fastcall TForml::EditlKeyUp(TObject *Sender, WORD &Кеу, 
TShiftState Shift) 
{ 


if((Key == 'U')&&(Shift.Contains(ssAlt) )) 
Editl->ScaleBy(11,10); 
else if ((Key == 'D')&&(Shift.Contains (ssAlt) )) 


Edit1l->ScaleBy (10,11); 
} 


Когда Editl находится в фокусе, при нажатии пользователем клавиши Alt u 
клавиши U (в любом регистре и независимо от переключения на латинский 
или русский язык) длина окна редактирования увеличится на 10%, а при на- 
жатии А! и О соответственно уменьшится. 


ScaleControls 


Масштабирует дочерние компоненты оконного элемента, не изменяя масшта- 
ба самого элемента 


Класс TWinControl 


Определение 
void _fastcall ScaleControls(int М, int D); 


Описание 

Метод ScaleControls масштабирует все компоненты, содержащиеся в оконном 
элементе, не изменяя масштаба самого элемента. Метод ScaleControls вызывает 
метод ChangeScale для каждого дочернего компонента. Отличается от метода Sca- 
1еВу только тем, что не изменяет масштаба самого элемента. 

Параметры М and D определяют соответственно множитель и делитель мас- 
штаба. Например, чтобы уменьшить размеры на 10% начального значения, можно 
‘задать М равным 9, а О равным 10 (9/10). Если же вы хотите увеличить размер на 
1/3, то можно задать М=133 и D=100 (133/100) или М=4 и D=8 (4/3). 

Подробности см. в разделах ChangeScale и ScaleBy. 


ScreenToClient 
Преобразует координаты экрана в координаты клиентской области компонента 
Класс TControl 


Определение 
struct TPoint 
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{ 


int -: x 
ENC: YZ 
he 
Windows::TPoint  fastcall ScreenToClient ( 
const Windows::TPoint &Point); 
Описание 


Метод ScreenToClient преобразует координаты точки в системе координат эк- 
рана (начало координат — левый верхний угол экрана) B систему координат кли- 
ентской области компонента (начало координат — левый верхний угол клиентской 
области). 

Совместно с обратной функцией ClientToScreen метод может использоваться 
для пересчета координат точки экрана из системы координат клиентской области 
одного компонента в систему координат клиентской области другого компонента. 


Пример 
Р = Comp2->ScreenToClient (Comp1->ClientToScreen (Р)); 


Оператор пересчитывает координату точки экрана Р из системы координат 
компонента Compl в систему координат компонента Comp2. 


ScrollBy : 


Сдвигает содержимое оконного элемента 
Классе TWinControl 


Определение 
void _fastcall ScrollBy(int DeltaX, int DeltaY); 


Описание 

Метод ScrollBy сдвигает содержимое оконного элемента, включая все его до- 
черние компоненты. Метод применим ко всем оконным элементам, но чаще всего 
используется для наследников класса TScrollingWinControl. 

Параметры DeltaX и DeltaY определяют величину сдвига по горизонтали и 
вертикали соответственно. Положительные значения параметров задают сдвиг 
вправо и вниз, отрицательные значения — влево и вверх. 


Пример 
Оператор 
SErTolLiBy (1,1) 


сдвигает все компоненты Ha форме на один пиксель вправо и на один вниз. 


SelectFirst 
Передает фокус дочернему компоненту, первому в последовательности табуляции 
Класе TWinControl 
Определение 


void _fastcall SelectFirst (void); 


Описание 

Метод SelectFirst передает фокус дочернему компоненту, первому в последо-. 
вательности табуляции. Он вызывает метод FindNextControl, передавая ему пара- 
метр, равный NULL. В результате метод FindNextControl возвращает первый ком- 
понент в последовательности табуляции, после чего этот компонент делается ак- 
тивным. 
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Пример 


| Оператор 


SelectFirst(); 


активизирует первый в последовательности табуляции компонент Ha форме. 


SelectNext 


Передает фокус дочернему компоненту, следующему в последовательности Ta- 


буляции за указанным 


Класс TWinControl 


Определение 


void _fastcall SelectNext (TWinControl* CurControl, 
bool GoForward, bool CheckTabStop) ; 


Описание 
Метод SelectNext передает фокус дочернему компоненту, следующему в по- 


следовательности табуляции за тем, который указан параметром CurControl. Па- 
раметр GoForward определяет направление поиска: при значении true поиск Be- 
дется вперед, при значении false - назад. 


Параметр CheckTabStop указывает, должен ли искомый компонент иметь 


свойство TabStop, равным true. Если значение CheckTabStop равно true, очеред- 
ной компонент должен иметь значение TabStop, равное true, или поиск прекраща- 
ется. 


Если метод SelectNext не, смог найти компонент в соответствии с заданными 


значениями GoForward и CheckTabStop, то фокус остается на компоненте 
CurControl. 


SendCancelMode 


Прерывает модальное состояние элемента управления 
Классе TControl 


Определение 
void _fastcall SendCancelMode(TControl* Sender) ; 


Описание 
Вызов метода SendCancelMode прерывает модальное состояние элемента 


управления. Ряд элементов, реализованных в библиотеке визуальных компонен- 
тов C++Builder, поддерживают модальное состояние, при котором пользователь 
должен ответить элементу прежде, чем он сможет общаться с другими объектами 
формы. Метод SendCancelMode позволяет завершить модальное состояние без ка- 
ких-либо действий со стороны пользователя. 


SendToBack 


Переносит компонент ниже других компонентов в Й-последовательности 
Классе TControl 


Прототип 
void _fastcall SendToBack (void) ; 


Описание 
Метод SendToBack позволяет изменять последовательность перекрытия ком- 


понентов на форме и тем самым управлять видимостью компонентов. 


Перекрывающиеся компоненты на форме размещаются поверх друг друга в 


так называемой /-последовательности, соответствующей порядку размещения 
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компонентов в процессе проектирования. Например, если вы поместили в одно и 
то же место формы две кнопки одинаковых размеров, то видна будет только вторая 
из размещенных кнопок, поскольку она расположена в 7-последовательности 
выше. Применение во время выполнения приложения метода SendToBack к верх- 
ней кнопке переместит ее вниз в 7-последовательности и пользователю станет вид- 
на нижняя кнопка. 

Если переносимый вниз компонент имел фокус, то он его потеряет при переносе. 

Это справедливо по отношению к неоконным объектам, таким, как кнопки, 
метки, изображения и т.д., а также и к оконным компонентам, таким, как Memo, 
ComboBox и др. Но все неоконные компоненты всегда расположены в 7-последова- 
тельности ниже оконных и метод SendToBack не может изменить это правило. На- 
пример, попытка перенести вниз методом SendToBack оконный компонент, под 
которым размещена метка, ни к чему не приведет. 


Примеры 

В разделе, посвященном методу BringToFront, также изменяющему последова- 
тельность компонентов, приведен ряд примеров. Во всех них вместо метода Bring- 
ToFront, применяемому к нижнему компоненту, можно. применять метод Send- 
ToBack, но к верхнему компоненту. 


SetBounds 


Устанавливает одновременно свойства Left, Top, Width и Height 
Класе TControl 


Определение 


virtual void _fastcall SetBounds(int ALeft, int АТор, 
int AWidth, int AHeight); 


Описание 

Метод SetBounds изменяет одновременно все свойства компонента, опреде- 
ляющие его границу. Тот же эффект может быть достигнут совокупностью опера- 
торов изменения Left, Top, Width и Height. To, что метод SetBounds одновремен- 
но задает эти значения, не только позволяет получить более компактный код, нои 
дает возможность избежать перерисовки компонента после изменения каждого па- 
раметра в отдельности. При этом ликвидируется мерцание изображения, которое 
получается при поочередном изменении параметров. 

Значения Left, Top, Width и Height задаются при вызове SetBounds как соот- 
ветственно параметры ALeft, ATop, AWidth и AHeight. 

Примеры, в которых требуется изменять сразу все эти свойства, CM. в разделах 


Visible и BringToFront. 
SetChildOrder 


Изменяет позицию компонента в списке дочерних компонентов оконного эле- 
мента 


Класе TWinControl 


Определение 


DYNAMIC void _ fastcall SetChildOrder ( 
Classes::TComponent* Child, int Order); 


Описание 

Метод SetChildOrder изменяет положение компонента, заданного параметром 
Child, в списке дочерних компонентов оконного элемента. Этот список — свойство 
Controls оконного элемента. 
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Параметр Order определяет индекс, присваиваемый компоненту Child (помни- 
те, что индексы начинаются с 0). Последовательность индексов остальных компо- 
нентов остается неизменной, но сами значения индексов «смыкаются», заполняя 
прежний индекс изменяемого компонента, и «раздвигаются» освобождая место 
для его нового индекса. 


Пример 
Если, например, компонент Edit2 был в списке Controls формы вторым (т.е. 
имел индекс 1), то после выполнения оператора 


SetChildOrder (Edit2, 3); 


элемент с индексом 0 сохранит свой индекс, элементы с индексами 2 и 3 изменят 
индексы на 1 и 2, компонент Edit2 будет иметь индекс 3, а индексы остальных эле- 
ментов не изменятся. 


SetFocus 
Передает фокус элементу 
Классе TWinControl 
Определение 


virtual void _fastcall SetFocus (void); 


Описание 
Метод SetFocus передает фокус данному компоненту, активизирует его. 


Пример 
Оператор 
Edit1l->SetFocus (); 


передает фокус компоненту Edit1l. 


SetZOrder 


Перемещает компонент на вершину или в низ 7/-последовательности 
Классы TControl, TWinControl 


Определение 
DYNAMIC void _fastcall 5ее2Огаег (6оо1 ТорМозе); 


Описание 

Метод SetZOrder перемещает компонент на вершину или в низ й-последова- 
тельности родительского элемента. Если родительского элемента нет, то элемент 
становится верхним или нижним окном экрана. Таким образом, этот метод пере- 
страивает перекрывающиеся компоненты или окна. 

Если параметр TopMost равен true, то элемент перемещается на вершину; в 
противном случае он перемещается вниз. 

При этом надо иметь в виду, что оконные элементы всегда расположены в 
7/-последовательности выше не оконных. Так что при выполнении этого метода пе- 
ремещения происходят только в этих допустимых пределах. 


Show 


Делает видимым невидимый компонент 


Классе TControl 
Определение 


void _fastcall Show(void); 


— 
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Описание 

Метод Show делает видимым ранее невидимый компонент. Он задает значение 
true свойству Visible и проверяет, является ли видимым родительский компонент. 

Примеры использования видимых и невидимых компонентов см. в разделе 


Visible. 
StretchDraw 


Рисует графическое изображение в указанную прямоугольную область канвы, 
подгоняя размер изображения под заданную область 


Класс TCanvas 


Прототип 


void _fastcall StretchDraw(const Windows::TRect &Rect, 
TGraphic* Graphic) ; 

Описание 

Метод StretchDraw рисует на канве изображение, содержащееся в объекте, 
указанном параметром Graphic, в прямоугольную область, указанную параметром 
Rect. При этом размер изображения подгоняется под размер заданной области. 
Этим метод StretchDraw отличается от метода Draw, который оставляет размер 
неизменным. 

Объект Graphic может быть типа битовой матрицы, пиктограммы или мета- 
файла. Если объект — битовая матрица типа TBitMap, то при переносе изображе- 


ния учитывается режим копирования, установленный свойством канвы Сору- 
Mode. 


Пример 
Оператор 
Imagel->Canvas~->StretchDraw (Rect (10,10,110,110),В1Емар1); 


рисует Ha канве компонента Imagel изображение из компонента Bitmapl в об- 
ласть с координатами углов (10, 10) и (110, 110). При этом размер изображения 
подгоняется под заданный размер области — квадрат со стороной 100. 


TextExtent 


Возвращает длину и высоту в пикселях текста, который предполагается напи- 
сать на канве текущим шрифтом 


Класс ТСапоаз 


Прототип 


struct TSize 


{ 
LONG cx; 
LONG cy; 


ha 


TSize fastcall TextExtent(const AnsiString Text); 


Описание 

Функция TextExtent возвращает структуру типа TSize, содержащую длину и 
высоту в пикселях текста Text, который предполагается написать на канве (см. 
Canvas) текущим шрифтом. Это позволяет перед выводом текста на канву опреде- 
лить размер надписи и расположить ее и другие элементы изображения наилуч- 
шим образом. 

Только высоту или только длину текста можно определять соответственно ме- 
тодами TextHeight и TextWidth. 
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Пример 


String st = Editl->Text; 
Canvas-—>TextOut ((ClientWidth - Canvas->TextExtent(st).cx) / 2, 
Canvas->TextExtent (st) .cy, st); 


Эти операторы выводят на канву формы текст, набранный пользователем в 
окне редактирования Editl, выравнивая его при любом шрифте по середине шири- 
ны канвы (формы) и отступив одну строчку сверху. 


TextHeight 


Возвращает высоту в пикселях текста, который предполагается написать на 
канве текущим шрифтом 


Класс TCanvas 


Прототип 
int  fastcall TextHeight(const AnsiString Text); 


Описание 

Функция TextHeight возвращает высоту в пикселях текста Text, который 
предполагается написать на канве Сапуа$ текущим шрифтом. Это позволяет перед 
выводом текста на канву определить размер надписи и расположить ее и другие 
элементы изображения наилучшим образом. 

Имеется еще метод TextExtent, возвращающий одновременно и высоту, и дли- 
ну текста. Метод TextHeight возвращает то же, что TextExtent(Text).cy. 


Примеры 


String st = Editl->Text; 

Imagel->Canvas->TextoOut ( 
Imagel->ClientWidth - Imagel->Canvas->TextExtent (st) .cx)/2, 
Imagel->Canvas->TextExtent(st).cy, st); 


Эти операторы выводят текст, набранный пользователем в окне редактирова- 
ния Editl, в канву компонента Imagel, выравнивая его при любом шрифте по се- 
редине ширины канвы и отступив одну строчку сверху. 

См. также пример в описании метода TextRect. 


TextOut 
Пишет указанную строку текста на канве, начиная с указанной позиции 
Класс ТСапоаз 
Прототип 


void . fastcall TextOut(int X, int У, const AnsiString Text); 


Описание 

Функция TextOut пишет строку текста Text на канве (см. Canvas), начиная с по- 
зиции с координатами (Х, У). Надпись делается в соответствии с текущими установ- 
ками шрифта Font. Фон надписи определяется установками текущей кисти Brush. 
Текущая позиция PenPos пера Реп перемещается к концу выведенного текста. 

Для выравнивания позиции текста на канве можно использовать методы, даю- 
щие перед выводом высоту и длину текста в пикселях: методы TextExtent, Text- 
Height и Text Width. 

Если цвет кисти в момент вывода текста отличается OT того, которым закра- 
шена канва, то текст получится выведенным в цветной прямоугольной рамке. Но 
ее размеры будут точно равны размерам надписи. Если требуется более красивая 
рамка с отступом от текста или если надо ограничить выводимый текст размерами 
определенной рамки, следует применять метод TextRect. 


Свойства, методы, события, типы, классы 1089 


Пример | ! 
Оператор 
Image1->Canvas->TextOut (10, 10, 3); 


выводит текст, хранящийся в строковой переменной $, на канву компонента Ппа- 
gel, начиная с позиции (10, 10). 

См. также примеры в описаниях методов TextExtent, TextHeight, TextWidth 
и TextRect. 


TextRect 


Пишет указанную строку текста Ha канве, начиная с указанной позиции и yce- 
кая текст, выходящий за пределы указанной прямоугольной области 


Класе TCanvas 


Прототип 


void _fastcall TextRect (const Windows::TRect é&Rect, 
int X, int У, const, AnsiString Text); 


Описание 

Функция TextRect пишет строку текста Text на канве (cm. Canvas), начиная с 
позиции с координатами (Х, У) — это левый верхний угол надписи. Часть текста, 
He помещающаяся в прямоугольную область Rect, усекается. Надпись делается в 
соответствии с текущими установками шрифта Font. Пространство внутри области 
Rect закрашивается текущей кистью Brush. 

Для выравнивания позиции текста внутри области на канве можно использо- 
вать методы, дающие перед выводом высоту и длину текста в пикселях: методы 
TextExtent, TextHeight и Тех Width. 


Примеры 


т. Зак хоть 
String st = Editl->Text; 


X1 = 100; 
У1 = 100; 
X2 = 200; 
Y2 = 150; 


Imagel->Canvas->Brush->Color = clRed; 
Imagel->Canvas->TextRect (Rect (X1,Y1,X2,Y2), 
X1+ (X2-X1-Imagel->Canvas->TextWidth(st)) / 2, 
У1 + (Y2-Y1l-Imagel->Canvas->TextHeight(st)) / 2, st); 


Приведенный код рисует в заданном месте канвы компонента Imagel красный 
прямоугольник и внутри него в центре пишет методом TextRect текст, введен- 
ный пользователем в окно редактирования Editl. Если текст оказывается длин- 
Hee ширины прямоугольника, то он усекается. В данном примере будет видна 
только середина текста, так как текст выровнен по центру прямоугольника. 


2. Если в приведенном примере заменить оператор на 


Imagel->Canvas->TextRect (Rect (X1-5,Y1-5, 
X1+Imagel->Canvas-~->TextWidth(st)+5, 
Y1l+Imagel->Canvas->TextHeight (st)+5), 
Aes ie ae, Str 


то текст будет выводится полностью при любой его длине в красной прямоуго- 
льной области, на 5 пикселей отступающей во все стороны от текста. Именно 
этим отступом, делающим надпись более красивой, этот оператор отличается 
от более простого оператора 


TextOut (X1,Y1,st); 
использующего метод TextOut. 
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Тех Width 


Возвращает длину в пикселях текста, который предполагается написать на 
канве текущим шрифтом | 


Класс ТСапоаз 


Прототип 
int  fastcall TextWidth(const AnsiString Text); 


Описание | 

Функция Text Width возвращает длину в пикселях текста Text, который пред- 
полагается написать на канве (см. Сапуа$) текущим шрифтом. Это позволяет пе- 
ред выводом текста на канву определить размер надписи и расположить его и дру- 
гие элементы изображения наилучшим образом. ь 

Имеется еще метод TextExtent, возвращающий одновременно и высоту, и дли- 
на текста. Метод Text Width возвращает то же, что TextExtent(Text).cx. 


Примеры 


String st = Editl->Text; 
Canvas->TextOut (ClientWidth - Canvas->TextExtent (st) .cx)/2, 
Canvas->TextExtent (st).cy, st); 


Эти операторы выводят на канву формы текст, набранный пользователем в 
окне редактирования Editl, выравнивая его при любом шрифте по середине шири- 
ны канвы и отступив одну строчку сверху. 

См. также пример в описании метода TextRect. 


TryLock 


Блокирует канву, если она He была блокирована, не разрешая другим нитям 
многопоточного приложения рисовать на ней 


Классе ТСапоаз 


Прототип 
bool _ fastcall TryLock(void); 


Описание 

Функция ТгуГосК блокирует данную канву, не разрешая другим нитям много- 
поточного приложения рисовать на ней. Канва остается блокированной до снятия 
блокады вызовом метода Unlock. 

Если канва не была блокирована, то функция TryLock устанавливает свойство 
LockCount в 1 и возвращает true. Если канва уже была блокирована, то функция 
TryLock возвращает false, не увеличивая LockCount. В этом ее отличие от метода 
Lock, который допускает многократное вложенное блокирование. 

Поскольку блокировка не дает другим нитям рисовать на канве, производи- 
тельность работы приложения может за счет этого снизится. Так что не надо зло- 
употреблять блокировками. Их следует применять только тогда, когда есть веро- 
ятность нежелательных наложений операций, выполняемых в разных нитях при- 
ложения с несколькими потоками. 


Unlock 


Уменьшает на единицу значение свойства LockCount, способствуя тем самым 
разблокированию канвы, когда LockCount станет равным 0 


Класс TCanvas 
Прототип 


void _fastcall Unlock(void); 
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Описание 

Метод Unlock уменьшает на единицу значение свойства LockCount, способст- 
вуя тем самым разблокированию канвы, заблокированной ранее методами Lock 
или TryLock. Блокировка канвы не разрешает другим нитям многопоточного при- 
ложения рисовать на ней. Канва остается блокированной до тех пор, пока свойство 
LockCount не станет равным 0. А единственный способ уменьшения LockCount — 
вызов метода Unlock. 

Если канва была заблокирована однократно, то вызов Unlock немедленно раз- 
блокирует ее. Если же были вложенные вызовы Lock, то канва будет разблокиро- 
вана после стольких вызовов Unlock, сколько раз ранее вызывался Lock. 


Update 
Немедленно перерисовывает компонент 
Класе TWinControl 
Определение 
virtual void _ fastcall Update(void); 


Описание 

Метод Update вызывает немедленную перерисовку компонента, не ожидая за- 
вершения каких-то других процессов или прихода от Windows сообщений о пере- 
рисовке. Этим, в основном, этот метод и отличается от Repaint. 

Для перерисовки вызывается функция UpdateWindow АРТ Windows. 


16.3 События 
OnChange — событие класса TCanvas 


Событие происходит сразу после изменения изображения на канве 
Класс TCanvas 


Определение 


typedef void (_ closure *TNotifyEvent) (System: :TObject* Sender); 
_ property Classes::TNotifyEvent OnChange 


Описание 

Событие OnChange наступает после изменения изображения на канве. При 
вызове любого метода рисования осуществляется следующая последовательность 
операций: 


1. Наступает событие OnChanging. 
2. Вызванный метод канвы TCanvas делает изменения в изображении. 
3. Наступает событие OnChange. 


Событие канвы OnChange наступает при изменении именно самого изображе- 
ния, а не свойств канвы. Такие свойства канвы, как объекты Font — шрифт, 
Brush — кисть и Реп — перо имеют свои собственные события OnChange. 


OnChange — событие класса TGraphicsObject 


Событие наступает после изменения графического объекта 
Классы TGraphicsObject, TGraphic 


Определение 


typedef void (_ с1озиге *TNotifyEvent) (System: :TObject* Sender) ; 
__ property Classes::TNotifyEvent OnChange 


+ 
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Описание 
Обработчик события OnChange должен осуществить необходимые операции 
при изменении графического объекта и отразить его новые установки. 


OnChanging 
См. событие канвы OnChange. 


OnClick 


Событие соответствует щелчку мыши на компоненте и некоторым другим дей- 
ствиям пользователя 


Класс TControl 


Определение 


typedef void (_ closure *TNotifyEvent) (System::TObject* Sender); 
__ property Classes::TNotifyEvent OnClick 


Описание 

Обычно событие OnClick наступает, если пользователь нажал и отпустил ос- 
новную кнопку мыши, когда указатель мыши находился на компоненте. Это собы- 
тие происходит также, если: 


Ш Пользователь выбрал элемент в таблице, ‘дереве, списке, выпадающем списке, 
нажав клавишу со стрелкой. 


Ш Пользователь нажал клавишу пробела, когда кнопка или индикатор были в 
фокусе. 

Ш Пользователь нажал клавишу Enter, а активная форма имеет кнопку по умол- 
чанию, указанную свойством Default. 


Ш Пользователь нажал клавишу Esc, а активная форма имеет кнопку прерыва- 
ния, указанную свойством Cancel. 


Ш Пользователь нажал клавиши быстрого доступа к кнопке или индикатору. На- 
пример, если свойство Caption индикатора записано как «&Полужирный» и 
символ II подчеркнут, то нажатие пользователем комбинации клавиш АН-П 
вызовет событие OnClick в этом индикаторе. 


Ш Приложение установило в true свойсто Checked радиокнопки RadioButton. 
Приложение изменило свойство Checked индикатора CheckBox. 
Ш Вызван метод Click элемента меню. 


Для формы событие OnClick наступает, если пользователь щелкнул на пустом 
tiga формы или на недоступном компоненте. 

Параметр обработчика Sender содержит объект, в котором произошло собы- 
тие, и может использоваться для дифференцированной реакции на события в раз- 
ных компонентах. 


Пример 

Один обработчик события OnClick может использоваться для обработки собы- 
тий в различных компонентах. Если при этом требуется различать, в каком компо- 
ненте произошло событие, можно использовать параметр Sender, как в приведен- 
ном чисто демонстрационном примере, отображающем сообщение о том, в каком 
компоненте произошло событие: 


ShowMessage("OnClick в "+((TControl *)Sender)->Name) ; 


В реальной программе, аналогичным образом проанализировав имя компонен- 
та, вы можете предусмотреть для разных компонентов разную реакцию. 
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OnCreate 
Событие происходит при создании формы 
Класс TCustomForm 


Определение 


typedef void (_ closure *TNotifyEvent) (System: :TObject* Sender) ; 
__ property Classes::TNotifyEvent OnCreate 


‘ 


Описание 

Событие OnCreate возникает в момент создания формы и может использовать- 
ся для выполнения каких-то процедур настройки ее самой или содержащихся на 
ней компонентов. Если в обработчике этого события создаются какие-то объекты, 
они должны разрушаться, освобождая память, в обработчике события OnDestroy. 

Последовательность событий при создании формы, имеющей значение свойст- 
ва Visible, равное true: OnCreate, OnShow, OnActivate, OnPaint. 


OnDbIClick 


Событие соответствует двойному щелчку мыши на компоненте 
Классе TControl 


Определение 


typedef void (_ closure *TNotifyEvent) (System: :TObject* Sender) ; 
_ property Classes::TNotifyEvent OnDb1lClick 


Описание 

Событие OnDbIClick наступает, если пользователь осуществил двойной щел- 
чок: дважды с коротким интервалом нажал и отпустил основную кнопку мыши, 
когда указатель мыши находился на компоненте. К одному и тому же компоненту 
нельзя написать обработчики событий OnClick и OnDbIClick, поскольку первый из 
них всегда перехватит первый из щелчков. 

Параметр Зеп4ег содержит объект, в котором произошло событие, и может ис- 
пользоваться для дифференцированной реакции на события в разных компонен- 
тах (см. пример в разделе OnClick). 


OnDragDrop 


Событие наступает в момент отпускания перетаскиваемого компонента над 
данным компонентом 


Классе TControl 


Определение 

typedef void (_ с1озиаге *TDragDropEvent) 
(System: :TObject* Sender, 
System: :TObject* Source, 
nt 3х 316: ; 

_ property TDragDropEvent OnDragDrop 


Описание 

Событие OnDragDrop наступает в момент отпускания перетаскиваемого ком- 
понента над данным компонентом. В обработчике события надо описать, что в этот 
момент должно произойти. Параметр Source соответствует перетаскиваемому объ- 
екту, а параметр Sender — объекту, над которым объект был отпущен. Параметры 
Х и У содержат координаты позиции курсора мыши над компонентом в системе 
координат клиентской области этого компонента. 
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Примеры 


1. Пусть на форме имеется несколько списков типа TListBox и вы хотите позво- 
лить пользователю перемещать строки из одного списка в другой. Это можно 
сделать следующим образом. 


Во всех списках задаются значения свойств DragMode, равные dmAutomatic. 
Это обеспечивает автоматическое начало перетаскивания. 


Далее для одного из списков пишется обработчик события OnDragOver вида: 


void _fastcall TForml::ListBoxlDragOver (TObject *Sender, 
TObject *Source, int X, int Y, TDragState State, 
bool &Ассер®) 

{ 


Accept = Source->ClassNamelIs ("TListBox") ; 


} 


Этот обработчик указывает, что на данный компонент можно перетаскивать 
объекты типа TListBox. 


Во всех остальных списках в событии OnDragOver указывается этот же обра- 
ботчик. 


Далее для одного из списков пишется обработчик события OnDragDrop вида: 


void  fastcall TForml::ListBoxlDragDrop(TObject *Sender, 
TObject *Source, int X, int Y) 
{ 
TListBox *S = (TListBox *) Source; 
( (TListBox*) Sender) ->Items->Add ( 
S->Items->Strings [S->ItemIndex]); 
S->Items->Delete (S->Itemindex) ; 
} 


Первые два оператора обработчика добавляют в список строку, выделенную в 
списке-источнике. Если пишется не универсальный обработчик, а предназна- 
ченный только для данного компонента, то первый оператор можно удалить, а 
во втором ((TListBox*)Sender) и $ заменить на имя компонента 1.15 Вох1. Тре- 
тий оператор удаляет перенесенную строку из источника (если требуется не 
перенос, а только копирование строк из одного списка в другой, то этот опера- 
тор не нужен). 


Во всех остальных списках в событии OnDragDrop указывается этот же обра- 
ботчик. 


После этого, заполнив списки, можно запускать приложение. Пользователь 
сможет перетаскивать строки между любыми имеющимися списками. 


2. Если приведенный выше пример по каким-то соображениям желательно осу- 
ществлять не в автоматическом режиме, а в режиме ручного управления (на- 
пример, перетаскивание возможно только в каком-то конкретном режиме ра- 
боты приложения), то отличия в реализации примера заключаются в следую- 
щем. 


Во всех списках задаются значения свойств DragMode, равные dmManual. Это 
обеспечивает управление началом перетаскивания. 


Затем в одном из списков задается обработчик события OnMouseDown вида: 


void _fastcall TForml::ListBox3MouseDown(TObject *Sender, 
TMouseButton Button, TShiftState Shift, int X, int Y) 
{ 
if ((Button == mbLeft) && <проверка какого-нибудь условия>) 
((TControl*) Sender) ->BeginDrag (false, 5) ; 
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В этом обработчике первое условие проверяет, что нажата именно левая кноп- 
ка мыши, а в качестве второго можно задать какое-то условие, по которому на- 
жатие кнопки мыши можно ассоциировать с началом перетаскивания (если 
вы предусматриваете подобное условие). Затем методом BeginDrag начинается 
перетаскивание. Поскольку в параметрах метода заданы значения false и 5, то 
перетаскивание в действительности начнется только после сдвига мыши на 5 
пикселей. 


Во всех остальных списках в событии OnMouseDown указывается этот же об- 
работчик. 


Все остальные обработчики событий не отличаются от указанных в предыду- 
щем примере. 


3. Ряд примеров использования технологии перетаскивания Drag&Drop вы мо- 
жете найти в главе 4 в разделе 4.4.1. 


OnDragOver : 
Событие относится KO времени, в течение которого пользователь перемещает 
перетаскиваемый объект над компонентом 


Классе TControl 


Определение 


typedef void (_ closure *TDragOverEvent) ( 
System: :TObject* Sender, System::TObject* Source, 
int Х, int У, TDragState State, bool &Accept); 

__ property TDragOverEvent OnDragOver 


Описание 

Событие OnDragOver начинается в момент, когда перетаскиваемый объект пе- 
ресек границу данного компонента и оказался внутри его контура. Заканчивается 
событие, когда объект, покидая компонент, пересек его границу. Обработчик со- 
бытия OnDragOver используется для того, чтобы дать сигнал о готовности компо- 
нента принять перетаскиваемый объект в случае, если пользователь отпустит его 
над данным компонентом. Если компонент готов принять объект, в обработчике 
надо задать значение параметра Accept, равное true. Впрочем, это значение по 
умолчанию равно true, так что его можно не задавать. Вообще в предельном случае 
обработчик может быть пустым, что будет означать готовность компонента при- 
нять любой объект. Но даже пустой обработчик нужен, так как иначе сообщения о 
приеме компонента приложение не получит. 

Во время перетаскивания над компонентом объекта, который может быть при- 
HAT, форма курсора мыши может изменяться, сигнализируя пользователю о готов- 
ности компонента принять объект. Чтобы это было так, надо до момента события 
OnDragOver (а обычно — во время проектирования) задать соответствующее зна- 
чение свойства компонента DragCursor. 

Параметр Source определяет перетаскиваемый объект, параметр Sender — 
сам компонент, параметры Х и У — координаты точки экрана в пикселях. Пара- 
метр State типа TDragState определяет состояние перетаскиваемого объекта по 
отношению к другим объектам. Возможны следующие состояния: 


О И ela Capi 
dsDragEnter Курсор мыши входит в пределы компонента.  — 
Курсор мыши выходит за пределы компонента. 
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Пример 


void _fastcall TForml::ListBoxlDragOver(TObject *Sender, 
TObject *Source, int X, int Y, TDragState State, 
bool é&Accept) 


{ 
Accept = (((TControl*) Sender) ->Маме == "ListBoxl"); 


} 


Этот обработчик события OnDragOver сигнализирует о том, что компонент го- 
тов принять перетаскиваемый объект, если это компонент ListBox1. 

Развернутый пример обработки событий при перетаскивании, в частности, со- 
бытия OnDragOver, вы можете найти в разделе OnDragDrop. | 


OnEndDrag 


Событие наступает в момент прерывания или окончания перетаскивания ком- 
понента 


Класе TControl 


Определение 
typedef void (_ closure *TEndDragEvent) ( 

System: :TObject* Sender, 

System: :TObject* Target, int X, int Y); 
__ property TEndDragEvent OnEndDrag 


Описание 

Событие OnEndDrag наступает при любом окончании процесса перетаскива- 
ния компонента — успешном (компонент перетащен в приемник) или безуспеш- 
ном (компонент отпущен над формой или компонентом, не способным его при- 
нять). Событие наступает в перетаскиваемом компоненте. 

Обработка этого события не требуется для осуществления процесса перетаски- 
вания. Соответствующий обработчик может быть написан, если требуется какое-то 
действие или сообщение, подтверждающее результат перетаскивания, или ка- 
кая-то реакция в перетаскивавшемся компоненте. . 

Параметр Sender — это сам объект перетаскивания. Параметр Target — это 
компонент-приемник, если объект был им принят, или NULL, если перетаскива- 
ние закончилось неудачей. Параметры Х и У — координаты экрана в пикселях. 

Пример 

void _fastcall TForml::ListBoxlEndDrag(TObject *Sender, 

TObject *Target, int X, int Y) 

{ 

if (Target == NULL) 
ShowMessage ("Перенесение объекта "+ : 
((TControl*)Sender)->Name + " прервано"); 
else 
ShowMessage (((TControl*) Sender) ->Name + " перенесен в" 
+ ((TControl*) Target) ->Name) ; 
} 


В этом примере просто отображается сообщение о результатах перетаскивания 
типа «Перенесение объекта ListBoxl прервано» или «ListBoxl перенесен в 
ListBox2». Но, конечно, аналогичным образом можно предусмотреть любые дейст- 
вия. 


ОпЕщег 


Событие наступает в момент получения элементом фокуса 
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Классе TWinControl 


Определение 


typedef void (closure *TNotifyEvent) (System: :TObject* Sender) ; 
__property Classes::TNotifyEvent OnEnter 


Описание 

Событие OnEnter наступает в момент получения элементом фокуса. Это собы- 
тие не наступает при переключениях между формами или между приложениями. 

При переключениях между элементами, расположенными в разных контейне- 
pax, например, на разных панелях, событие OnEnter сначала наступает для кон- 
тейнера, а потом для содержащегося в нем элемента. Это противоположно последо- 
вательности событий OnExit, которые при переключении на компонент другого 
контейнера наступают сначала для компонента, а потом для контейнера. 


Пример | 

Пусть форма имеет кнопку ОК и групповую панель, включающую три радио- 
кнопки. Пусть в начальный момент активна кнопка ОК. Когда пользователь щелк- 
нет на одной из радиокнопок, в кнопке ОК наступит событие OnExit, затем насту- 
пит событие ОпЕщег групповой панели, и только затем наступит событие OnEnter 
той кнопки, на которой щелкнули. Если после этого пользователь щелкнет на 
кнопке OK, то сначала наступит событие OnExit радиокнопки, затем событие On- 
Exit групповой панели, а затем событие OnEnter кнопки OK. 


OnExit 
Событие наступает в момент потери элементом фокуса 
Класс TWinControl 


Определение - 


typedef void (. closure *TNotifyEvent) (System: :TObject* Sender) ; 
__ property Classes::TNotifyEvent OnExit 


Описание 

Событие OnExit наступает в момент потери элементом фокуса, в момент его 
переключения на другой элемент. Это событие не наступает при переключениях 
между формами или между приложениями. 

Значение свойства ActiveControl изменяется прежде, чем происходит событие 
OnExit. 

При переключениях между элементами, расположенными в разных контейне- 
pax, например, на разных панелях, событие OnExit сначала наступает для элемен- 
та, а потом для содержащего его контейнера. Это противоположно последователь- 
ности событий OnEnter, которые при переключении из другого контейнера на ком- 
понент данного контейнера наступают сначала для контейнера, а потом для компо- 
нента. 

Пример, поясняющий последовательность событий при переключениях фоку- 
са, приведен в разделе OnEnter. 


OnKeyDown 
Событие наступает при нажатии пользователем любой клавиши 
Класе TWinControl 


Определение 


enum Classes. _1 { ssShift, ssAlt, ssCtrl, ssLeft, ssRight, 
ssMiddle, ssDouble }; 
typedef Set<Classes 1, ssShift, ssDouble> TShiftState; 
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typedef void (closure *TKeyEvent) (System: :TObject* Sender, 
| Word &Key, Classes::TShiftState Shift); 


_ property TKeyEvent OnKeyDown 


Описание 

Событие OnKeyDown наступает, если компонент находится в фокусе, при на- 
жатии пользователем любой клавиши, включая функциональные и вспомогатель- 
ные, такие, как Shift, АЁи Си. 

В обработчик события передаются, кроме обычного параметра Sender, указы- 
вающего на компонент, в котором произошло событие, также параметры Кеу и 
Shift. Параметр Key определяет нажатую клавишу клавиатуры. Для не алфавит- 
но-цифровых клавиш используется виртуальный код АРТ Windows. Эти коды и 
способы проверки параметра Кеу приведены в главе 15 в разделе 15.1.1. Коды не 
различают символы в верхнем и нижнем регистрах и не различают символы ки- 
риллицы и латинские. ) 

Параметр Shift является множеством, которое может быть пустым или вклю- 
чать следующие элементы: 


5] 


ssShift [Нажми 
ect [Ната nama И. 


Значения элементов Shift, соответствующие нажатиям кнопок мыши, в дан- 
ном событии не используются. 


Примеры | 
Пусть вы хотите распознать комбинацию клавиш Alt-X. Для этого вы можете 
написать оператор: 


if((Key == 'X') && Shift.Contains(ssAlt)) ... ; 

Реакцию Ha нажатие пользователем клавиши Enter можно оформить одним из 
следующих операторов: 

1Е(Кеу == 13) ... ; 
или 

if (Key == 0х0) ... ; 
или 

if (Key == УК ВЕТОВМ) ... ; 


OnKeyPress 


Событие наступает при нажатии пользователем клавиши символа 
Класс TWinControl 


Определение 


typedef void (_ closure *TKeyPressEvent) ( 
System: :TObject* Sender, char &Кеу); 
__property TKeyPressEvent OnKeyPress 


Описание 

Событие OnKeyPress наступает, если компонент находится в фокусе, при Ha- 
жатии пользователем клавиши символа. Параметр Кеу в обработчике этого собы- 
тия имеет тип Char и соответствует символу нажатой клавиши. При этом различа- 
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ются символы в верхнем ‘и нижнем регистрах и символы кириллицы и латинские. 
Клавиши, не отражаемые в кодах ASCII (функциональные клавиши и такие, как 
Shift, Alt, Ctrl), не вызывают этого события. Поэтому нажатие таких комбинаций 
клавиш, как, например, Shift-A, генерирует только одно событие OnKeyPress, при 
котором параметр Key равен «А». Для того, чтобы распознавать клавиши, He COOT- 
ветствующие символам, или комбинации клавиш, надо использовать обработчики 
событий OnKeyDown и ОпКе ; 

Следует отметить, что событие OnKeyPress заведомо наступает, если нажима- 
ется только клавиша символа или клавиша символа при нажатой клавише Shift. 
Если же клавиша символа нажимается одновременно с какой-то из вспомогатель- 
ных клавиш, то событие OnKeyPress может не наступить (произойдут только со- 
бытия OnKeyDown при нажатии и OnKeyUp при отпускании) или, если и насту- 
пит, то укажет на неверный символ. Например, при нажатой клавише Alt событие 
ОпКеуРге5$ при нажатии символьной клавиши не наступает. А при нажатой кла- 
више Ctrl событие OnKeyPress при нажатии символьной клавиши наступает, HO 
символ не распознается. | 

Поскольку параметр Кеу передается в обработчик по ссылке, его можно изме- 
нять, передавая для дальнейшей стандартной обработки другой символ, как в при- 
веденных ниже примерах. 


Примеры 
1. Пусть вы хотите, чтобы пользователь не мог вводить в окно редактирования 
Edit1 какие-либо символы, кроме цифр. Это можно сделать, написав для Editl 
следующий обработчик события OnKeyPress: 
зе. <сцаг; 0%; :19*> Dige 
Dig << 0“ << is << 121 << 13! << 14! 
Sd 8B t CK NGS et ee UR! <<. Nts 
if ( ! Dig.Contains (Key) ) 
Key = 0; 
Этот оператор трансформирует все не цифровые символы в нулевые и они He 
будут отражаться в окне редактирования. 
2. Приведенный ниже оператор обработчика события OnKeyPress переводит ла- 
тинские символы в верхний регистр, независимо от того, в каком регистре на- 
брал их пользователь: 


Key = UpCase (Key); 


Этот оператор действует только на латинские символы. Приведенный ниже 
аналогичный оператор действует и на латинский символы, и на символы ки- 
риллицы (подробнее см. в раздела 15.4.2.3 главы 15): 


Key = AnsiUpperCase (Key) [1]; 


OnKeyUp , 
Событие наступает при отпускании пользователем любой клавиши 
Класс TWinControl 
Определение 


enum Classes _1 { ssShift, ssAlt, ssCtrl, ssLeft, ssRight, 
ssMiddle, ssDouble }; 
typedef Set<Classes 1, ssShift, ssDouble> TShiftState; 


typedef void (closure *TKeyEvent) (System: :TObject* Sender, 
Word &Key, Classes::TShiftState Shift); 


_ property TKeyEvent OnKeyUp 
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Описание 

Событие OnKeyUp наступает, если компонент находится в фокусе, при отпус- 
кании пользователем любой ранее нажатой клавиши, включая функциональные и 
вспомогательные, такие, как Shift, Alt mu Ctrl. | 

В обработчик события передаются, кроме обычного параметра Sender, указы- 
вающего на компонент, в котором произошло событие, также параметры Кеу и 
Shift. Параметр Key определяет клавишу клавиатуры, которая отпускается. Для 
не алфавитно-цифровых клавиш используются виртуальные коды API Windows. 
Эти коды и способы проверки параметра Кеу приведены в главе 15 в разде- 
ле 15.1.1. Коды не различают символы в верхнем и нижнем регистрах и не разли- 
чают символы кириллицы и латинские. 

Параметр Shift является множеством, которое может быть пустым или вклю- 


чать следующие элементы: 
ne ey 
Значение | 


Отпускается клавиша Shift. 


| Отпускается клавиша АН. 


Отпускается клавиша Ctr 


4 
| 


Значения элементов Shift, соответствующих нажатиям кнопок мыши, в дан- 
ном событии не используются. | 

Событие OnKeyUp наиболее удобно, чтобы распознавать нажатые клавиши, 
особенно, комбинации клавиш. Надо только не забывать, что параметр Кеу имеет 
тип word, а He char, так что для распознавания надо использовать виртуальные 
коды. К тому же, надо учитывать, что виртуальный код не различает символы в 
верхнем и нижнем регистре и не реагирует на то, русский или английский язык 
включен в данный момент. 


Примеры 

Пусть вы хотите написать обработчик, который бы реагировал на нажатие 
клавиш Shift-Y. Проверить нажатые клавиши можно оператором: 

if((Key == 'Y') && Shift.Contains(ssShift)) ..: ; 

Но он будет реагировать и Ha «У», и на «у», и даже Ha русские буквы «Н» и 


«H», которые обычно расположены на той же клавише, что и латинская «У». Для 
распознавания действительного символа надо использовать событие OnKeyPress. 


OnMouseDown и OnMouseUp 


Событие наступает в момент нажатия пользователем клавиши мыши над ком- 
.понентом 


Класс TControl 


Определение 
enum TMouseButton { mbLeft, mbRight, mbMiddle }; 


enum Classes. 1 { ssShift,--ssAlt, ssCtrl, ssLeft, ssRight, 
ssMiddle, ssDouble }; 
typedef Set<Classes 1, ssShift, ssDouble> TShiftState; 


typedef void (__closure *TMouseEvent) (System::TObject* Sender, 
TMouseButton Button, Classes::TShiftState Shift, int X, int Y); 


__ property TMouseEvent OnMouseDown 
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Имеется также парное к данному событие OnMouseUp, наступающее при от- 
пускании нажатой кнопки мыши над объектом. Его определение использует тот 
же тип TMouseEvent: 


_ property TMouseEvent OnMouseUp 


Описание 

Обработка событий OnMouseDown и OnMouseUp используется для операций, 
требуемых при нажатии и отпускании пользователем какой-нибудь кнопки мыши. 

Если требуется различная обработка событий в зависимости от того, какая 
кнопка мыши нажата или какая нажата вспомогательная клавиша, можно анали- 
зировать параметры Button и Shift. Значения параметра Button определяют, ка- 
кая кнопка мыши нажата: mbLeft — левая, mbRight — правая, mbMiddle — сред- 
няя. Параметр Shift представляет собой множество, содержащее помимо обозначе- 
ния нажатой кнопки еще и обозначения нажатых одновременно с этим вспомога- 
тельных клавиш Shift, Alt, Ctrl (соответствуют элементам множества ssShift, 
ssAlt, ssCtrl), а также ssDouble — двойной щелчок. Параметры Х и У определяют 
координаты указателя мыши в клиентской области компонента. Параметр Sen- 
der — указатель на компонент, в котором произошло событие. 


Примеры 


1. Обработчик события OnMouseDown может использоваться для начала процес- 
са перетаскивания компонента, если вы решили задать какое-то дополнитель- 
ное условие (например, проверка каких-то опций), по которому можно начи- 
нать перетаскивание. В этом случае. в компоненте вы задаете свойство Drag- 
Mode, равным dmManual, что обеспечивает управление началом перетаскива- 
ния. Обработчик события OnMouseDown может иметь вид: 


void _fastcall TForml::ListBox3MouseDown (TObject *Sender, 
TMouseButton Button, TShiftState Shift, int X, int У) 
{ 
if ((Button == mbLeft) && <проверка какого-нибудь условия>) 
((TControl*) Sender) ->BeginDrag (false,5); 
} 


В приведенной структуре if первое условие (Button == mbLeft) можно заме- 
нить эквивалентным ему условием, проверяющим параметр Shift: 


if (Shift.Contains(ssLeft)) ...; 


2. Если вы пишете обработчик, описанный выше, HO хотите, чтобы перетаскива- 
ние начиналось только в случае, когда пользователь нажал левую кнопку 
мыши при нажатой клавише Alt, оператор обработки может иметь вид: 


if ((Button == mbLeft) && (Shift.Contains(ssAlt) ) ) 
((TControl*) Sender) ->BeginDrag(false,5); 


OnMouseMove 
Событие наступает при перемещении курсора мыши над компонентом 
Класе TControl 


Определение 


enum С1аззез _1 { ssShift, ssAlt, ssCtrl, ssLeft, ssRight, 
ssMiddle, ssDouble }; 
typedef Set<Classes 1, ssShift, ssDouble> TShiftState; 


typedef void ( closure *TMouseMoveEvent) (System: :TObject* Sender, 
Classes::TShiftState Shift, int X, int Y); 
_ property TMouseMoveEvent OnMouseMove 
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Описание | 

Обработчик события OnMouseMove пишется, если надо произвести какие-то 
операции при перемещении курсора мыши над компонентом. 

Параметр Shift, являющийся множеством, содержит элементы, позволяющие 
определить, какие кнопки мыши и какие вспомогательные клавиши (Shift, Ctrl и 
А!) нажаты в этот момент. Параметры Х и У определяют координаты указателя 
мыши в клиентской области компонента. Параметр Sender (источник события) — 
сам компонент. 

Событие OnMouseMove возникает независимо OT того, нажаты ли какие-то 
кнопки или клавиши. Правда, хотя это и не документировано в C++Builder, при 
нажатой правой кнопке мыши (а в некоторых типах мыши — при нажатой левой 
кнопке) это событие, почему-то, не наблюдается. 


Пример 
if (Shift.Contains(ssAlt))... 


Этот оператор проверяет, не нажата ли клавиша Alt во время перемещения 
курсора мыши над компонентом, и, если нажата, то предпринимаются какие-то 
действия. 


OnMouseUp 
См. раздел OnMouseDown и OnMouseUp. 
OnPaint 


Событие наступает при получении сообщения Windows о необходимости пере- 
рисовать испорченное изображение 


Классы TCustomForm, TPaintBox 


Определение 
typedef void (_ closure *TNotifyEvent) (System: :ТОр]ес®* Sender) ; 


__ property Classes::TNotifyEvent OnPaint 


Описание 

Событие OnPaint наступает, когда приходит сообщение Windows о необходимо- 
сти перерисовать испорченное изображение. Изображение может испортиться из-за 
временного перекрытия данного окна другим окном того же или стороннего прило- 
‚ жения. Обработчик данного события должен перерисовать изображение. При пере- 
рисовке изображения канвы Сапуа$ можно использовать ее свойство Cli ‚ KOTO- 
рое указывает область канвы, внутри которой изображение испорчено. 


Примеры 
Если копия изображения, отображаемого на канве, хранится в компоненте 
ВИМар, то обработчик события OnPaint для формы может иметь вид: 


Canvas->Draw(0,0,BitMap) ; 
а для компонента PaintBox 
PaintBox1l->Canvas->Draw(0,0,BitMap) ; 


Более быстрая перерисовка получается при использовании свойства ClipRect 
канвы, например: 


Сапуа$->СоруКесе (Canvas->ClipRect, Bitmap->Canvas, Canvas->ClipRect) ; 


OnProgress 3 


События происходят при медленных процессах изменения графического изо- 
бражения и позволяют построить индикатор хода процесса 
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Классы TGraphic, TImage, T Picture 


Определение 


enum TProgressStage {psStarting, psRunning, psEnding}; 


typedef void (closure *TProgressEvent) (System: :TObject* Sender, 
TProgressStage Stage, 
Byte PercentDone, 
bool RedrawNow, 
const Windows::TRect &R, 
const AnsiString Msg); 


__ property TProgressEvent OnProgress 


Описание 

События OnProgress наступают во время медленных процессов изменения гра- 
фического изображения таких, как загрузка, сохранение, трансформация. Эти со- 
бытия позволяют построить в приложении индикатор хода процесса, обеспечиваю- 
щий обратную связь с пользователем. Разработчики новых компонентов могут ге- 
нерировать события OnProgress, вызывая защищенный метод Progress. 

Параметр Stage указывает стадию процесса: начало, продолжение, оконча- 
ние. Он может соответственно принимать значения psStarting, psRunning и psEn- 
ding. Если приложение предусматривает индикацию процесса, то можно создавать 
индикатор при Stage = psStarting, изменять его показания, пока Stage = psRun- 
ning и закрывать при Stage = psEnding. Параметр PercentDone показывает, какая 
примерно часть процесса выполнена. Этот параметр может использоваться в инди- 
каторе процесса. 

Параметр RedrawNow указывает, может ли изображение в данный момент 
быть успешно отображено на экране. Параметр R указывает область изображения, 
которая изменена и нуждается в перерисовке. 

Параметр Msg содержит краткую справку о протекающем процессе. Напри- 
мер, Loading, Storing или Reducing colors. Строка Msg может быть и пустой. 


OnStartDrag 


Событие наступает, когда пользователь начинает процесс перетаскивания 
компонента 


Класс TControl 


Определение 


typedef void (_ с1озиге *TStartDragEvent) (System: :TObject* Sender, 
TDragObject* &DragObject); 
__ property TStartDragEvent OnStartDrag 


Описание 

Событие OnStartDrag наступает, когда пользователь нажал левую кнопку 
мыши над объектом и, не отпуская ее, начал смещать курсор мыши, т.е. начал пе- 
ретаскивание. 

Обработчик события OnStartDrag позволяет описать какие-то специальные 
действия, необходимые при начале перетаскивания. Параметр Sender является 
тем компонентом, который должен перетаскиваться или который содержит объект 
будущего перетаскивания. 

Переменная DragObject по умолчанию равняется NULL. Это означает, что пе- 
реноситься будет сам компонент или его объект. При этом автоматически создает- 
ся объект типа TDragControlObject, с которым C++Builder осуществляет весь про- 
цесс перетаскивания. Но обработчик может создавать и новый объект перетаскива- 
ния, в котором определен какой-нибудь особый вид курсора и т.п. 
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16.4 Некоторые базовые классы и типы 
Иерархия некоторых базовых классов библиотеки компонентов | 


Полную иерархию классов библиотеки компонентов VCL C++Builder привести 
в данной книге невозможно, поскольку она слишком обширна. Ниже приводится 
только небольшой ее фрагмент, содержащий наиболее интересные для пользовате- 
ля базовые классы. Знание хотя бы общей характеристики этих классов помогает 
получать доступ к свойствам и методам объектов неизвестного класса, что нередко 
требуется и будет рассмотрено в следующем разделе. 


Базовый класс всех объектов VCL. Не име- 
ет никаких свойств, но имеет ряд полез- 
ных методов, применимых ко всем объек- 
там: ClassName, ClassNamels, ClassParent, 
Free, InheritsFrom 


| Базовый класс всех исключений. Определе- 

| ны свойства HelpContext и Message, а так- 

| же конструкторы, используемые BO всех | 
| исключениях | 

| TPersistent Базовый класс всех объектов VCL C++Buil- 

| der, допускающих операцию присваивания 

| или участвующих своими свойствами в 

операциях с потоками. Определен метод 

| присваивания Assign 


TComponent Базовый класс всех компонентов. Опреде- 
| лено свойство Маше — имя компонента и 
| Owner — владелец компонента 


TControl Базовый класс всех визуальных компонен- 
тов. Определено множество свойств, описы- 
вающих размещение компонента, его раз- 
меры, выравнивание, видимость, перетас- 
кивание и т.д. Определено много свойств и 
все основные события, связанные с клавиа- 
турой и мышью \ 


TWinControl Базовый класс всех оконных компонентов. 


Определены свойства и методы, характери- 
| | TCustomEdit 


зующие вид окна, фокусировку, последова- 
тельность табуляции, свойства окна как 
TCustomComboBox 


контейнера других компонентов, процессы 
перетаскивания 


Базовый класс однострочных и многостроч-1 
ных окон редактирования. Определены 
свойства и методы редактирования текста 


Базовый класс выпадающих списков. Опре- 
делены свойства и методы работы с элемен- 
'тами списков 


TButtonControl Базовый класс кнопок и индикаторов. Все 


свойства и методы наследуются от базовых 
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Базовый класс многих неоконных компо- 
нентов, включая метки, графические ком- 
поненты, быстрые кнопки. В нем определе- 
но свойство Сапуаз — холст, являющееся 
основой получения изображений 


| ‘ 
| | 

| TMenu Базовый класс главных и всплывающих 
| меню. Определены свойства и методы до- 
| ступа к разделам меню 

| TMenultem Базовый класс разделов меню. Определены 


их свойства и методы 
TCommonDialog 


TGraphicControl 


Базовый класс диалогов. Определен общий 
для всех диалогов метод их выполнения — 
Execute 


| 
| 
| 
| 


| TField 
| TDataSet 


TStrings 


AnsiString — тип строк 


В C++Builder тип строк AnsiString реализован как класс, объявленный в 
файле vel/dstring.h и аналогичный типу длинных строк в Delphi. Это строки с ну- 
левым символом в конце. При объявлении переменные Tuna AnsiString инициали- 
зируются пустыми строками. 

Для AnsiString определены операции отношения ==, !=, >, <, >=, <=. Сравне- 
ние производится с учетом регистра. Сравниваются коды символов, начиная с пер- 
вого, и если очередные символы не одинаковы, строка, содержащая символ с мень- 
шим кодом считается меньше. Если все символы совпали, но одна строка длиннее 
и в ней имеются еще символы, то она считается больше, чем более короткая. 

Для AnsiString определены операции присваивания =, += и операция склеи- 
вания строк (конкатенации) +. Определена также операция индексации [ ]. Индек- 
сы начинаются с 1. Например, если 51 = «Привет», то $ [1] вернет II’, $512] вер- 
нет 'р’ ит.д. 

Работа с классом AnsiString рассмотрена в главе 13 в разделе 13.4.2. Основ- 
ные методы класса AnsiString (в описаниях методов через 51 обозначена строка, 
метод которой используется): 


Базовый класс полей наборов данных. 
Определены общие для всех полей свойства 
доступа: AsFloat, AsInteger и т.п. 


Базовый класс наборов данных (TTable, 
TQuery, TStoredProc и др.). Определены 
общие для всех наборов данных свойства и 
методы 


Класс объектов, представляющих собой 
списки строк и используемых во многих 
компонентах C++Builder для различных 
свойств. Определены свойства и методы до- 
ступа и манипулирования строками 
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| AnsiCompare 


Сравнивает данную строку S1crhsc учетом регистра. Сравне- 
ние зависит от текущих установок Windows и может отличать- 
ся от сравнения, осуществляемого операциями сравнения. Воз- 
вращает значение > 0 при $1 > rhs, значение < 0 при $1 < rhs 
и значение 0 при 51 = rhs 


AnsiCompare- 
IC 


int __fastcall AnsiCompareIC(const AnsiString& rhs) const 


Осуществляет сравнение, аналогичное AnsiCompare, но без 
учета регистра 


char* __fastcall AnsiLastChar() const 


Возвращает указатель на последний значащий символ. Поддер- 
живает многобайтные символы 


AnsiLastChar 


| AnsiPos int _ Газфса!Й AnsiPos(const AnsiString& subStr) const 


| AnsiString 


Возвращает индекс первого символа первого вхождения SubStr 
в 51. Индексы начинаются с 1. Если subStr не содержится в 
51, возвращается 0. В отличие от Pos поддерживает многобай- 
тные символы 


__fastcall AnsiString(aprymeurt) 
Конструктор класса. В зависимости от типа аргумента создает: 


Пустую строку 


const char* sre Строку с нулевым символом в 


конце из массива символов 


const AnsiString& src Копию AnsiString src 


const char* src, unsigned Строку с нулевым символом в 
char len конце, являющуюся копией 
первых len символов из src 


| const wchar_t* sre Строку с нулевым символом в 
| конце из массива SrC символов 
типа wchar_t 


значений символов 


eget tg co оао re ene 


конце из массива зге целых 
double sre 


Строку с нулевым символом в 
конце из массива src значений 

символов с плавающей запятой; 
преобразуются первые 15 знача- 
щих разрядов 


char* __fastcall c_str()const 


Возвращает указатель Ha строку с нулевым символом в конце, 
содержащую те же символы, что в AnsiString 


| СогтТо$ static AnsiString __fastcall CurrToStr(Currency value) | 
pa | Mpecbpasyer значениеча:мелима Currency в OTpoKy 4 
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| СиггТо5 г Е static AnsiString __fastcall CurrToStrF(Currency value, 
| TstringFloatFormat format, int digits) 


Преобразует значение value типа Currency в строку, используя 
указанный формат преобразования чисел с плавающей запятой 
(см. в главе 14 раздел тип TstringFloatFormat). Параметр 

определяет задаваемое число разрядов. Функция соответствует 
функции CurrToStrF с заданной точностью 19 разрядов 


| Delete void __fastcall Delete(int index, int count) 
| Удаляет из строки, начиная с позиции index число символов, 
равное count 


FloatToStrF static AnsiString __fastcall FloatToStrF(long double value, 

| TStringFloatFormat format, int precision, int digits) 

! Преобразует значение value с плавающей запятой в строку, ис- 

| пользуя указанный формат (см. в главе 14 раздел Tun TstringF- 
loatFormat). Параметры precision и digits задают точность и 

| число разрядов. Точность должна задаваться не более 7 для 


типа float, не более 15 для double и не более 18 для Extended. 
Число разрядов зависит от выбранного формата 


| static AnsiString __fastcall Format(const AnsiString& format, 

| const TVarRec “args, int size) 
Формирует строку, используя строку формата format и массив 
аргументов args 

| FormatFloat static AnsiString __fastcall FormatFloat( | 


const AnsiString& format, const long double& value) | 
IntToHex 


IsDelimiter 


Преобразует значение value с плавающей запятой в строку, ис- 
пользуя указанный формат format (см. в главе 14 раздел 
«Строка форматирования чисел с плавающей запятой») 


void __fastcall Insert(const AnsiString&é& str, int index) 


static AnsiString __fastcall IntToHex(int value, int digits) 


Преобразует значение value в строку, содержащую минимум 
digits шестнадцатеричных цифр 


bool __fastcall IsDelimiter(const AnsiStringé& delimiters, 
int index) const 


Возвращает true, если символ с индексом index является од- 
ним из разделителей, указанных в строке delimiters. Работает 
и для многобайтных символов 


IsEmpty bool __fastcall IsEmpty() const 
Возвращает true, если строка пустая 


LastDelimiter |шф __fastcall LastDelimiter(const AnsiString& delimiters) const | 


| 
Вставляет в строку подстроку str, начиная с индекса index 
| 
| 
| 
| 
| 
| 


Возвращает последний из символов строки, входящих в строку | 
разделителей delimiters. Например, если 


AnsiString $ = "c:\\filename.ext"; 
то 

-s.LastDelimiter("\\.:" ); 
вернет 12 (индекс символа точки) 
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| ‘Length int _fastcall Length() const 
| Возвращает число символов в строке 


LowerCase AnsiString __fastcall LowerCase() const 


| 

| 

| Возвращает строку, в которой все символы приведены к ниж- 
| нему регистру. Не влияет на исходную строку 
| 
| 
| 


| int __fastcall Pos(const AnsiString& subStr) const 

| Возвращает индекс первого символа первого вхождения SubStr 

| в $1. Индексы начинаются с 1. Если subStr не содержится в 

| 51, возвращается 0. В отличие от AnsiPos не поддерживает 

| многобайтные символы 

/SetLength void __fastcall SetLength(int newLength) 

| Усекает строку до newLength символов. Если исходная строка 
короче, то она не увеличивается 

| StringOfChar static AnsiString __fastcall StringOfChar(char ch, int count) 

| 

| Возвращает строку, в которой символ ch повторен count раз. 

| Например, 

| AnsiString s = AnsiString::StringOfChar('A', 10); 

| задаст строке $ значение «АААААААААА, 

| | SubString AnsiString __fastcall SubString(int index, int count) const 

| Возвращает подстроку, начинающуюся с символа в позиции 

| index и содержащую count символов 

| ToDouble double __fastcall ToDouble() const 
Преобразует строку в число с плавающей запятой. Если строка 

не соответствует формату числа с плавающей запятой, генери- 
руется исключение EConvertError 

Tomnt int __fastcall ToInt() const 

| Преобразует строку в целое число. Если строка не соответству- | 

ет формату целого числа, генерируется исключение EConvert- 
Еггог 

/ToIntDef int _fastcall ToIntDef(int defaultValue) const 

| Преобразует строку в целое число. Если строка He соответству- | 

| ет формату целого числа, возвращается значение по умолча- | 

| нию default Value 

| Trim AnsiString __fastcall Trim() const 

| Возвращает строку, соответствующую исходной, но без пробе- 

| льных символов до и после значащих символов 

TrimLeft AnsiString __fastcall TrimLeft() const 

| Возвращает строку, соответствующую исходной, HO без началь- 

| ных пробельных символов 

TrimRight AnsiString __fastcall TrimRight() const 


Возвращает строку, соответствующую исходной, но без заклю- 
| чительных пробельных символов 


Свойства, методы, события, типы, классы | 1109 


| Unique void __fastcall Unique() 


Делает строку уникальной, т.е. устанавливает число ссылок на 
нее (refcnt) в 1. Таким образом, на нее ссылается только один 
объект 


| 
| 


| 


| UpperCase AnsiString __fastcall UpperCase() const 


Возвращает строку, в которой все символы приведены к верх- 
нему регистру. Не влияет на исходную строку 


| У 4еСьаг wehar_t* __{азёсаП WideChar(wchar_t* dest, 
| int destSize) const 


Преобразует строку в массив символов dest типа wchar_t u 
возвращает указатель на этот массив 


| WideCharBuf- |int __fastcall WideCharBufSize() const 
| Size 


Возвращает размер буфера, требуемого для функции WideChar | 


Set — шаблон класса 


Является шаблоном, реализующим встроенный класс Delphi, используемый в 
библиотеке компонентов VCL 


Модуль vcl/sysset.h 


Определение 


template<class T, unsigned char minEl, unsigned char maxEl> 


Class  declspec(delphireturn) Set; 


Описание 
В шаблоне должно быть задано три параметра: 


оса Е ИТ ы ый я И ИС СНЫ 
фуре тип элементов множества (обычно int, char или enum) 

minval минимальное значение элемента множества (не менее 0) 
maxval максимальное значение элемента множества (He более 255) 


Тип каждого объекта класса Set определяется всеми тремя параметрами. Если 
какие-то из этих параметров различаются, считается, что это объекты разных ти- 
пов и их нельзя, например, сравнивать друг с другом. Например, если объявлены 
объекты 


Set: <cha?r, <*“At "<*> Si} 
Set '‘<thar;* 1X? 292" Ss 823 


TO оператор 
if(sl == $2) 


будет воспринят как ошибка, поскольку типы $1 и $2 различны. 
Для объектов класса Set определены методы, соответствующие всем операци- 
ям, допустимым для множеств (см. раздел 13.6 главы 13). 
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TBitmap — класе СИН | nal 
Инкапсулирует битовую матрицу Windows (HBITMAP), ‘включая палитру 
(HPALETTE) 
Иерархия TObject — TPersistent — TGraphic 


Модуль graphics 


Описание 

Класс TBitmap инкапсулирует битовую матрицу Windows, включая палитру. 
Обеспечивает быстрое и простое для пользователя выполнение операций создания, 
копирования, преобразования и сохранения битовой матрицы, 


‚ Свойства 
Ниже приведен полный список свойств, определенных или переопределенных 
в TBitmap. 


Определяет пространство 
(холст) для изображения бито- 
вой матрицы. Свойство только 
для чтения, 


| Empty Указывает, содержит ли объ- 
| ект битовую матрицу. Свойст- 
| во только для чтения. 


| HBITMAP Обеспечивает доступ к обработ- 
ке битовых матриц в GDI Win- 
dows. Используется при вызо- 
вах функций АРТ Windows. 


| HandleType enum TBitmapHandleType Указывает, является ли бито- 

| {bmDIB, bmDDB} вая матрица DDB (Device De- 

| pendent Bitmap — аппаратно 

| зависимой), или DIB (Device 

| Independent Bitmap — аппа- 

| ратно независимой). Может из- 
| меняться пользователем. 
пе Указывает высоту изображе- 


int 
ния в пикселях. Может изме- 
няться пользователем, что вы- 
в. ая 
an Pesci. vcr 
| 


зывает создание копии матри- 
MaskHandle |HBITMAP 


Определяет, использует ли 
матрица палитру. При уста- 
новке в true ухудшается каче- 
ство, но ускоряется рисование. 


Определяет, было ли модифи- 
цировано изображение после 
его загрузки. 


Обеспечивает доступ к обработ- 
ке битовых матриц в GDI Win- 
dows. Используется при вызо- 
вах функций API Windows. 
Свойство только для чтения. 


цы с указанным размером. 


Свойства, методы, события, типы, классы 1111 


Monochrome Определяет, является ли бито- 
вая матрица монохромной 
(значение true). 


Palette HPALETTE Управляет цветами битовой 
матрицы с 256 цветами. Если 
изображение не нуждается в 
палитре или не имеет палит- 
ры, TO Palette = 0. 


PixelFormat |enum TPixelFormat {pfDevice, |Определяет битовый формат 
pflbit, pf4bit, pf8bit, pfl5bit, |отображения изображения. Ис- | 
pfi6bit, pf24bit, pf32bit, пользуется для задания форма- | 
pfCustom} Ta видеодрайверам, He способ- 

ным прочитать собственный 
формат битовой матрицы. 


ScanLine Обеспечивает доступ к отдель- 
ным строкам пикселей для их 
низкоуровневой обработки для 
матриц DIBs (Device Indepen- 
dent Bitmap — аппаратно неза- 
висимых). Свойство только для | 
чтения. 


Transparent Определяет, должно ли изобра- 
жение быть «прозрачным» 


Определяет, какой из цветов 
будет прозрачным при рисова- 
нии битовой матрицы. Читае- 
мое значение зависит от значе- 
ния Тгапзрагеп Моде. 


Transparent- |enum TTransparentMode Определяет, будет ли свойство 


| Моде {tmAuto, tmFixed} TransparentColor сохраняться 
вместе с битовой матрицей. 


Указывает ширину изображе- 
ния в пикселях. Может изме- 
няться пользователем, что вы- 
зывает создание копии матри- 
цы с указанным размером. 


Методы 
Ниже приведены основные методы, объявленные или переопределенные в 
классе TBitmap. 


[Метод Описание 


Assign | Копирует изображение из другого графического объек- 
та, в частности, из буфера обмена Clipboard. 


Dormant Создает изображение битовой матрицы в памяти, чтобы 
освободить дескриптор матрицы и сэкономить ресурсы 
ЕгееГ паре Освобождает память, занятую кэшированием изображе- 


ния, экономит ресурсы, но может вести к потере глуби- 
ны цвета. См. описание и пример в разделе Dormant. 
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Описание 


Копирует изображение из другого графического объек- | 
та, в частности, из буфера обмена Clipboard. | 


LoadFromClipboard- | Читает изображение из буфера обмена Clipboard в за- | 
данном формате. | 
| 


Загружает битовую карту из ресурса по указанному 
имени. 


Читает графическое изображение из указанного потока. 
Преобразует изображение в монохромную маску. 


Возвращает дескриптор типа HBitmap и очищает объ- 
ект TBitmap от этого дескриптора. 

Возвращает дескриптор маски типа HBitmap и очищает 
объект TBitmap от этого дескриптора. 

Возвращает дескриптор палитры типа HPalette и раз- 
рывает связь палитры с объектом TBitmap. 

Сохраняет изображение в буфере обмена Clipboard в за- 
данном формате. 


| Событие Описание | 
| OnChange Событие при изменении графического объекта | 


События происходят при медленных процессах измене- 
ния графического изображения и позволяют построить 
индикатор хода процесса 


TBrush — тип 
Определяет свойства кисти: цвет и стиль заполнения фона окна 
Иерархия TObject — ТРегз1з4ет1 — TGraphicsObject 
Модуль graphics 


Описание | 

Тип TBrush инкапсулирует структуру HBRUSH Winodws и используется для 
заполнения форм заданным цветом и стилем. TBrush используется во многих объ- 
ектах, в частности, в свойстве канвы кисть — Brush. 


Свойства 


| Свойство Описание 
| 


| Bitmap TBitmap Указатель на внешнюю матрицу побитового отобра- 
| жения, используемую Kak шаблон заполнения. | 


Свойства, методы, события, типы, классы 1113 


Описание 
Цвет кисти. По умолчанию — clWhite. 


Handle Дескриптор кисти окна, определяющий доступ к де- 
скриптору объекта GDI Windows. 


Методы 

В классе TBrush не введено каких-то принципиально новых методов. Переоп- 
ределены такие общие методы, как Assign, конструктор и деструктор. Остальные 
методы наследуются от классов-предков. 


События 

Класс TBrush наследует от класса TGraphicsObject событие OnChange, насту- 
пающее после изменения графического объекта. Обрабатывая его графический 
объект должен учесть новые установки TBrush. 


Пример 

Следующие операторы изменяют цвет и стиль заполнения объекта Imagel-> 
Canvas — канвы компонента Imagel: 

Imagel->Canvas->Brush->Style = bsCross; 


Imagel->Canvas->Brush->Color = clRed; 
Imagel->Canvas->FillRect (Rect(0, 0, Imagel->Width, Imagel->Height) ); 


Последний из приведенных операторов заполняет методом FillRect всю no- 
верхность канвы. 


TCanvas — класс 


Обеспечивает пространство (холст, канву) для создания, хранения и модифи- 
кации графических объектов 


Иерархия TObject — TPersistent 
Модуль graphics 


Описание 
Класс TCanvas является основой графической подсистемы C++Builder. Канва 
обеспечивает: 


Ш Загрузку и хранение графических изображений 

Ш Создание новых и изменение хранимых изображений с помощью пера, кисти, 
шрифта 

Ш Рисование и закраску различных фигур, линий, текстов 

Ш Комбинирование различных изображений 


Класс TCanvas имеет два дочерних класса — TControlCanvas и TMetafile- 
Canvas, которые помогают в прорисовке управляющих элементов и в создании для 
объекта метафайла. 


Свойства 
Ниже приведен полный список свойств, определенных или переопределенных 


в TCanvas. 
Свойство Описание 
Определяет цвет и стиль заполнения зам- 


TBrush 
кнутых фигур и фона 
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| Свойство Тип ны 


| Сапуа$Ог1- |enum TCanvasOrien- |Определяет обычную (слева направо) и вос- 
| entation tation {coLeftTo- точную (справа налево) ориентацию канвы и 


| Right, coRightToLeft} | ее координат. Свойство только для чтения 
Е 
cual a 


LockCount Определяет, сколько раз блокирована кан- | 
ва в многопоточных приложениях. Свойст- | 
во только для чтения | 
Определяет свойства пера, рисующего ли- | 
нии и фигуры 


| 
| 
ыы Определяет текущую позицию пера | 
Pixels |TColor [Определяет цвета пикселей | 
| TextFlags не eet Определяет способ вывода текста на канву | 


Методы 
Ниже приведены основные методы, объявленные в классе TCanvas. 


| 
| 
| 
| 


Определяет доступную область рисования 
на канве и область, подлежащую перери- | 
совке при событии OnPaint. Свойство толь- | 
ко для чтения 


Определяет режим копирования графиче- 
ского изображения на канву 


[Meron | Описание _ 
epee. eb | Рисует дугу окружности или эллипса 


| BrushCopy Копирует часть изббражения битовой матрицы на данную 


канву, заменяя указанный цвет в изображении на значение, 
установленное для кисти канвы 


Chord Рисует замкнутую фигуру, ограниченную дугой окружности 
или эллипса и хордой 


рае графическое изображение в указанную позицию кан- 
| Ога\ЕосизВес* |Рисует`изображение прямоугольника в виде, используемом 
для отображения рамки фокуса, операцией хог 


Ellipse Рисует окружность или эллипс 

FillRect Заполняет указанный прямоугольник канвы, используя Te- 
Kylee значение кисти Brush 

FloodFill Закрашивает текущей кистью замкнутую область канвы, 
определенную цветом 


Рисует на канве текущей кистью прямоугольную рамку 


Рисует на канве прямую линию, начинающуюся с текущей 
позиции пера и кончающуюся указанной точкой 


Свойства, методы, события, типы, классы 1115 


sheila ЕВЕ ОУН 1 


Описание | | 


Блокирует канву, не разрешая другим нитям многопоточного 
приложения рисовать на ней 


Изменяет текущую позицию пера на заданную, ничего не ри- 
суя 


Рисует сектор окружности или эллипса 


Сглаживают множество точек кусочной кривой третьего по- 
рядка, сохраняя первую и последнюю точку 


Сглаживают множество точек кусочной кривой третьего по- 
рядка, сохраняя последнюю точку 


Рисует замкнутую фигуру с кусочно-линейной границей 


Рисует кусочно-линейную кривую 


| Рисует прямоугольник 
| Рисует прямоугольник со скругленными углами 


| Рисует графическое изображение в указанную прямоуголь- 
| ную область канвы, подгоняя размер изображения под задан- 
ную область 


Возвращает высоту в пикселях текста, который предполага- 
ется написать на канве текущим шрифтом 


Пишет указанную строку текста на канве, начиная с указан- 
ной позиции 


| TextRect Пишет указанную строку текста на канве, начиная с указан- 
| ной позиции и усекая текст, выходящий за пределы указан- 
ной прямоугольной области 


шая другим нитям многопоточного приложения рисовать на 
ней 


Уменьшает на единицу значение свойства LockCount, способ- 
ствуя тем самым разблокированию канвы, когда LockCount 
станет равным 0 


| Событие Описание 
| OnChange Событие после изменения изображения 
Событие перед изменением изображения | 


TColor — тип 


Определяет цвет объекта 


1116 Глава 16 


Модуль Graphics 
Определение 
enum TColor {с1М1п=-Ох7ЕЕЕЕЕЕЕ-1, Сс1Мах=Ох7ЕЕЕЕЕЕЕ}; 


Описание 

Тип TColor используется для описания цвета объекта. Применяется в свойст- 
вах Color многих компонентов, в подсвойствах объекта типа TFont, при прорисов- 
ке изображений, в таблицах и т.д. | 

В модуле Graphics определено множество констант типа ТСо]ог. Одни из них 
непосредственно определяют цвета (например clBlue — синий), другие определяют 
цвета элементов окон, которые могут меняться в зависимости от выбранной поль- 
зователем палитры цветов Windows (например, clBtnFace — цвет поверхности 
кнопок). Полный перечень этих констант с пояснениями см. в разделе Color. 

Вместо использования этих констант можно задавать TColor как 4-байтовое ше- 
стнадцатеричное число, три младших разряда которого представляют собой интен- 
сивности синего, зеленого и красного цвета соответственно. Например, значение 
OxOOFFOOOO соответствует чистому синему цвету, OxOO00FFOO — чистому зеленому, 
$000000-Е — чистому красному. 0х00000000 — черный цвет, OxOOFFFFFF — белый. 

Если старший байт равен нулю (00), то берется ближайший к заданному цвет 
из системной палитры. Если старший байт равен единице (01), то берется ближай- 
ший к заданному цвет из текущей палитры. Если старший байт равен двум (02), то 
берется ближайший к заданному цвет из логической палитры контекста данного 
устройства. 


TComponent — базовый класс компонентов 


Базовый класс всех компонентов C++Builder 
Иерархия TObject — TPersistent 
Модуль classes 


Описание 
Класс TComponent является прародителем всех компонентов C++Builder. Он 
инкапсулирует наиболее общие свойства и методы компонентов, включая: 


Ш Возможность включать компонент в палитру компонентов и работать с ним 
при визуальном проектировании. 
Ш Способность быть владельцем других компонентов или управляться другими 
компонентами. 
Ш Возможности обмена с потоками и файлами. 
Ш Возможность служить оболочкой элементов ActiveX и других объектов. 
Объекты типа TComponent не создаются. Класс TComponent используется как 
базовый, когда объявляется класс невизуального компонента, который может при- 
сутствовать в палитре компонентов и применяться в процессе проектирования. 
Для создания визуальных компонентов в качестве базового используется класс 
TControl или его потомки. Для создания оконных компонентов в качестве базового 
используется класс TWinControl или его потомки. 


Свойства 


| Свойство Описание 


| ComObject _di_ TUnknown Защищенное свойство, возвращающее 


ссылку на интерфейс в компонентах, 
поддерживающих стандарт СОМ 


Свойства, методы, события, типы, классы 1117 


[Свойство Tun [Описание 


| mina | Число компонентов, которыми владеет 

| данный компонент. Равно количеству 
элементов в массиве Components. На 1 
меньше индекса последнего компонента 
ComponentIndex, поскольку индексы OT- 
считываются от 0. Может использоваться 
вместе с ComponentIndex в циклах, Kor- 
да надо изменить какие-то свойства всех 


компонентов 


| ComponentIndex |i Индекс компонента в массиве Compo- 

| nents владельца данного компонента. От- 

| считывается от 0, т.е. индекс первого 

| компонента — 0. Может использоваться 
вместе с ComponentCount в циклах, ког- 
да надо изменить какие-то свойства всех 
компонентов 


| Components _|TComponent * Массив компонентов, которыми владеет 
данный компонент. Позволяет сослаться 
на любой компонент с помощью его Сот- 
| ponentIndex 


| Сотропеп {же |TComponentState | Состояние компонента в процессе визуа- 

| льного проектирования. Свойство только 
для чтения. Во время выполнения не ис- 
пользуется 


|ComponentStyle |TComponentStyle |Определяет множество флагов стиля ком- 
понента, в частности, стиль csInheritable 


указывает, что компонент может принад- 
лежать форме 


те Используется только в среде C++Builder 
при проектировании форм. В приложени- 
ях не используется 

| Name AnsiString Имя компонента, по которому произво- 

| дится ссылка на него из других компо- 

| нентов 


TComponent * Определяет владельца данного компонен- 
| та. Форма является владельцем всех pac- 
| положенных на ней компонентов. В свою 
| очередь Application является владельцем 
| всех форм. Когда освобождается память, 
| занимавшаяся владельцем, автоматиче- 

ски освобождается память всех компо- 
| нентов, которыми OH владел. Свойство 
| только для чтения 


‘Ta ag Это свойство He используется в C++Buil- 
der. Разработчик может использовать его 

| по своему усмотрению 

VCLComObject | void * Используется только в среде C++Builder 
компонентов, поддерживающих стандарт 
COM 
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Методы 

В классе TComponent определено множество методов. Ниже приводятся те из 
них, которые определены или переопределены в TComponent, причем только Te, 
которые наиболее часто используются пользователями при работе с компонента- 
ми. Остальные используются для внутренних потребностей C++Builder. 


| DestroyComponents | Удаляет из памяти все компоненты, которыми владеет 
данный компонент. Непосредственно этот метод не испо- 
льзуется — он автоматически вызывается, когда вы уда- 
ляете компонент ключевым словом delete 


Ищет в списке Components компонент с заданным име- 
нем 


FreeNotification Гарантирует, что указанный в вызове компонент будет 
разрушен. Используется только по отношению к компо- 
нентам, расположенным на других формах. Для компо- 
нентов на текущей форме вызывается автоматически 


| InsertComponent Добавляет указанный компонент в конец списка компо- 
нента-владельца. При визуальном проектировании вызы- 
вается автоматически. Специально может потребоваться 
вызов этого метода только при добавлении компонента в 
список другого владельца 


|RemoveComponent | Удаляет указанный компонент из списка компонента-вла- 
дельца. При визуальном проектировании вызывается ав- 
томатически. Специально может потребоваться вызов это- 
го метода только при удалении компонента из список 
другого владельца 


Класс TComponent наследует также метод Assign класса TPersistent и другие 
методы своих предшественников. 


TControl — базовый класс визуальных компонентов 


Абстрактный базовый класс всех визуальных компонентов C++Builder 
Иерархия TObject — TPersistent — TComponent 
Модуль controls 


Описание 

Класс TControl является базовым классом для всех визуальных компонентов 
C++Builder, т.е. для компонентов, которые пользователь может видеть и которы- 
ми манипулирует во время выполнения приложения. Все они имеют общие свойст- 
ва, методы и события, определяющие место их размещения, расцветку, реакцию 
на нажатие клавиш или кнопок мыши и т.д. 

Защищенные свойства и методы класса TControl используются в их потомках. 
Если требуется создать новый класс визуального компонента, его надо создавать 
как производный от TControl или от его потомков. 


Свойства 
Класс TControl имеет следующие основные свойства: 
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| Свойство ‘Tun [Описание 
| Action | TBasicAction * Определяет действие, связанное с 
| ‚ | данным управляющим элементом 
|Align | enum TAlign { alNone, Определяет способ выравнивания 
| alTop, alBottom, alLeft, | компонента в контейнере (родите- 
| alRight, alClient } льском компоненте) 
| Anchors С] 
Left, akTop, akRight, компонента к родительскому при 
| akBottom } изменении размеров последнего 
| AutoSize Определяет, будет ли высота эле- 
| мента автоматически адаптирова- 
| ться к размеру символов текста 


=] 
: > 


enum TAnchors { ak- Определяет привязку данного 


BoundsRect TRect Определяет координаты углов 

| компонента в координатах содер- 
жащего его контейнера` 

| Caption System::AnsiString Строка текста, идентифицирую- 


щая компонент для пользователя, 
Обычно это надпись на метке, 
кнопке и др. компонентах 


ClientHeight int Высота клиентской области в 
пикселях 


ClientOrigin Windows::TPoint Координаты положения на экране 
левого верхнего угла клиентской 

области компонента. Свойство то- 
лько для чтения 


ClientRect Windows::TRect Определяет координаты углов 

| клиентской области компонента 
| Client Width Горизонтальный размер клиент- 
| ской области в пикселях 
Graphics::TColor Цвет фона компонента | 


Constraints 


: 


Позволяет задавать ограничения 
на допустимые изменения разме- 
ров компонента при изменениях 
размеров окна приложения 


TSizeConstraints 


ControlState 


| ControlStyle 


TControlState Характеризует текущее состояние 
компонента во время выполнения 
приложения. Используется при 


создании новых классов 


Определяет характеристики стиля 
компонента. Используется при со- 
здании новых классов 


TControlStyle 


| 
| 
| 
| 
Определяет вид курсора мыши, 
при попадании его в область ком- | 
понента | 
Определяет, использует ли компо- 
нент для отображения текста 
изображение шрифта Windows 
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| Свойство Описание 


| DockOrientation |enum TDockOrientation |Определяет позицию данного 

| { doNoOrient, doHori- |встраиваемого компонента относи- 
zontal, doVertical } тельно других встроенных KOMIIO- 
нентов. Компоненты могут встра- 

иваться горизонтально или верти- 
кально 


Определяет вид курсора мыши, 
при попадании его в область ком- 
понента в процессе перетаскива- 
ния 


| DragCursor TCursor 


Определяет, будет ли объект пере- 
таскиваться по технологии 
Drag&Drop, или Drag&Doc 


TDragKind = (dkDrag, 


| DragKind 
| dkDock) 


| DragMode 
ae ie ce 


Floating 


TDragMode = (dmMa- 
nual, dmAutomatic) 


Определяет автоматическое или 
программное начало процесса пе- 
ретаскивания 


Определяет, реагирует ли компо- 
нент на события, связанные с мы- 
шью, клавиатурой и таймером 


Определяет, находится ли компо- 
нент в состоянии «плавающего» 
окна (см. главу 4 раздел 4.4.2). 
Свойство только для чтения 


Определяет класс временного 
компонента, управляющего «пла- 
вающим» окном 


|Hint ~ AnsiString `Определяет текст подсказки 


| HostDockSite TWinControl* Определяет контейнер, в который 
встроен данный компонент. Зада- 
| ние HostDockSite приводит к He- 
медленному встраиванию компо- 

нента в указанный контейнер. 


Если компонент никуда не встро- 
ен, HostDockSite = NULL 


Определяет, сохраняет ли форма 
свои специфические свойства в 
поток. Свойство защищенное. Ис- 
пользуется при создании новых 
компонентов 


| 
| 
| 


ЕЕ ЕН 


Координата левого края компо- 
нента в пикселях 


LRDock Width Ширина компонента, когда OH в 


последний раз размещался в кон- 


тейнере горизонтально. Свойство 


Свойства, методы, события, типы, классы _ 1121 


а 


[Свойство Тин [Опибание 


ада фана Определяет, может ли компонент 
захватываться мышью. Свойство 
защищенное. Используется при 
создании новых компонентов 


‘Name —_| AnsiString Имя компонента 


ame 
Parent TWinControl Определяет родительский KOMIIO- 


нент, в площади которого распо- 
лагается данный компонент 


| ParentColor 


saline ees 


Определяет, что для компонента 
будет заимствован цвет родитель- 
ского компонента. См. разделы 

Color и Parent 


Включает и выключает использо- 
вание шрифта родительского ком- 
понента 


Включает и выключает использо- 
вание свойства ShowHint родите- 
льского компонента 


| ParentShowHint 


Определяет связанный с компонен- 
том объект всплывающего меню 


Показывает, какие атрибуты ком- 
понента должны масштабировать- 
ся. Используется при разработке 

новых компонентов 


enum Controls _9 
{ sfLeft, sfTop, sfWidth, 
sfHeight, sfFont } 


| ScalingFlags 


Разрешает или запрещает показы- 
вать окно подсказки 


Высота компонента, когда он в 
последний раз размещался в кон- 

тейнере вертикально. Свойство то- 
лько для чтения 


| Text TCaption = string Текст, связанный с данным KOM- 
понентом 

Тор Координата верхнего края компо- 
нента в пикселях 


| UndockHeight 


ee т 


Width int 


Высота компонента, которая была 
в последний раз, когда он отобра- 
жался плавающим окном. Свойст- 
во только для чтения 


Ширина компонента, которая 
была в последний раз, когда он 

отображался плавающим окном. 
Свойство только для чтения 


Делает компонент видимым или 
‘невидимым 


Горизонтальный размер компо- 
нента в пикселях 
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| Свойство Описание 


| WindowProc TWndMethod Содержит оконную процедуру об- 
| работки сообщений, поступающих 
компоненту. Используется при со- 
здании новых компонентов 


| WindowText PChar Содержит текст, связанный с дан- 
| ным компонентом 


Помимо перечисленных свойств класс TControl наследует также ряд свойств 


TComponent, из которых можно отметить ComponentCount, ComponentIndex, 
Components, Owner, Tag и другие. 


Методы 

Ниже приводится таблица только тех методов, которые могут применяться 
пользователями компонентов или разработчиками не очень сложных компонен- 
тов. Помимо перечисленных в классе определено еще много методов, интересных 
только для разработчиков сложных новых компонентов. 


Merox [Описание 
BeginDra Начинает процесс перетаскивания компонента 
свойствах данного компонента сделаны какие-то изме- 


— 
| 

| ° 

| beginDrag 

| BringToFront 

; 

| нения, на которые должен прореагировать родитель- 
| 


Переносит компонент в 7-последовательности выше 
других компонентов на той же форме 


Используется, чтобы послать сообщение 
CM CHANGED родительскому компоненту, если в 


Changed 
ский компонент 


ChangeScale Изменяет масштаб компонента 


Click Вызывает обработчик события OnClick при щелчке 
мыши. Используется при проектировании новых клас- 
сов 


| ClientToScreen Преобразует координаты клиентской области в коорди- 

| наты экрана 

DbI1Click Вызывает обработчик события OnDbIClick при двойном 

| щелчке мыши. Используется при проектировании но- 

| вых классов 

| DoEndDock Вызывает обработчик события OnEndDock. Использу- 

| ется при проектировании новых классов 

| DoEndDrag Вызывает обработчик события OnEndDrag. Использу- 
ется при проектировании новых классов 

| DoStartDock Вызывает обработчик события OnStartDock. Использу- 

| ется при проектировании новых классов 

DoStartDrag Вызывает обработчик события OnStartDrag. Использу- 
ется при проектировании новых классов 


Вызывает обработчик события OnDragDrop. Использу- 


DragDrop 


ется при проектировании новых классов 


| 
| DragCanceled Прерывает перетаскивание. Используется при проекти- 
| `ровании новых классов 


Свойства, методы, события, типы, классы 1123 


Meron Описание 


| Dragging Определяет, перетаскивается ли компонент в данный 
| момент 
| EndDrag 


|GetControlsAlignment | Возвращает вариант выравнивания текста в компонен- 
| те 


Завершает (успешно или неуспешно) перетаскивание. 
Используется при проектировании новых классов 


Возвращает характер выравнивания рамок встраивае- 
мых компонентов, перемещаемых над данным контей- 
нером. Вызывается автоматически 


| GetDockEdge 


Записывает в заданный буфер фиксированного размера 
значение свойства Text. Используется, если нужна о0б- 
ратная совместимость с 16-битными кодами 


GetTextBuf 
BossppaiaerT-AIMHYy строки свойства Text, необходимую 


| _GetTextLen 
для задания размера буфера в методе GetTextBuf 


Г ИЕ О a SL 


| 
| 
| 
| Invalidate Вызывает полную перерисовку испорченного изображе- | 
| ния компонента | 
| MouseDown Вызывает обработчик события OnMouseDown. Исполь- 
зуется при проектировании новых классов | 
| MoubeRfove Вызывает обработчик события OnMouseMove. Исполь- | 
зуется при проектировании новых классов 
MouseUp Вызывает обработчик события OnMouseUp. Использу- 
ется при проектировании новых классов 
| Немедленно перерисовывает компонент на экране, вы- 
зывая метод Repaint | 
| Вера Немедленно перерисовывает компонент на экране, вы- 
зывая при необходимости метод Invalidate | 
| 


|ReplaceDockedControl | Встраивает компонент на место другого уже встроенно- 
| го компонента 


| ScreenToClient Преобразует координаты экрана в координаты клиент- 
ской области компонента 


Записывает в заданный рае значение свойства Text. 
Используется, если нужна обратная совместимость с 
16-битными кодами 


Изменяет, как и SetBounds, полное описание Houde. 
Rect, но не перерисовывает изображение компонента 
на экране 
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Помимо перечисленных методов и многих других вспомогательных, класс TCon- 
trol наследует методы своих классов-предков. 


События 
В классе TControl, в отличие от предшествующих ему в иерархии, описаны не 
‚только свойства и методы, но и следующие события: 


Описание 
Событие перед началом изменения размеров компонен- 


та. Позволяет отказаться от изменения размеров или 
уточнить новую длину и ширину компонента 


| Событие 


| OnCanResize 


Событие при щелчке на компоненте и некоторых других 
действиях пользователя 


| OnDragDrop Событие при отпускании перетаскиваемого компонента 
| OnDragOver Событие при перетаскивании объекта над компонентом 


Событие при окончании или прерывании перетаскива- 
ния и встраивания 


OnEndDrag Событие при окончании или прерывании перетаскивания 
| OnMouseDown Событие при нажатии кнопки мыши Hay ‘объектом 
| OnMouseMove Событие при перемещении указателя мыши над объектом 


} 


Событие при отпускании нажатой кнопки мыши над 
объектом 


OnResize Событие после изменения размеров компонента 


Событие при начале перетаскивания и встраивания объ- 
екта | 


| OnStartDrag Событие при начале перетаскивания объекта 


TControlState — тип 
См. ControlState 


TControlStyle — тип 
См. ControlStyle 


TCursor — тип 


См. Cursor 
TCustomEdit — базовый класс окон редактирования 


Абстрактный базовый класс окон редактирования 
Иерархия TObject — TPersistent — TComponent — TControl — TWinControl 
Модуль stdctrls 


Свойства, методы, события, типы, классы 1125 


Описание 

Класс TCustomEdit является базовым классом для окон редактирования Edit 
и Memo. В нем инкапсулированы основные методы и свойства, используемые при 
редактировании текстов. Они обеспечивают: 


Ш Такие функции редактирования текста, как выделение фрагмента, преобразо- 
вания выделенного текста, чувствительность к регистру. 


Ш Возможность откликаться на изменения в тексте. 


Ш Управление доступом к тексту, например, доступ «только для чтения» или 
символы пароля, делающие невидимыми вводимые символы. 


Создавать экземпляры объектов типа TCustomEdit невозможно. Этот класс ис- 
пользуется только для создания производных классов, наследующих особенности 
обработки текстов. 


Свойства 
Основные свойства класса TCustomEdit: 


| Свойство 


| AutoSelect AutoSelect Определяет, выделяется ли весь текст при по- 
лучении элементом фокуса 

| AutoSize AutoSize Определяет, будет ли высота элемента ABTOMA- 

| тически адаптироваться к размеру символов 
текста | 


BorderStyle enum {bsNone, | Определяет наличие рамки вокруг окна редак- 
| bsSingle}; тирования. В комбинации с СИЗО создает pas- 


личные зрительные эффекты 


|CanUndo Указывает, были ли произведены в тексте опе- 
| рации редактирования, которые могут быть 

| удалены командой Undo. Может использовать- 

| ся для регулирования доступа к соответствую- 
| щему разделу меню. Свойство только для чте- 

| HUA 


CharCase enum TEdit- Определяет регистр отображаемого текста: ес- 
| CharCase Normal — все символы отображаются с уче- 
{ ecNormal, том регистра, в котором был введен каждый 
ecUpperCase, |из них, ecUpperCase — все символы текста 
ecLowerCase }; | приводятся к верхнему регистру, ecLowerCa- 
se — все символы текста приводятся к нижне- 
му регистру 


При значении true делает невидимым выделе- 
ние части текста, когда компонент теряет фо- 

кус. В противном случае выделение остается и 
при потере фокуса 


Устанавливает максимальную длину текста. 
Значение 0 указывает на неограниченную длину 


Указывает символ, появляющийся в окне ре- 
дактирования вместо вводимого пользователем 
символа. При значении 0 отображается вводи- 
мый символ, в противном случае — заданный 
символ ввода пароля 


| Undo Отмена результатов последней операции редактирования 
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| Свойство Описание 


ReadOnly mentee Устанавливает запрет редактирования текста 


| пользователем 


SelLength 


| Указывает первый символ выделенного фраг- 
мента текста. Если выделения нет, то указывает 
символ, перед которым расположен курсор 


| 


Содержит выделенный фрагмент текста. Мож- 
но задавать значение SelText, чтобы заменить 
им выделенный текст. Если выделения нет, то 
задание SelText приведет к вставке заданного 


| Зе! Тех 
| текста в позицию курсора (SelStart) 


a 


System::Ansi- 
String 


Помимо этого имеется множество свойств, наследуемых от TWinControl. 


Методы 
Ниже приводится таблица основных методов класса TCustomEdit. 


у Аи 


Описание 


| Clear Удаление всего текста 


ClearUndo Очистка буфера, используемого для команды Undo. После 


этого сделанные изменения в тексте не могут быть отме- 
нены 


CopyToClipboard Копирование в буфер Clipboard выделенного текста 
| CutToClipboard Вырезание в буфер Clipboard выделенного текста 


| PasteFromClipboard | Вставка текста из буфера Clipboard вместо выделенного 


ClearSelection Удаление выделенного текста 


текста или, если нет выделения, то вставка текста в по- 


зицию курсора 


SelectAll 


События 
В классе TCustomEdit определено только одно событие: 


Событие Описание 


OnChange Событие при попытке изменения пользователем текста. 
определить по значению свойства Modified 


| Произошло ли изменение в действительности, можно 


TDragMode — тип ‘ 
Cm. DragMode. 


TFont — тип 


Определяет характеристики шрифта 


Свойства, методы, события, типы, классы 1127 


Иерархия TObject — TPersistent — TGraphicsObject 
Модуль graphics 


Описание 

Объект типа TFont определяет множество характеристик, описывающих 
шрифт, используемый при отображении текстов: высоту шрифта, его имя, атрибу- 
ты (полужирный, курсив) и т.д. Используется в свойстве Font. | 

Основное свойство объекта — название шрифта Name. Если используется 
шрифт с несколькими наборами символов, то надо правильно установить свойство 
Charset — набор символов. | 

Если заданная комбинация свойств Name, CharSet, Pitch, Size определяет 
шрифт, отсутствующий в системе, Windows подберет другой близкий шрифт. 

При создании объекта TFont он инициализируется следующими значениями 
свойств: Color = clWindowText, Name = MS Sans Serif, Size равным 8, Pitch = 
fpDefault, CharSet = DEFAULT_CHARSET. Автоматически устанавливается зна- 
чение PixelsPerInch. 


Свойства 


f — =. — === 


Дескриптор шрифта, используемый как | 
параметр функций API Windows, требу- 
ющих обработки шрифтов. Применяет- 


| 


enum TFontPitch Определяет способ установки ширины 
{ fpDefault, fpVariable, | символов 
fpFixed } 


Число пикселей принтера или экрана 
на дюйм. Используется при копирова- 
нии шрифта с канвы формы на при- 
нтер, чтобы обеспечить соответствие 
размеров шрифта на экране и принте- 
ре. Влияет только на печать. Изменя- 
ться пользователем не должно 


Размер шрифта в кеглях (пунктах) 


enum TFontStyle Стиль шрифта — множество свойств: 
{ fsBold, fsItalic, fsUn- | полужирный, курсив, подчеркнутый, 
|derline, fsStrikeQut } 


| 
НЕЕ 


Методы 
TFont имеет методы, унаследованные от базовых классов, HO переопределен- 
ные с учетом особенностей данного класса. Среди них можно отметить следующий: 
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И И МИР К ELISEO IRE IO, 


Assign Копирование свойств одного объекта типа TFont в другой объ- 
ект. Свойство PixelsPerInch методом Assign не копируется. 
Поэтому метод можно использовать для копирования экран- 
ных шрифтов в шрифты принтера и наоборот 


События 

TFont наследует событие OnChange от базового класса TGraphicsObject. 

Развернутые примеры использования и исследования типа TFont см. в разде- 
ле Font. 


TGraphic — базовый класс графических объектов 


Абстрактный базовый класс графических объектов типа битовых матриц, 
пиктограмм, метафайлов и типов, определенных пользователем 


Иерархия TObject — T Persistent 
Модуль graphics 


Описание 

Класс TGraphic обеспечивает производные от него классы методами хранения, 
манипулирования и визуализации графических объектов, методами работы с объ- 
ектами типа TPicture и с буфером обмена Clipboard. Свойства класса TGraphic 
дают информацию о состоянии и размерах изображения. 

Когда тип графики, с которой ведется работа, известен: битовая матрица, пик- 
тограмма или метафайл, можно использовать объекты производных OT TGraphic 
классов TBitmap, Тсоп или TMetafile соответственно. Если формат графики неиз- 
вестен, то можно использовать класс TPicture, способный работать с графически- 
ми объектами любых типов, производных от TGraphic. 


Свойства 
Ниже приведен список свойств, определенных в TGraphic. 


нь би“: Onktatine | 


Empty Указывает, содержит ли объект изображение. 

= Свойство только для чтения 

Height Указывает высоту изображения в пикселях. Для 
битовых матриц может изменяться пользовате- 

| лем, что вызывает создание копии матрицы с 

| указанным размером . 

| Modified Указывает, был ли изменен графический объ- 
ект. Может принимать значение фгие (изменен) 
только для битовых матриц. Для пиктограмм и 
метафайлов всегда равен false, даже если изме- 
нения были 


| Palette HPALETTE | Управляет цветами графического изображения. 
| Если изображение He нуждается или не имеет 
| палитры, TO Palette = 0 


Указывает, была ли изменена палитра графиче- 
ского объекта. Используется в обработчиках со- 


бытий OnChange 
Указывает, является ли изображение прозрач- 


ee: ee 


ным. Используется только для битовых матриц 


| PaletteModified 


— 
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в lem | Bag 


Указывает ширину изображения в пикселях. 
Для битовых матриц может изменяться пользо- 
вателем, что вызывает создание копии матрицы 
|с указанным размером 


Методы 


Ниже приведены основные методы, объявленные или переопределенные в 
классе TGraphic. 


Копирует изображение из другого графического 
объекта, в частности, из буфера обмена i 


Читает графическое изображение из указанного 
потока 


Сохраняет изображение в буфере обмена Clipboard 
в заданном формате 


|SaveToFile Сохраняет изображение в файле 
| SaveToStream SaveToStream Записывает изображение в поток 


События 


|Собыше | Ommcamme _ 
| 
| | OnChange Событие при изменении графического объекта 


События происходят при медленных процессах из- | 
менения графического изображения и позволяют 
построить индикатор хода процесса 


ТТеоп — классе 
Инкапсулирует пиктограмму Windows 
Иерархия TObject — ТРегузепт — TGraphics 
Модуль graphics 


Описание 

Класс TIlcon инкапсулирует пиктограмму Windows. Свойства класса ТШеоп 
имеют такие объекты, как TForm и TPicture. 

Пиктограмма соответствует формату файлов .ico Windows. Рисовать пикто- 
граммы на канве можно методом канвы Draw, но метод StretchDraw к нимне при- 
меним, поскольку пиктограммы не могут изменять своих размеров. 


Свойства 
Ниже приведен список основных свойств, определенных или переопределен- 
ных в Топ. 
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Свойство 


Указывает, содержит ли объект пиктограмму. Свойство 
только для чтения 


Обеспечивает доступ к обработке пиктограмм в GDI 
Windows. Используется при вызовах функций API Win- 
dows 


Указывает высоту изображения в пикселях. Размеры 
всех пиктограмм в приложении одинаковы и задаются 
установками Windows. Попытка изменить Height ведет 
к генерации исключения 


Указывает, является ли изображение прозрачным. Мо- 
жет использоваться только для чтения. Попытка изме- 
нить Transparent ведет к генерации исключения 


Указывает ширину изображения в пикселях. Размеры 
всех пиктограмм в приложении одинаковы и задаются 
установками Windows. Попытка изменить Width ведет 
к генерации исключения 


Методы 
Ниже приведены основные методы, объявленные или переопределенные в 
классе Тсоп. 


О cn is = oe kes | 
Assign Копирует изображение из другого графического 

| объекта, в частности, из буфера обмена Clipboard 
| Гоа94ЕготСИрЬоагаЕогта$ | Читает изображение из буфера обмена Clipboard в 
| заданном формате 


| LoadFromFile Читает изображение из файла 


LoadFromStream Читает графическое изображение из указанного 
| потока 
| ReleaseHandle Возвращает дескриптор типа НШсоп и устанавлива- 
ет дескриптор объекта ТТеоп в NULL 
| SaveToClipboardFormat Сохраняет изображение в буфере обмена Clipboard 
| в заданном формате 
| SaveToFile Сохраняет изображение в файле 
SaveToStream 


События 


| Событие Описание 
| OnChange Событие при изменении графического объекта 


OnProgress События происходят при медленных процессах из- 
| менения графического изображения и позволяют 
построить индикатор хода процесса 
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TImageList — компонент и класс 


Список, использующийся для хранения набора изображений одинаковых раз- 
меров, на которые можно ссылаться по индексам 


Иерархия TObject — TPersistent — TComponent — TCustomImageList — TDrag- 
ImageList 


Модуль controls 


Описание 

TImageList используется и как компонент, и как свойство других компонен- 
тов, например, свойство Images компонента типа ТМатМепи. Представляет собой 
набор изображений одинаковых размеров, на которые можно ссылаться по индек- 
сам, начинающимся с 0. Используется для эффективного управления множеством 
пиктограмм и битовых матриц. Может включать в себя монохромные битовые мат- 
рицы, содержащие маски для прозрачности рисуемых изображений. 

Изображения в компонент TImageList могут быть загружены в процессе проек- 
тирования двойным щелчком на компоненте и последующим выбором из файлов. 


Свойства 
Основные свойства, наследуемые TImageList (новых свойств в классе не объ- 
явлено): 


|Свойлвю Ти Описание 
| . 
| AllocBy int Определяет количество изображе- 


ний, на которое увеличивается спи- 
BkColor 


сок для добавления новых изобра- 
BlendColor 


жений 


Graphics::TColor Определяет цвет фона, используе- 
мый при маскировании области 
изображений. Если BkColor равен 
clNone, изображение рисуется про- 
зрачным с использованием маски. В 
противном случае BkColor определя- 
ет цвет вне маски. BkColor не влия- 
ет на изображение, если свойство 


Masked установлено в false 


Graphics::TColor Определяет цвет фона, используе- 
мый при рисовании изображения. 
Это цвет, который комбинируется с 
указанным цветом при значениях 
DrawingStyle, равных dsFocus и 
dsSelected. Значение clNone coor- 
ветствует отсутствию комбинируе- 
мого цвета, а значение clDefault 


означает системный цвет выделения 


Определяет число изображений в 
списке. Свойство только для чтения 


DrawingStyle 


enum TDrawingStyle 
{dsFocus, dsSelected, 
dsNormal, dsTransparent} 


Указывает стиль, используемый при 
рисовании | 


Дескриптор, используемый при вы- 
зовах функций API Windows 


| 
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Тип _ | Описание 
5 [Высота изображений в спике | 


ImageType enum TImageType Определяет, использует ли список 
{itImage, itMask} изображение или маску 


| Masked Определяет, содержит ли список ма- 


| ски, комбинируемые с изображени- 
| Width 


= ——— a Аи 


Свойство 


| 
| 


ями 


События 
В TImageList определено только одно событие: 


Событие Описание | 
OnChange Происходит при изменении списка | 


SS eS a = | 


TList — классе 
Содержит список указателей на любые объекты 
Иерархия TObject 
Модуль classes 


Описание 

Объект типа TList предназначен для хранения и управления списком указате- 
лей на объекты. Свойства и методы TList позволяют добавлять и удалять элементы 
списка, изменять их расположение в списке, сортировать элементы и проводить 
другие манипуляции с данными. 


Свойства 


[Свойство [Twn [Onweamme 
[Capacity — |ш Число указателей, которые могут храниться в объекте | 
[Count | | Число указателей, хранящихся в объеме 
tems _|void* |Элементы массива указателей в объеме | 


Остальные свойства наследуются от базового класса TObject. 
Методы 


О ИИ 
|Add [Добавление нового указателя вок 
[Clear 
Delete | 
[Еегог | Генерация исключения ти 
Exchange 
Expand 


= 
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Добавление нового указателя в список 

Insert 
и en ee 
Remove | 


Сортировка списка _ 


(= th th Я 


Остальные методы наследуются от базового класса TObject. 


Пример 

Ниже приведен пример использования объекта типа TList для создания в па- 
мяти временной базы данных из последовательности записей, содержащих фами- 
лию и год рождения сотрудника. Особенности использования отдельных свойств и 
методов смотрите в соответствующих справочных разделах. 

// Определение типа структуры 


typedef struct 
{ 


AnsiString Name; 

Word Year; 

} Rec; 

// Объявление указателя на структуру 
Rec * PRec; 


TList *MyList = new TList; // Создается список 


PRec = new Rec; // Выделяется место под запись 
PRec->Name = "Петров"; // Заполняются поля записи 
PRec->Year = 1960; 

MyList->Add (РВес); // Указатель на запись заносится в список 


// Те же операции с новой записью 
PRec = new Rec; 

PRec->Name = "Иванов"; 

PRec->Year = 1950; 
MyList->Add(PRec) ; 


// Изменение года рождения - доступ к структуре через список 
((Вес *)MyList->Items[1])->Year = 1970; 


// Поиск в записях самого молодого сотрудника 
РВес = (Вес *)MyList->Items [0]; 
for(int i = 1; i.< MyList->Count; i++) 
if(((Rec *)MyList->Items[i])->Year > PRec->Year) 
PRec = (Rec *)MyList->Items [1]; 
ShowMessage ("Самый молодой - " + PRec->Name) ; 


// Освобождение памяти 

for(int i = 0; i < MyList->Count; i++) 
delete (Rec *)MyList->Items [1]; 
delete MyList; 
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TMetafile — класс 
Инкапсулирует метафайл Win32 Enhanced 
Иерархия TObject — ТРегзазеп? — TGraphic 
Модуль graphics | 


Описание м 

Класс TMetafile позволяет хранить изображения, соответствующие графиче- 
ским метафайлам .emf Windows. Свойства TMetafile описывают размер и характе- 
ристики метафайла. Рисовать метафайлы на канве можно методами канвы Draw и 
StretchDraw. Свойство Enhanced определяет, Kak метафайл хранится на диске: 
true соответствует формату .emf (Win32 Enhanced Metafile), а false — .wmf (Win- 
dows 3.1 Metafile). 


Свойства 
Ниже приведен список основных свойств, определенных или переопределен- 
ных в TMetafile. 


Свойство Описание . 


| CreatedBy AnsiString | Указывает имя автора или приложения, создав- 


шего метафайл. Свойство только для чтения. 
Description AnsiString 


Чтобы задать CreatedBy нового метафайла, надо | 
вызвать конструктор объекта TMetafileCanvas, 
предусматривающий задание CreatedBy 


Определяет не обязательный текст описания ме- 
тафайла. Свойство только для чтения. Чтобы за- 
дать Description нового метафайла, надо вы- 
звать конструктор объекта TMetafileCanvas, 
предусматривающий задание Description 


| Empty Указывает, содержит ли объект метафайл. 
Свойство только для чтения 


Enhanced Значение true соответствует формату хранения 
на диске .emf, а false -.wmf. В памяти мета- 
файл всегда хранится в формате .emf. Формат 
.wmf ведет к частичной потере информации и 
оставлен только для обратной совместимости с 


Windows 3.x 


Дескриптор, используемый для доступа к GDI 
Windows и вызова функций АРТ Windows 


Указывает высоту изображения в пикселях. Мо- 
жет изменяться пользователем 


Используется для метафайлов WMF и указыва- 
ет число единиц на дюйм, необходимое для мас- 


О od 
eee штабирования. Метафайлы EMF хранят эту ин- 


Word 
формацию внутри себя 
Содержит высоту изображения в единицах 0.01 | 
мм. MMHeight дает более точное значение высо- 
ты, чем свойство Height, значение которого из- 
меряется в пикселях 
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a apres Бек I re ea ST 
| Свойство Описание 


| MMWidth Содержит ширину изображения в единицах 0.01 
| мм. MMWidth дает более точное значение ши- 

| рины, чем свойство Width, значение которого 

| измеряется в пикселях 

| Modified НИ Указывает, был ли изменен графический объект 
| Palette НРАГЕТТЕ | Управляет цветами графического изображения. 

| Если изображение не нуждается или не имеет 

| палитры, TO Palette = 0 
| 

| PaletteModified Указывает, была ли изменена палитра графиче- 

| ского объекта. Используется в обработчиках со- 

| 


| бытий OnChange 
Width 


Методы 
Ниже приведены основные методы, объявленные или переопределенные в 
классе TMetafile. 


| Assi : Копирует изображение из другого графического 
| объекта, в частности, из буфера обмена Clipboard 
| Clear | Удаление изображения 


| LoadFromClipboardFormat | Читает изображение из буфера обмена Clipboard в 
| заданном формате 


LoadFromFile Читает изображение из файла 


Указывает, является ли изображение прозрач- 
ным 


Указывает ширину изображения в пикселях. 


| LoadFromStream Читает графическое изображение из указанного 
| потока 


| 
| 
om 
| ReleaseHandle Возвращает дескриптор объекта и устанавливает | 
| его дескриптор в NULL 
| 
| 


SaveToClipboardFormat Сохраняет изображение в буфере обмена Clipboard 
в заданном формате 


| SaveToFile Сохраняет изображение в файле 
| SaveToStream Записывает изображение в поток 


События 


На ыы. ый 
Событие Описание 
OnChange Событие при изменении графического объекта 


| 
| 
OnProgress События происходят при медленных процессах из- 


менения графического изображения и позволяют 
построить индикатор хода процесса . 


| 
| 
| 
| 
| 
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TObject — базовый класс всех объектов 


Базовый класс всех объектов в C++Builder 
Модуль systobj 


Описание 
Класс TObject инкапсулирует основные функции, свойственные всем объек- 
там C++Builder. Интерфейс TObject обеспечивает: 


Ш Возможность создания, управления и разрушения экземпляров объектов, 
включая выделение под них памяти, инициализацию и освобождение памяти 
после их уничтожения. 


Ш Поддержка информации об объектах и типах (run-time type information — 
RTTI). 


Ш Поддержка обработки сообщений. 


Все классы в C++Builder являются прямыми или косвенными наследниками 
TObject. Прямое наследование используется только при объявлении простых клас- 
сов, объекты которых не являются компонентами, не могут присваиваться друг 
другу и не участвуют в операциях обмена с потоками. Подавляющее большинство 
классов являются косвенными наследниками TObject и производятся от промежу- 
точных классов. Если при объявлении нового типа объектов не указывается 
класс-предок, TO C++Builder считает TObject предком нового класса. 

Большинство методов TObject не используются непосредственно в компонен- 
тах, с которыми имеет дело пользователь. Исходные методы TObject обычно пере- 
гружены в классах-наследниках или заменены другими, построенными на их OC- 
нове. 

Хотя формально TObject не является абстрактным классом, но объекты этого 
класса создавать нельзя. 


Методы 

Большинство методов класса TObject пользователями непосредственно не ис- 
пользуется. Ниже приводятся только те методы, прямое обращение к которым мо- 
жет оказаться полезным или которые могут использоваться при создании новых 
классов. 


Метод______ Описание. 
ClassName Возвращает имя типа объекта 


| 
ClassNamels_ |Возвращает true, если передаваемое в функцию имя совпадает 
| с именем данного класса 


ClassParent Возвращает тип непосредственного предка данного класса. 


| 

| 

| 

| 

| 

Create Конструктор. Не осуществляет инициализацию каких-то дан- | 
ных, так что перегружается в классах-наследниках: | 
| 

| 

| 

| 

| 

| 


Уничтожает объект и освобождает выделенную под него па- 
мять. Вызывать этот метод не нужно — он вызывается автома- 
тически при использовании ключевого слова delete 


| FreeInstance 


Освобождает память, выделенную ранее вызванным методом 
NewlInstance. Автоматически вызывается деструктором объек- 
та. Непосредственный вызов пользователем не требуется. Дол- 
жен быть перегружен, если перегружен метод NewInstance. 
Использует InstanceSize для определения размера выделенной 
области памяти 


ие ная 


у 
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Описание 


| Метод 
|\InheritsFrom |Определяет, является ли указанный класс предком данного 
| объекта 


| InitInstance Инициализирует новый объект и указатель на его таблицу вир- 
| туальных методов. Вызывается автоматически методом NewIn- 
stance. Не может быть перегружен 


| 21$$апсе$12е | Возвращает число байтов, занимаемых объектом. Может испо- 
льзоваться для анализа затрат памяти различными типами 
объектов 


| NewlInstance |Выделяет область памяти под объект и возвращает указатель 

| на нее. Автоматически вызывается всеми конструкторами. Ис- 
пользует InstanceSize. Может перегружаться в классах-наслед- 
никах 


ТРеп — тип 


Определяет свойства пера, используемые при рисовании линий и фигур на 
канве 


Иерархия TObject — TPersistent — TGraphicsObject 
Модуль graphics 


Описание 
Tun ТРеп инкапсулирует атрибуты пера Windows при рисовании на канве — 
объекте типа TCanvas. 


Свойства 


[Свойство ___Тип__ Описание 
Цвет пера. По умолчанию — clBlack 


НРЕМ Дескриптор пера окна. Используется для доступа 
| к функциям API Windows 


ode TPenMode |Определяет режим рисования линий 


TPenStyle |Определяет стиль рисования линий 


Width Определяет толщину линии в пикселях. Влияет Ha 
Style = 


Методы 

В классе ТРеп не введено каких-то принципиально новых методов. Переопре- 
делены такие общие методы, как ASSign, конструктор и деструктор. Остальные Me- 
тоды наследуются от классов-предков. 


События 
Класс ТРеп наследует от класса TGraphicsObject событие OnChange, насту- 
пающее после изменения графического объекта. 


TPersistent — базовый класс объектов, участвующих в операциях 
с потоками 


Базовый класс всех объектов C++Builder, допускающих операцию присваива- 
ния или участвующих своими свойствами в операциях с потоками 
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Иерархия T'Obdject 
Модуль classes 


Описание Са 

Класс TPersistent инкапсулирует фундаментальные свойства объектов, кото- 
рые-должны иметь возможность присваиваться друг другу или читать и записы- 
вать свои свойства в поток. Методы класса TPersistent обеспечивают: 


Ш Определение процедур загрузки и сохранения данных в потоке. 
Ш Присваивание значений свойствам. 
Ш Присваивание содержимого одного объекта другому. 
Объекты TPersistent создаваться не могут. Класс используется только для соз- 
дания производных классов. 


- Методы 
Класс имеет следующие методы: 


Описание | 


Из всех этих методов только Assign может непосредственно использоваться 
пользователем при работе с объектами. Остальные могут потребоваться только при 
создании новых классов. 


TPicture — классе 


Описывает объект, являющийся контейнером графических объектов типа би- 
товых матриц, пиктограмм, метафайлов и определенных пользователем типов гра- 
фических объектов 


Иерархия T'Object — T Persistent 
Модуль graphics 


Описание 

Объект типа TPicture является контейнером любого графического объекта 
TGraphic, тип которого. указывается свойством Graphic. Объект TPicture имеет 
полиморфные методы файлового чтения и записи LoadFromFile и SaveToFile, ав- 
томатически подстраивающиеся под тип объекта. 

В зависимости от типа хранимого объекта — битовой матрицы, пиктограммы, 
метафайла, определены соответствующие свойства Bitmap, Icon или Metafile, ука- 
зывающие на графический объект. При ошибочном обращении к этим свойствам 
(если объект в действительности имеет другой тип) прежнее содержимое объекта 
стирается и открывается новый пустой объект указанного типа. Вместо этих 
свойств можно получать доступ к графическому объекту непосредственно через 
свойство Graphic. Таким образом, например, обращения Imagel->Picture->Gra- 
phic и Imagel->Picture->Bitmap эквивалентны, если графический объект — бито- 
вая матрица. 

Обмен объекта TPicture с буфером обмена Clipboard может осуществляться ме- 
тодом Assign объекта TClipboard. 
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Свойства 
В классе TPicture объявлены следующие основные свойства: 


Свойство Описание | 


} 


s ® < 
Bitmap TBitmap Указывает на хранящийся объект как на битовую мат- | 
| puny (формат файла .bmp) | 
Graphic TGraphic | YKasbrpaeT на хранящийся объект как на битовую мат- 
| рицу, пиктограмму, метафайл или определенный по- | 
| льзователем тип | 
| Указывает собственную, не измененную высоту изоб- | 
| ражения в пикселях. Свойство только для чтения | 


TIcon Указывает на хранящийся объект как на пиктограмму 
(формат файла .ico) 


Metafile TMetafile | Указывает Ha хранящийся объект как на метафайл 
(формат файла .emf) | | 


| 
| Width Указывает собственную, не измененную ширину изоб- 
| ражения в пикселях. Свойство только для чтения 


Помимо описанных класс наследует множество свойств родительских классов. 


Методы 
Ниже приведены основные методы, объявленные в классе TPicture. 


Meron Описание | 


|LoadFromClipboardFormat | Читает изображение из буфера обмена Clipboard в | 
заданном формате | 
Це 


LoadFromFil Читает изображение из файла | 


RegisterClipboardFormat |Регистрирует новый формат Clipboard графическо- 
го объекта для использования в методе LoadFrom- 


ClipboardFormat 


| 
| 
| 
| 
| 
RegisterFileFormat Регистрирует новый файловый формат графиче- 
ского объекта для использования в методе Load- 
FromFile 
| 
| 
| 
| 
| 


RegisterFileFormatRes Регистрирует новый файловый формат графиче- 
ского объекта из ресурсов для использования в ме- 
tone LoadFromFile | 


SaveToClipboardFormat Сохраняет изображение в буфере обмена Clipboard | 
в заданном формате | 


| | 
SaveToFile Сохраняет изображение в файле | 
SupportsClipboardFormat |Определяет, поддерживается ли указанный формат | 
| Clipboard графического объекта | | 
UnregisterGraphicClass Удаляет все ссылки Ha ранее зарегистрированный | 
| формат. Clipboard или файла br? ЧО 
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События © 


| собыивь онизание © 
| _OnChange Событие при изменении графического объекта 


| OnProgress События происходят при медленных процессах измене- 
ния графического изображения и позволяют построить 
индикатор хода процесса 


TPoint — тип 
Определяет точку координат в пикселях 
Модуль Windows 
Определение (упрощенное) 


struct TPoint 
{ 


et ee 
Е 
be 
Описание 


Тип TPoint определяет точку координат в пикселях. В частности, во многих 
свойствах этот тип используется для задания координат углов прямоугольников и 
других фигур. В этих случаях началом координат, в зависимости от применения, 
считается левый верхний угол экрана или окна. 

Для задания параметров типа ТРой во многих функциях удобно использо- 
вать функцию Рошф (см. раздел 15.3.3 главы 15), возвращающую структуру 
TPoint. 

Выше приведено упрощенное определение, содержащее только имена полей. 
Полной определение вы можете посмотреть во встроенной справке C++Builder или 
в файле Windows.cpp. 


TRect — тип 
Определяет координаты прямоугольной области 
Модуль Windows 


Определение (упрощенное) 


struct TRect 
{ 
int Left; 
int Top; 
int Right; 
int Bottom; 
}; 
Описание 
Координаты задаются и как четыре целых числа, определяющих координаты 
в пикселях левой, верхней, правой и нижней сторон прямоугольника, и как две 
точки типа TPoint, представляющие собой координаты левого верхнего и правого 
нижнего углов. Началом координат обычно считается левый верхний угол экрана 
или окна. 
Для типа определены функции-элементы Width() и Height(), возвращающие 
соответственно ширину и высоту. Определены также операции «==» и «!=». 
Задавать значения переменной типа TRect удобно функцией Rect, задающей 
координаты левой, верхней, правой и нижней границ — Left, Top, Right, Bottom, 
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или функцией Bounds, задающей координаты левого верхнего угла Left и Top, 
ширину прямоугольника AWidth и его высоту AHeight. См. описания этих функ- 
ций и примеры в главе 15 в разделе 15.3.3. 


TStringFloatFormat — тип 


В ряде методов тип TStringFloatFormat определяет формат представления чи- 
сел строкой 


Определение 


enum TStringFloatFormat {sffGeneral, sffExponent, sffFixed, 
sffNumber, sffCurrency }; 


Различные значения формата означают следующее: 


Значение Описание 


sffGeneral |Значение преобразуется в наиболее компактное из двух форма- 
| тов: с фиксированной точкой или научного формата. Младитие 
| нулевые разряды усекаются. Десятичная точка появляется толь- 
| ко при необходимости. Формат с фиксированной точкой исполь- 
| зуется только при числе цифр целой части большем не больше 


указанной точности и при значениях не меньше 0.00001. В оста- 
льных случаях используется научный формат с минимальным 
числом цифр в степени порядка (от 0 до 4). 


| sffExponent | Научный формат. Значение преобразуется в строку вида 

| «-d.ddd...E+dddd». Символ '-` записывается только для отрицатель- 

| ных чисел. Перед десятичной точкой записывается всегда одна 
цифра. Общее число цифр (включая цифру перед точкой) опреде- 


ляется заданной точностью. После символа 'Е' всегда ставится 
знак + или -. Число цифр в степени (порядок числа) лежит в пре- 
делах от 0 до 4. 


| sffFixed Формат с фиксированной точкой. Значение преобразуется в стро- 
| ку вида «-ddd.ddd...». Символ '-’записывается только для отрица- 
тельных чисел. Перед десятичной точкой записывается пот край- 
ней мере одна цифра. Число цифр поле точки определяется за- 
данным числом разрядов (от 0 до 18). Если число цифр слева от 
точки должно быть больше заданной точности, используется на- 
учный формат. 


isffNumber | Числовой формат. Значение преобразуется в строку вида 
| «-d,ddd,ddd.ddd...». Совпадает с форматом sffFixed за исключени- 
| ем наличия разделителей после каждых трех разрядов в целой 


части. 


sffCurrency | Монетарный формат для представления чисел, отображающих 
денежные суммы. Определяется установками Windows (глобаль- 
ными переменными CurrencyString, CurrencyFormat, NegCur- 
rFormat, ThousandSeparator, DecimalSeparator). Число цифр 
после десятичной точки определяется заданным числом разрядов 


Для всех форматов действительные символы, используемые в качестве деся- 
тичной точки и разделителя тысяч определяются глобальными переменными Deci- 
malSeparator и ThousandSeparator. 
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TStringList — клаес пота 
Список строк с расширенными возможностями манипулирования ими 
Иерархия TObject — TPersistent — TStrings 
‚Модуль classes 


Описание 
Класс TStringList наследует классу TStrings, реализуя многие его абстракт- 
ные свойства и методы и вводя некоторые новые возможности: 


Ш сортировку строк в списке 
Ш запрещение хранения дубликатов строк 
Ш реакцию на изменения содержания списка 


Свойства 
Ниже приведен список основных свойств, определенных в TStringList. 


Свойство 


Описание 


Указывает число строк, которые может содер- 
жать список, позволяет заранее выделить па- 
MATb ДЛЯ добавления нескольких строк 


Число строк в списке. Свойство только для 
чтения 


Возвращает объект, связанный с указанной 
строкой свойства Strings 


System:: 
TObject * 


enum Tduplicates 
{ duplIgnore, 
dupAccept, 
dupError } 


| 


int Index] 


Указывает, могут ли добавляться в сортирован- 
ный список дубликаты строк. Значение duplg- 
поге — игнорирование добавления дубликата, 
dupAccept — разрешение добавления дублика- 
та, dupError — генерация исключения ELis- 
tError при попытке добавления дубликата 
строки. Значения dupAccept и дирЕггог никак 
не реагируют на уже имеющиеся в списке дуб- 
ликаты. На несортированный список свойство 
Duplicates не оказывает никакого влияния 


Указывает, должны ли строки в списке авто- 
матически сортироваться по алфавиту 


System:: Текст строки с указанным индексом. Индекс 


| Strings 


Кроме toro TStringList наследует or TStrings такие свойства, как Comma- 


Text, Names, StringsAdapter, Text, Values. 


Методы | 

Класс TStringList наследует от TStrings такие свойства, Add, Clear, Delete, 
Exchange, IndexOf, Insert и много других. Кроме того в классе TStringList объяв- 
лены методы: 
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Merox [Описание 


| Боо! Find(const System:: |Определяет, имеется ли заданная строка $ в сорти- 
AnsiString $, int &Index) | рованном списке, и, если имеется, то возвращает в 
параметр Index индекс этой строки. Для не сортиро- 
ванных списков следует использовать метод IndexOf 


Сортирует строки списка, свойство Sorted которого 
установлено в false, в возрастающей алфавитной 

последовательности. Если Sorted = true, то список 
сортируется автоматически 


TStrings — класс 


Абстрактный класс объектов, представляющих собой списки строк и исполь- 
зуемых во многих компонентах C++Builder в качестве различных свойств 


Иерархия TObject — T Persistent 
Модуль classes 


Описание 
Класс TStrings содержит методы и свойства, позволяющие манипулировать со 
списками строк: 


Ш Добавлять и удалять строки в указанных позициях 
Перестраивать и упорядочивать последовательность строк 
Получать доступ к конкретным строкам 

Читать и записывать списки строк в файлы и потоки 
Связывать с каждой строкой некоторый объект 


Свойства 
Ниже приведен список основных свойств, определенных в TStrings. 


| Capacity Указывает число строк, которые может содержать 
| список. В классе TStrings чтение Capacity возвра- 
щает значение Count, а запись значения Capacity 
ничего не изменяет в списке. Но в некоторых 
классах, производных от TStrings, свойство Сара- 
CommaText | System:: Возвращает текст, в котором отдельные строки 
AnsiString  |объединены в одну строку формата SDF (system 
data format). Отдельные исходные строки разделя- 
ются в итоговой строке запятыми и каждая стро- 


city позволяет заранее выделить память для добав- 
ления нескольких строк 


ка, если в ней имеются символы пробелов, заклю- 
чается в двойные кавычки. Если в исходных стро- 
ках использовались символы двойных кавычек, 
они дублируются (получается два следующих друг 
за другом символа) 
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| Свойство Описание 
| 


| Матез System:: Применяется для списков, имеющих структуру 
|[int Index] AnsiString | «Ama = Значение». Такую структуру имеют, Ha- 
пример, файлы .ini. Свойство Names возвращает 
Имя, использованное в строке с указанным индек- 
сом. Если строка не имеет форму «Имя = Значе- 
ние», возвращается пустая строка. Свойство толь- 
ко для чтения 


TObject * Возвращает объект, связанный с указанной стро- 
кой свойства Strings. В классе TStrings свойство 
Objects не используется, но может использоваться 


в некоторых классах, производных от TStrings 


| Strings 
[int Index] 


Текст строки с указанным индексом. Индекс пер- 
вой строки — 0 


System:: 
AnsiString 


Представляет весь список как одну строку, внутри 
которой используются разделители типа символов 
возврата каретки и перевода строки 


System:: 
AnsiString 


Применяется для списков, имеющих структуру 
«Имя = Значение». Такую структуру имеют, на- 
пример, файлы .ini. Свойство Values возвращает 
Значение, в строке с указанным именем Мате. 
Если заданное имя Маше не найдено, возвращает- 
ся пустая строка 


System:: 
AnsiString 


Методы 
Ниже приведены основные методы, объявленные в классе TStrings. 


| Метод Описание 


Добавляет строку 8 в конец списка. Возвра- 
щает индекс добавленной строки. В окнах 
редактирования добавляемая строка может 
оказаться разбитой на несколько, так что в 
этих случаях возвращаемый индекс ни о чем 
не говорит 


const System::AnsiString 5) 


‘ 


int AddObject( 
const System::AnsiString S, 
System::TObject* AObject) 


void AddStrings( 
TStrings* Strings) 


Добавляет в список строку S и связанный с 
ней объект AObject. Возвращает индекс до- 
бавленной строки и объекта 


Добавляет в список группу строк Strings 
типа TStrings 

Добавляет строку в конец списка. Метод ана- 
логичен Add, но не возвращает индекс строки 


Удаляет из списка указанную строку с ин- 
дексом Index 


void Append( 
const System::AnsiString 5) 


Сравнивает данный список с заданным спис- 
ком Strings. Возвращает true при идентич- 
ности списков 
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ОНИ о oe cee gn 


void Exchange( Переставляет местами строки списка с ин- 
| int Index1, int Index2) | дексами Index! и Index2 


ichar * GetText (void) Возвращает буфер, под который выделяет 
| память, и заполняет его значением свойства 
Text 


|126 IndexOf( Возвращает индекс указанной строки S. 
| const System::AnsiString 5) | Если такой строки нет в списке, возвращает- 
ся -1 


| 12% IndexOfName(const Применяется для списков, имеющих струк- 

| System::AnsiString Name) | Typy «Имя = Значение». Такую структуру 
имеют, например, файлы .ini. Возвращается 
индекс строки, в которой имя равно заданно- 
му значению Маше. Если такой строки нет в 
списке, возвращается -1 


| 11% IndexOfObject( Возвращает индекс первой строки, связан- 
| System::TObject* AObject) | Hol с заданным объектом AQbject. Если та- 
кой строки нет в списке, возвращается -1 


| void Insert( int Index, Вставляет указанную строку S в заданную 


const System::AnsiString $5) | позицию Index. Если Index = 0, строка 
вставляется в первую позицию 


| void InsertObject(int Index, Вставляет указанную строку S в заданную 
const System::AnsiString 5, | позицию Index и связывает с ней объект 
System::TObject* AObject) | AObject. Если Index = 0, строка вставляется 
на первую позицию 


| void LoadFromFile(const Заполняет список строками текста из yKa- 
System::AnsiString FileName) |занного файла FileName 


void LoadFromStream( Заполняет список строками текста из ука- 
TStream* Stream) |занного потока Stream 


Изменяет позицию строки с индексом Сигт- 
dex, давая ей индекс NewIndex 


Сохраняет строки списка в файле с указан- 
ным именем FileName 


Сохраняет значение свойства Text в указан- 
ном потоке Stream 


TWinControl — базовый класс оконных компонентов 
Абстрактный базовый класс всех оконных компонентов 
Иерархия TObject — TPersistent — TComponent — TControl 
Модуль controls 


Описание 
Класс TWinControl является базовым классом для всех оконных компонентов 
C++Builder, т.е. для компонентов, которые: 
Ш Могут получать фокус во время выполнения приложения. Другие компоненты 
могут отображать данные, но пользователь не может общаться с компонентом 
с помощью клавиатуры, если это не оконный компонент. 
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Ш Могут содержать другие компоненты, т.е. быть компонентами-контейнерами, 
компонентами-родителями других, дочерних компонентов. 


Ш Имеют дескрипторы окна. 


Новые компоненты редко создаются непосредственно на основе TWinControl. 
Обычно они основываются на производных классах, таких, как TCustomControl, 
имеющий канву и обработку сообщений прорисовки, или на более специализиро- 
ванных классах типа TButtonControl, TCustomComboBox, TCustomEdit или TCus- 
tomListBox. 


Свойства 

Ниже приведен список основных свойств, определенных или переопределен- 
ных в TWinControl. Некоторые методы, используемые в основном при разработке 
сложных новых классов, в него не включены. 


= | 


TBrush * Определяет цвет и стиль заполнения фона 
окна. Свойство только для чтения 


ClientOrigin TPoint Экранные координаты левого верхнего угла 
клиентской области компонента. Свойство 
только для чтения 


. 2 | 
ClientRect TRect Содержит размер клиентской области компо- | 
нента. Свойство только для чтения | 

| 

| 

| 

| 


ControlCount Число дочерних компонентов данного OKOH- 
ного элемента. Свойство только для чтения 

Controls _ TControl * Массив дочерних компонентов оконного эле- 

fint Index] мента. Свойство только для чтения 

Ctl3D Определяет, будет ли компонент выглядеть | 
объемным или плоским 

DockClientCount | int Число компонентов, встроенных в данный 
оконный элемент. Свойство только для чте- 
ния 


| 
DockClients TControl * Массив компонентов, встроенных в данный 
|[int Index] оконный элемент. Свойство только для чте- | 
HUA 
| 

| 

| 

| 

| 

| 

| 

| 


| Handle HWND Дескриптор оконного элемента, используе- 
мый при вызове функций API Windows. 
| Свойство только для чтения | 
HelpContext THelpContext | Номер контекстно-зависимой встроенной 
| справки | 


ImeMode и Ime- |TImeMode и |Определяют обработку символов в редакто- 
Маше System:: pax. Обычно значения по умолчанию не из- 
AnsiString меняют 


Раге СИЗО Управляет наследованием родительского 
свойства СИЗО 


ParentWindow |HWND Дескриптор родительского окна, не являюще- | 
гося визуальным компонентом, например TAc- | 
tiveXControl. Если свойство Parent не NULL, | 
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[Свойство Описание | 


| Showing Определяет, виден ли компонент в данный 
| момент. Свойство только для чтения 

| TabOrder TTabOrder 

| 


Указывает позицию компонента в последова- 
тельности табуляции 


Определяет, может ли пользователь перевес- 
ти фокус на компонент клавишей табуляции 


To же, что Handle, но это свойство можно 
читать и изменять 


| WindowHandle |HWND 


Класс TWinControl наследует также много свойств своих предшественников. 


Методы 
Ниже приведены основные методы, наследуемые от TWinControl и используе- 
мые в компонентах — потомках этого класса. 


мед |Ошисание 


| CanFocus Определяет, может ли компонент получать фокус, т.е. 

| получать сообщения пользователя 

| ChangeScale Изменяет масштаб компонента и его дочерних компо- 

| нентов 

| ContainsControl Определяет, является ли указанный компонент прямым 


или косвенным наследником данного оконного элемента 


CofitrolAtPos 


Возвращает дочерний компонент, находящийся в yKa- 
занной позиции 


| DisableAlign 


Временно запрещает выравнивание компонентов в окон- 
ном элементе 


Отменяет действие предварительно вызванного метода 
DisableAlign и вызывает Realign для выравнивания 
компонентов 


EnableAlign 


FindChildControl Возвращает указатель Ha дочерний компонент с задан- 


ным именем или NULL 


FindNextControl Возвращает очередной оконный компонент в последова- 
тельности табуляции 


| Focused Определяет, находится ли оконный элемент в фокусе 


GetTabOrderList Строит список дочерних компонентов в последователь- 


ности табуляции 


HandleAllocated Проверяет наличие дескриптора окна компонента 
| 


_HandleNeeded Создает дескриптор окна, если он до этого не существо- 
вал 


| Invalidate Сообщает о необходимости перерисовки компонентов | 
Bagi ete Выравнивает компоненты в оконном 9JIEMeHTe | 


ealign 
| Repaint Перерисовывает изображение компонента на экране с 
помощью штуаН9дафе 
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‚ордаВВНИВЕИ 
Meron Описание 


| ScaleBy Масштабирует оконный элемент и все содержащиеся в | 
нем компоненты | 


' ScaleControls Изменяет масштаб компонентов в оконном элементе, не 
изменяя масштаба самого оконного элемента 


тельности 


Update Немедленная перерисовка компонента | 


| 

| 

SelectFirst Передает фокус дочернему компоненту, первому в по- | 

следовательности табуляции | 

| 

SelectNext | Передает фокус компоненту, следующему в последовате- | 

льности табуляции | 

SetBounds | 
: SetChildOrder Изменяет позицию компонента в списке дочерних KOM- 

понентов | 

SetFocus | 

SetZOrder Перемещает компонент на верх или в них 7-последова- | 


Помимо перечисленных методов имеется еще немало методов, наследуемых OT 
предков. 


События 


Событие ____  |Описание 
| OnDockDrop Событие при завершении перетаскивания и встраивания | 


| OnDockOver Событие при перемещении перетаскиваемого и встраи- 

| ваемого компонента над контейнером 

| OnEnter Событие при получении элементом фокуса 

OnExit Событие при потери элементом фокуса | 


| 
| 
| 


| 


| OnGetSiteInfo Событие происходит перед OnDoekDrop и позволяет по- 
| лучить информацию о перетаскиваемом объекте 


OnKeyDown Событие при нажатии любой клавиши или кнопки | 
мыши | 


|OnKeyPress 
| | 
| ОпМоизе\УВее! — | Событие при вращении колесика мыши | 
| ОпМоизе\ Вее!Фо\п | Событие при вращении колесика мыши вниз. Происхо- 
| дит, если отсутствует обработчик OnMouse Wheel 


OnMouse WheelUp Событие при вращении колесика мыши вверх. Происхо- | 
| дит, если отсутствует обработчик OnMouse Wheel | 


| x | | 
| OnUnDock Событие при попытке вывести встроенный компонент из | 
| его контейнера | 


| 
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16.5 Предметный указатель разделов книги, 
содержащих описания компонентов 
библиотеки VCL 


Ниже приведены ссылки на те разделы книги, в которых не просто содержит- 
ся упоминание того или иного компонента, но дается какая-то новая информация 
о компоненте или о способах его использования в приложениях. Например, метки 
и кнопки применяются в любом примере данной книги, но в таблице указаны 
только те разделы, в которых об этих компонентах сообщается что-то новое. 
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.DBLookupCombo 


DBLookupComboBox 


DBLookupList 


DBLookupListBox 


DBMemo 
DBNavigator 
DBRadioGroup 
DBRichEdit 
DBText 
DDEClientConv 
DDEClientItem 
DDEServerConv 
DDEServerlItem 
DecisionCube 
DecisionGraph 
DecisionGrid 
DecisionPivot 
DecisionQuery 
DecisionSource 
DirectoryListBox 
DrawGrid 
DriveComboBox 
Edit 


F1Book 
FileListBox 
FilterComboBox 
FindDialog 
FontDialog 
Form 

Frame 


Graph 


GroupBox 
Header 
HeaderControl 
HotKey 
IBDatabase 
IBDatabaselInfo 
IBDataSet 
IBEvents 
IBQuery 
IBSQL 
IBSQLMonitor 
IBStoredProc 
IBTable 
IBTransaction 
IBUpdateSQL 
Image 


ImageList 
Label 


List Box 
List View 
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MainMenu 
MaskEdit 
MediaPlayer 
Memo 


MonthCalendar 
NoteBook 
OLEContainer 
OpenDialog 


OpenPictureDialog 
Outline 
PageControl 
PageScroller 
PaintBox 

Panel 


PopupMenu 
PrintDialog 
Printer 
PrinterSetupDialog 
ProgressBar 
QRDBImage 
QRDBRichText 
QRDBText 
QRImage 
QRLabel 
QRMemo 
QRRichText 
QRShape 
QRSubDetail 
QRSysData 
Query 


QuickRep 
RadioButton 
RadioGroup 
ReplaceDialog 
RichEdit 


SaveDialog 
SavePictureDialog 
Screen 
Scrollbar 
ScrollBox 
Session 
Shape 
SpeedButton 
Splitter 
StaticText 
StatusBar 
StoredProc 
StringGrid 
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ПРОГРАММИРОВАНИЕ В 


C++Builder 5 


Методика построения: 


текстовых редакторов 
графических редакторов 
мультипликации и мультимедиа 
приложений с базами данных 
справочных систем 

шаблонов и компонентов 
интерфейсов к внешним программам 
отчетов 


Справочные данные по: 


языку C++ 

функциям C++ 

функциям АР! Windows 
компонентам C++Builder 5 
классам C++Builder 5 
свойствам компонентов 
методам компонентов 


Диск содержит полноценную пробную 
2 версию C++Builder 5 Trial Edition, 
я справку .hip по С++ и C++Builder 5 на 


русском языке и примеры, рассмотренные 
в книге, 


Файл справочной системы на русском языке, 
содержащий около 2000 входов, описывает 
свыше 500 функций, около 200 свойств, 
методов и событий компонентов, типы данных, 
исключения и многое другое. 


Книга содержит методические и 
справочные материалы по новой 
версии системы визуального 


‚ объектно-ориентированного 


программирования C++Builder 5. 
Рассмотрены такие новые 
возможности C++Builder 5, как 
интернационализация приложе- 
ний, компоненты-серверы СОМ, 
технологии доступа к данным 
ADO и InterBase Express. Дается 
методика построения прикладных 
программ, реализующих тексто- 
вые и графические редакторы, 
мультипликацию и мультимедиа, 
работу ¢ базами данных, построе- 
ние спразочных систем, отчетов, 
интерфейсов к внешним програм- 
мам. Справочная часть книги 
содержит материалы по языку 
C++, функциям C++, C++Builder 

и АР! Windows, компонентам и 
классам C++Builder, их свойствам, 
методам и событиям. 
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